Skip to content

Commit aac54b4

Browse files
osfameronosfameron
committed
Gardening dotnet-3.3.0-rn
1 parent c48ddac commit aac54b4

1 file changed

Lines changed: 41 additions & 43 deletions

File tree

‎modules/project-docs/pages/sdk-release-notes.adoc‎

Lines changed: 41 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -17,71 +17,69 @@ The full installation instructions that were previously on this page can now be
1717

1818
== Version 3.3.0 (27 April 2022)
1919

20-
Version 3.3.0 is the first release of the 3.2 series.
20+
Version 3.3.0 is the first release of the 3.3 series.
2121

2222
https://packages.couchbase.com/clients/net/3.3/Couchbase-Net-Client-3.3.0.zip[Download] |
2323
https://docs.couchbase.com/sdk-api/couchbase-net-client-3.3.0[API Reference] |
2424
https://www.nuget.org/packages/CouchbaseNetClient/3.3.0[Nuget]
2525

26-
=== Special Note
27-
28-
* During a rebalance upgrade from 6.x (or any earlier version) to 7x, in mixed mode (where you are communicating with Couchbase Server whilst some but not all nodes are upgraded), there is a known issue where data may be written to the wrong location.
29-
The solution is to either upgrade to 3.2.9 or greater, or to quiesce application processing so there are no writes until you have upgraded all nodes.
30-
If you encounter a similar situation during migration and need help with mitigation, please contact our support team.
3126

3227
=== Fixed Issues
3328

34-
* https://issues.couchbase.com/browse/NCBC-2543[NCBC-2543]: QueryIndexManager fails to create indexes in Linq2Couchbase integration tests
35-
36-
* https://issues.couchbase.com/browse/NCBC-2847[NCBC-2847]: AuthenticationFailureException is suppressed if invalid credentials are supplied
37-
38-
* https://issues.couchbase.com/browse/NCBC-3054[NCBC-3054]: DependencyInjection tests fail due to Moq with .NET 5.0 and 6.0
39-
40-
* https://issues.couchbase.com/browse/NCBC-3115[NCBC-3115]: EventingFunctionManager GetFunctionAsync throws generic HttpRequestException on error
41-
42-
* https://issues.couchbase.com/browse/NCBC-3123[NCBC-3123]: BucketNotFoundException thrown when Cluster.BucketAsync fails
29+
* https://issues.couchbase.com/browse/NCBC-2847[NCBC-2847],
30+
https://issues.couchbase.com/browse/NCBC-3123[NCBC-3123],
31+
https://issues.couchbase.com/browse/NCBC-3115[NCBC-3115],
32+
https://issues.couchbase.com/browse/NCBC-3124[NCBC-3124],
33+
https://issues.couchbase.com/browse/NCBC-3151[NCBC-3151],
34+
https://issues.couchbase.com/browse/NCBC-3179[NCBC-3179],
35+
https://issues.couchbase.com/browse/NCBC-3000[NCBC-3000]:
36+
Made it simpler to diagnose failures by ensuring that various exceptions including `AuthenticationFailureException`, `BucketNotFoundException`, `EventingFunctionNotFoundException`, FTS exceptions, `ScopeNotFoundException`, `BucketExistsException`, `AuthenticationFailedException` are correctly thrown.
4337

44-
* https://issues.couchbase.com/browse/NCBC-3124[NCBC-3124]: FTS throws generic CouchbaseException skipping error handling
4538

46-
* https://issues.couchbase.com/browse/NCBC-3151[NCBC-3151]: ScopeNotFoundException on DropCollection does not have proper message
39+
* https://issues.couchbase.com/browse/NCBC-3164[NCBC-3164],
40+
https://issues.couchbase.com/browse/NCBC-3177[NCBC-3177]:
41+
Fix bugs where NullReferenceException were thrown in
42+
SendAsync (because the OperationBuilder has not been set for a NOOP)
43+
and rebalancing (when the cluster map was missing an alternate address).
4744

48-
* https://issues.couchbase.com/browse/NCBC-3164[NCBC-3164]: NRE on OperationBuilderPool.Get() for NOOP
49-
50-
* https://issues.couchbase.com/browse/NCBC-3177[NCBC-3177]: NRE when rebalancing and cluster map is missing an alternate address
51-
52-
* https://issues.couchbase.com/browse/NCBC-3179[NCBC-3179]: Move the specific BucketExistsException before the generic CouchBaseException
53-
54-
* https://issues.couchbase.com/browse/NCBC-3190[NCBC-3190]: CreateDataverseAsync fails with System.ArgumentOutOfRangeException
45+
* https://issues.couchbase.com/browse/NCBC-3190[NCBC-3190]:
46+
Fixed bug where CreateDataverseAsync failed when passed an empty TimeSpan.
5547

5648
=== New Features and Behavioral Changes
5749

