Releases: mongodb/mongo-csharp-driver
v2.9.1
.NET Driver Version 2.9.1 Release Notes
This is a patch release that fixes one bug reported since 2.9.0 was released.
An online version of these release notes is available at:
The list of JIRA tickets resolved in this release is available at:
Documentation on the .NET driver can be found at:
http://mongodb.github.io/mongo-csharp-driver/
Upgrading
There are no known backwards breaking changes in this release.
A bug in 2.9.0 prevents applications from connecting to replica sets via SRV. Applications connecting to replica sets over SRV should NOT upgrade to 2.9.0 and instead should upgrade directly to 2.9.1 or later.
v2.9.0
.NET Driver Version 2.9.0 Release Notes
The main new features in 2.9.0 are:
- Distributed transactions on sharded clusters
- The sessions API supports the
IClientSession.WithTransaction()method to conveniently run a transaction with automatic retries and at-most-once semantics. - Support for message compression
- SRV polling for
mongodb+srvconnection 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. - 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.
- Retryable writes are now enabled by default.
- Update specification using an aggregation framework pipeline
- SCRAM-SHA authentication caching
- Connections to the replica set primary are no longer closed after a step-down, allowing in progress read operations to complete.
- New aggregate helper methods support running database-level aggregations.
- Aggregate helper methods now support the
$mergepipeline stage, and builder methods support creation of the new pipeline stage. - Change stream helpers now support the
startAfteroption. - Index creation helpers now support wildcard indexes.
An online version of these release notes is available at:
The list of JIRA tickets resolved in this release is available at:
Documentation on the .NET driver can be found at:
http://mongodb.github.io/mongo-csharp-driver/
Upgrading
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.
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.
v2.9.0-beta2
.NET Driver Version 2.9.0-beta2 Release Notes
This is a beta release for the 2.9.0 version of the driver that will be released with MongoDB server version 4.2.
The main features in 2.9.0-beta2 are:
- Sharded transactions using the same API as replica set transactions
- Convenient API for transactions
- Support for message compression
- SRV polling for mongodb+srv connection scheme
- Retryable reads on by default
- Retryable writes on by default
- Update specification using an aggregation framework pipeline
An online version of these release notes is available at:
The full list of JIRA issues that are currently scheduled to be resolved in this release is available at:
The list may change as we approach the release date.
Documentation on the .NET driver can be found at:
http://mongodb.github.io/mongo-csharp-driver/
Upgrading
There are no known backwards breaking changes in this release.
v2.8.1
.NET Driver Version 2.8.1 Release Notes
This is a patch release that fixes a few bugs reported since 2.8.0 was released.
An online version of these release notes is available at:
The full list of JIRA issues resolved in this release is available at:
Documentation on the .NET driver can be found at:
http://mongodb.github.io/mongo-csharp-driver/
Upgrading
There are no known backwards breaking changes in this release.
v2.9.0-beta1
.NET Driver Version 2.9.0-beta1 Release Notes
This is a beta release for the 2.9.0 version of the driver that will be released with MongoDB server version 4.2.
The main feature in 2.9.0-beta1 is pinning to a single mongos router when in a sharded transaction.
An online version of these release notes is available at:
The full list of JIRA issues that are currently scheduled to be resolved in this release is available at:
The list may change as we approach the release date.
Documentation on the .NET driver can be found at:
http://mongodb.github.io/mongo-csharp-driver/
Upgrading
There are no known backwards breaking changes in this release.
v2.8.0
.NET Driver Version 2.8.0 Release Notes
This is a minor release.
An online version of these release notes is available at:
The list of JIRA tickets resolved in this release is available at:
Documentation on the .NET driver can be found at:
http://mongodb.github.io/mongo-csharp-driver/
Upgrading
-
The minimum .NET Framework version we support has been changed from 4.5 to 4.5.2.
-
If you were having compatibility problems when adding a dependency (either directly or indirectly) on either
System.Runtime.InteropServices.RuntimeInformation or DnsClient this is a recommended upgrade. We now depend
on the latest version of those packages.
v2.7.3
.NET Driver Version 2.7.3 Release Notes
This is a patch release that fixes two bugs reported since 2.7.2 was released.
An online version of these release notes is available at:
The full list of JIRA issues resolved in this release is available at:
Documentation on the .NET driver can be found at:
http://mongodb.github.io/mongo-csharp-driver/
Upgrading
There are no known backwards breaking changes in this release.
v2.7.2
.NET Driver Version 2.7.2 Release Notes
This is a patch release that fixes one bug reported since 2.7.1 was released.
An online version of these release notes is available at:
The full list of JIRA issues resolved in this release is available at:
Documentation on the .NET driver can be found at:
http://mongodb.github.io/mongo-csharp-driver/
Upgrading
There are no known backwards breaking changes in this release.
If your application is running on Linux or OS X and you were planning to upgrade
to the 2.7.1 release of the driver, you must upgrade to 2.7.2 or later rather than 2.7.1.
In the 2.7.1 release, the driver enables TCP KeepAlive and configures the
KeepAlive interval, but the method that it uses throws a PlatformNotSupportedException
on Linux and OS X. In the 2.7.2 release the driver catches that exception rather than
failing to connect, and falls back to simply enabling KeepAlive. If that also throws a
PlatformNotSupportedException, it will connect without enabling KeepAlive.
v2.7.1
.NET Driver Version 2.7.1 Release Notes
This is a patch release that fixes a few bugs reported since 2.7.0 was released.
An online version of these release notes is available at:
The full list of JIRA issues resolved in this release is available at:
Documentation on the .NET driver can be found at:
http://mongodb.github.io/mongo-csharp-driver/
Upgrading
There are no known backwards breaking changes in this release.
v2.7.0
.NET Driver Version 2.7.0 Release Notes
The main new features of 2.7.0 are support for new features of the 4.0.0 version of the server including:
- Transactions
- New CountDocuments and EstimatedDocumentCount methods (depending on whether you need an exact result or a fast estimate)
- Support for change streams on all collections in a cluster or a particular database via the new Watch methods on IMongoClient and IMongoDatabase
- SCRAM-SHA-256 authentication
An online version of these release notes is available at:
The list of JIRA tickets resolved in this release is available at:
Documentation on the .NET driver can be found at:
http://mongodb.github.io/mongo-csharp-driver/
Upgrading
-
The .NET Driver now disables certificate revocation checking by default, setting
CheckCertificateRevocationinSslSettingstofalseby default. Any applications relying on the older default oftruenow must explicitly setCheckCertificateRevocationtotrueinSslSettingsto re-enable certificate revocation checking.Previously, the driver enabled certificate revocation checking by default, in contrast to the
mongoshell and other MongoDB drivers. This was also in contrast to .NET's defaults forSslStream(see .NET Framework documentation here and .NET Standard documentation here).
Known Issues:
- Incomplete SCRAM-SHA-256 Support in .NET Standard: In .NET Standard, authenticating via SCRAM-SHA-256 may not work with non-ASCII passwords because SaslPrep is not fully implemented due to the lack of a string normalization function in .NET Standard 1.5. Normalizing the password into Unicode Normalization Form KC beforehand MAY help. SCRAM-SHA-1 is the recommended alternative (when targeting .NET Standard) for now.