Skip to content

Commit 32b058a

Browse files
committed
CSHARP-2688: Create 2.9.0 release notes
1 parent 47ecdb5 commit 32b058a

File tree

1 file changed

+34
-1
lines changed

1 file changed

+34
-1
lines changed

Release Notes/Release Notes v2.9.0.md

Lines changed: 34 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,36 @@
11
# .NET Driver Version 2.9.0 Release Notes
22

3-
This file is a placeholder.
3+
The main new features in 2.9.0 are:
4+
5+
* Distributed transactions on sharded clusters
6+
* The sessions API supports the `IClientSession.WithTransaction()` method to conveniently run a transaction with automatic retries and at-most-once semantics.
7+
* Support for message compression
8+
* SRV polling for `mongodb+srv` connection scheme: DNS SRV records are periodically polled in order to update the mongos proxy list without having to change client configuration or even restart the client application. This feature is particularly useful when used with a sharded cluster on MongoDB Atlas, which dynamically updates SRV records whenever you resize your Atlas sharded cluster.
9+
* Retryable reads: The diver can automatically retry any read operation that has not yet received any results (due to a transient network error, a "not master" error after a replica set failover, etc.). This feature is enabled by default.
10+
* Retryable writes are now enabled by default.
11+
* Update specification using an aggregation framework pipeline
12+
* SCRAM-SHA authentication caching
13+
* Connections to the replica set primary are no longer closed after a step-down, allowing in progress read operations to complete.
14+
* New aggregate helper methods support running database-level aggregations.
15+
* Aggregate helper methods now support the `$merge` pipeline stage, and builder methods support creation of the new pipeline stage.
16+
* Change stream helpers now support the `startAfter` option.
17+
* Index creation helpers now support wildcard indexes.
18+
19+
An online version of these release notes is available at:
20+
21+
https://github.com/mongodb/mongo-csharp-driver/blob/master/Release%20Notes/Release%20Notes%20v2.9.0.md
22+
23+
The full list of JIRA issues that are currently scheduled to be resolved in this release is available at:
24+
25+
https://jira.mongodb.org/issues/?jql=project%20%3D%20CSHARP%20AND%20fixVersion%20%3D%202.9.0%20ORDER%20BY%20key%20ASC
26+
27+
28+
Documentation on the .NET driver can be found at:
29+
30+
http://mongodb.github.io/mongo-csharp-driver/
31+
32+
## Upgrading
33+
34+
Applications with custom retry logic should note that retryable reads and writes default to `true`. Any applications that rely on the driver's old behavior of not automatically retrying reads and writes should update their connection strings to turn off retryable reads/writes as needed. Otherwise, the new default may cause unexpected behavior.
35+
36+
For example, if an application has custom logic that retries reads `n` times, then after upgrading to 2.9.0, the application could end up retrying reads up to `2n` times because the driver defaults to retrying reads.

0 commit comments

Comments
 (0)