58-
* https://issues.couchbase.com/browse/NCBC-2870[NCBC-2870]: AggregatingMeter Otel integration
59-
60-
* https://issues.couchbase.com/browse/NCBC-3082[NCBC-3082]: Support parameterized N1QL queries using string interpolation in .NET 6
61-
62-
* https://issues.couchbase.com/browse/NCBC-2955[NCBC-2955]: CreateIndexAsync doesn't escape bucket names with dashes
63-
64-
* https://issues.couchbase.com/browse/NCBC-3173[NCBC-3173]: Capella CA Certificate Bundled with SDK (Note: fix is .NET 5+ only)
65-
66-
* https://issues.couchbase.com/browse/NCBC-3180[NCBC-3180]: Incorrect GetAllIndexes response on default collection
50+
* https://issues.couchbase.com/browse/NCBC-3173[NCBC-3173],
51+
https://issues.couchbase.com/browse/NCBC-3182[NCBC-3182]:
52+
Bundle Capella CA cert with SDK, and use it by default.
53+
(Note: fix is .NET 5+ only)
6754

68-
* https://issues.couchbase.com/browse/NCBC-3000[NCBC-3000]: Invalid password should raise AuthenticationFailedException instead it raises ServiceNotAvailableException
55+
* https://issues.couchbase.com/browse/NCBC-2870[NCBC-2870]:
56+
Added OpenTelemetry 1.2.0 AggregatingMeter Otel integration.
6957

70-
* https://issues.couchbase.com/browse/NCBC-3043[NCBC-3043]: Make ChannelConnectionPool the default
58+
* https://issues.couchbase.com/browse/NCBC-3082[NCBC-3082]:
59+
Support parameterized N1QL queries using string interpolation in .NET 6
7160

72-
* https://issues.couchbase.com/browse/NCBC-3079[NCBC-3079]: Improve logging performance in hot paths
61+
* https://issues.couchbase.com/browse/NCBC-3180[NCBC-3180]:
62+
Fixed `GetAllIndexes` response on default collection.
7363

74-
* https://issues.couchbase.com/browse/NCBC-3126[NCBC-3126]: Reduce heap allocations deserializing vBucket maps
64+
* https://issues.couchbase.com/browse/NCBC-3043[NCBC-3043]:
65+
Made `ChannelConnectionPool` the default.
66+
This was added in 3.1.2, and is now the default, replacing `DataFlowConnectionPool`.
67+
(To revert to the previous connection pool set `ClusterOptions.Experiments.ChannelConnectionPools` to false.)
7568

76-
* https://issues.couchbase.com/browse/NCBC-3132[NCBC-3132]: Investigate usage of Newtonsoft.Json in KeyValueErrorContext
69+
* https://issues.couchbase.com/browse/NCBC-3079[NCBC-3079]:
70+
Improved logging performance in hot paths.
7771

78-
* https://issues.couchbase.com/browse/NCBC-3134[NCBC-3134]: Use System.Text.Json in OperationSpec.ToString
72+
* https://issues.couchbase.com/browse/NCBC-3126[NCBC-3126]:
73+
Reduce heap allocations deserializing vBucket maps.
7974

80-
* https://issues.couchbase.com/browse/NCBC-3137[NCBC-3137]: Use System.Text.Json in ClusterVersionProvider
75+
* https://issues.couchbase.com/browse/NCBC-3132[NCBC-3132],
76+
https://issues.couchbase.com/browse/NCBC-3134[NCBC-3134],
77+
https://issues.couchbase.com/browse/NCBC-3137[NCBC-3137]:
78+
Switched to `System.Text.Json `for exception error contexts, `OperationSpec.ToString`, `ClusterVersionProvider`
8179

82-
* https://issues.couchbase.com/browse/NCBC-3138[NCBC-3138]: Support both Newtonsoft and System.Text.Json for DiagnosticReport
80+
* https://issues.couchbase.com/browse/NCBC-3138[NCBC-3138]:
81+
Support both Newtonsoft and System.Text.Json` for DiagnosticReport
8382

84-
* https://issues.couchbase.com/browse/NCBC-3182[NCBC-3182]: ClusterOptions.WithCertificateFactory() does not apply to Server Certificate Validation
8583

8684
== Version 3.2.9 (4 April 2022)
8785

@@ -94,7 +92,7 @@ https://www.nuget.org/packages/CouchbaseNetClient/3.2.9[Nuget]
9492
=== Special Note
9593

9694
* During a rebalance upgrade from 6.x (or any earlier version) to 7x, in mixed mode (where you are communicating with Couchbase Server whilst some but not all nodes are upgraded), there is a known issue where data may be written to the wrong location.
97-
The solution is to either upgrade to 3.2.9, or to quiesce application processing so there are no writes until you have upgraded all nodes.
95+
The solution is to either upgrade to 3.2.9, or to pause application processing so there are no writes until you have upgraded all nodes.
9896
If you encounter a similar situation during migration and need help with mitigation, please contact our support team.
9997

10098
* Between bug fixes and performance improvements, the `ChannelConnectionPool` will be made the default in a future release.

0 commit comments

Comments
 (0)