Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
67 changes: 66 additions & 1 deletion modules/project-docs/pages/sdk-release-notes.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,71 @@ For release notes, download links, and installation methods for 2.7 and earlier

The full installation instructions that were previously on this page can now be found xref:sdk-full-installation.adoc[here].

== Version 3.3.0 (27 April 2022)

Version 3.3.0 is the first release of the 3.3 series.

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


=== Fixed Issues

* https://issues.couchbase.com/browse/NCBC-2847[NCBC-2847],
https://issues.couchbase.com/browse/NCBC-3123[NCBC-3123],
https://issues.couchbase.com/browse/NCBC-3115[NCBC-3115],
https://issues.couchbase.com/browse/NCBC-3124[NCBC-3124],
https://issues.couchbase.com/browse/NCBC-3151[NCBC-3151],
https://issues.couchbase.com/browse/NCBC-3179[NCBC-3179],
https://issues.couchbase.com/browse/NCBC-3000[NCBC-3000]:
Made it simpler to diagnose failures by ensuring that various exceptions including `AuthenticationFailureException`, `BucketNotFoundException`, `EventingFunctionNotFoundException`, FTS exceptions, `ScopeNotFoundException`, `BucketExistsException`, `AuthenticationFailedException` are correctly thrown.


* https://issues.couchbase.com/browse/NCBC-3164[NCBC-3164],
https://issues.couchbase.com/browse/NCBC-3177[NCBC-3177]:
Fix bugs where NullReferenceException were thrown in
SendAsync (because the OperationBuilder has not been set for a NOOP)
and rebalancing (when the cluster map was missing an alternate address).

* https://issues.couchbase.com/browse/NCBC-3190[NCBC-3190]:
Fixed bug where CreateDataverseAsync failed when passed an empty TimeSpan.

=== New Features and Behavioral Changes

* https://issues.couchbase.com/browse/NCBC-3173[NCBC-3173],
https://issues.couchbase.com/browse/NCBC-3182[NCBC-3182]:
Bundle Capella CA cert with SDK, and use it by default.
(Note: fix is .NET 5+ only)

* https://issues.couchbase.com/browse/NCBC-2870[NCBC-2870]:
Added OpenTelemetry 1.2.0 AggregatingMeter Otel integration.

* https://issues.couchbase.com/browse/NCBC-3082[NCBC-3082]:
Support parameterized N1QL queries using string interpolation in .NET 6

* https://issues.couchbase.com/browse/NCBC-3180[NCBC-3180]:
Fixed `GetAllIndexes` response on default collection.

* https://issues.couchbase.com/browse/NCBC-3043[NCBC-3043]:
Made `ChannelConnectionPool` the default.
This was added in 3.1.2, and is now the default, replacing `DataFlowConnectionPool`.
(To revert to the previous connection pool set `ClusterOptions.Experiments.ChannelConnectionPools` to false.)

* https://issues.couchbase.com/browse/NCBC-3079[NCBC-3079]:
Improved logging performance in hot paths.

* https://issues.couchbase.com/browse/NCBC-3126[NCBC-3126]:
Reduce heap allocations deserializing vBucket maps.

* https://issues.couchbase.com/browse/NCBC-3132[NCBC-3132],
https://issues.couchbase.com/browse/NCBC-3134[NCBC-3134],
https://issues.couchbase.com/browse/NCBC-3137[NCBC-3137]:
Switched to `System.Text.Json `for exception error contexts, `OperationSpec.ToString`, `ClusterVersionProvider`

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


== Version 3.2.9 (4 April 2022)

Expand All @@ -27,7 +92,7 @@ https://www.nuget.org/packages/CouchbaseNetClient/3.2.9[Nuget]
=== Special Note

* 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.
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.
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.
If you encounter a similar situation during migration and need help with mitigation, please contact our support team.

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