mongodb

The MongoDB Rust driver team is pleased to announce the v3.8.1 release of the mongodb crate, now available for download from crates.io.

This release fixes two bugs: a potential infinite loop in change streams, and the find_one_and_* methods not reporting errors in some circumstances.

Full Release Notes

Bugfixes

• RUST-2465 Fix an infinite loop in ChangeStream iteration (#1760)
• RUST-2479 Report write concern errors for findAndModify (#1768)

The MongoDB Rust driver team is pleased to announce the v3.8.0 release of the mongodb crate, now available for download from crates.io.

Highlighted Changes

In-Use Encryption String API GA

The string API for in-use encryption (previously named the text API) is now stable and GA! This brings with it the following changes:

• The text-indexes-unstable feature is no longer required to enable this API. The feature still exists for backwards compatibility but does nothing.
• The TextOptions struct is now StringOptions.
• Algorithm::TextPreview is deprecated in favor of Algorithm::String.
• The query types "prefixPreview", "suffixPreview", and "substringPreview" are deprecated in favor of "prefix", "suffix", and "substring" respectively.

The GA API requires mongodb server version 9.0. The preview API can continue to be used with pre-9.0 server versions.

Server 4.2 EOL

As of this release, connecting to server version 4.2 is deprecated. Support for 4.2 will be removed in the 3.9.0 release.

MONGODB-AWS explicit authentication property deprecation

The use of explicit username, password, or the "AWS_SESSION_TOKEN" property with the MONGODB-AWS auth mechanism is deprecated, and will emit warnings when debug assertions are enabled. Support for these will be removed in version 4.0 of the driver.

Hickory performance on Windows

A long-standing bug in the hickory-resolver case when running on Windows caused performance degredation when using a mongodb+srv connection string. Happily, this bug is now fixed, so users who previously used our recommended workaround of a custom DNS configuration on Windows can now remove that workaround.

Full Release Notes

Impactful changes are listed below; for a complete list of changes see this GitHub query.

New Features

• RUST-2402 QE string API GA (#1727)
• RUST-2376 Optionally redact errors containing URI elements (#1708)

Improvements

• RUST-2388 Add AGENTS.md (#1706)
• RUST-2299 Remove warnings about hickory performance (#1712)
• RUST-2358 Update attribute name in OpenTelemetry Spec (#1713)
• RUST-2248 Add deprecation warnings for explicit MONGODB-AWS auth properties (#1716)
• RUST-2369 Add constructor methods for ReadPreference (#1732) (thanks @OnjoujiToki!)

Bugfixes

• RUST-2437 Fix performance regression in Client::shutdown (#1718)

The MongoDB Rust driver team is pleased to announce the v3.7.0 release of the mongodb crate, now available for download from crates.io.

Highlighted Changes

MSRV Increase

This release updates the minimum supported rust compiler version to 1.88.

Hickory Dependency Version Increase

Due to a security advisory, the version of hickory used internally has been updated to 0.26. This should have no user-visible behavior impact.

Client::shutdown improvements

The implementation of shutdown's wait for server resource cleanup and background task termination has been improved to be more consistent and cover more cases.

Full Release Notes

Impactful changes are listed below; for a complete list of changes see this GitHub query.

Improvements

• RUST-2418 bump to use hickory-* 0.26 (#1682) (thanks @aviramha!)
• RUST-2342 bump MSRV to 1.88 (#1693)
• RUST-2014 Refactor Client::shutdown to use tokio utilities (#1692)
• Update zstd version to 0.13.3 (#1684) (thanks @richarddd!)
• RUST-2398 bump max wire version to 29 (#1680)

The MongoDB Rust driver team is pleased to announce the v3.6.0 release of the mongodb crate, now available for download from crates.io.

Highlighted Changes

Client Backpressure

With 3.6.0, the client has a variety of changes to improve behavior when connected to overloaded servers, most notably retrying against a different server (if available). These features will be functional with MongoDB Atlas Server Version 9.0 and above.

Full Release Notes

Impactful changes are listed below; for a complete list of changes see this GitHub query.

Improvements

• RUST-2268 Add jitter to convenient transaction retries (#1588)
• RUST-2267 Avoid clearing connection pool when server connection rate limiter triggers (#1584)
• RUST-2324 Implement Cursor on top of RawBatchCursor (#1620)
• RUST-2273 Exponential backoff and jitter in retry loops (#1626)
• RUST-2325 Use raw batch iterator for gridfs downloads (#1632)
• RUST-2385 Finalize client backpressure changes (#1654)
• minor: bump MSRV to 1.85 (#1670)
• Add feature flag to use aws-lc-rs instead of ring as the rustls crypto provider (#1662) (thanks @TimTheBig!)

Bugfixes

• RUST-2344 Encode values in GCP/Azure OIDC URLs (#1593)
• RUST-2346 Remove check for '|' in metadata (#1599)
• RUST-2363 ensure empty tag matches servers with no tag set (#1616)
• RUST-2335 Fix and test logic for error comparison on retry (#1637)
• RUST-2390 Fix Cursor::has_next (#1652)
• RUST-2394 Fix a race condition deadlock in Client::shutdown (#1658)
• RUST-2400 Fix and test retry behavior for a mix of overload and non-overload errors (#1669)

The MongoDB Rust driver team is pleased to announce the v3.5.2 release of the mongodb crate, now available for download from crates.io.

Full Release Notes

Bugfixes

• RUST-2363 Ensure empty tag matches servers with no tag set (#1617)

The MongoDB Rust driver team is pleased to announce the v3.5.1 release of the mongodb crate, now available for download from crates.io.

This release removes a check added in 3.4.0 that would reject metadata containing the | character.

Full Release Notes

Bugfixes

• RUST-2346 Remove check for '|' in metadata (#1599)

The MongoDB Rust driver team is pleased to announce the v3.5.0 release of the mongodb crate, now available for download from crates.io.

Highlighted Changes

SOCKS5 Proxy Support

3.5.0 includes the optional socks5-proxy feature, which enables connecting to the database via a SOCKS5 proxy. This can be configured either with the proxyHost, proxyPort, proxyUsername, and proxyPassword connection string options or the ClientOptions::socks5_proxy field.

Raw Batch Cursors

This release adds support for iterating over the raw document batches returned by the server for cursors rather than individual deserialized values. For some applications, this can enable significant performance improvements; see the module documentation for more details.

AWS Authentication Property Deprecation

Specifying AWS authentication properties via the username and password in URI strings and the AWS_SESSION_TOKEN field of the auth mechanism properties doc is deprecated; using these is almost never the correct setup and can lead to the driver losing connectivity. This functionality will be removed in the next major version of the driver.

Full Release Notes

Impactful changes are listed below; for a complete list of changes see this GitHub query.

New Features

• RUST-1054 SOCKS5 Proxy Support (#1550)
• RUST-2300 Provide a raw batched cursor mode for all cursor-returning actions

Improvements

• RUST-2303 extend ALLOWED_HOSTS (#1544)
• RUST-2308 Derive Clone for ConnectionString (#1546) (thanks @jeroenvervaeke!)
• RUST-2309 Include message in display for custom errors containing strings
• RUST-2279 Add snapshot_time option for snapshot sessions (#1555)
• RUST-2321 Deprecate the socketTimeoutMS option (#1582)
• RUST-2310 Deprioritize servers in server selection for all topologies (#1576)

Bugfixes

• RUST-2304 Add workarounds for bulk write server bugs (#1551)

The MongoDB Rust driver team is pleased to announce the v3.4.1 release of the mongodb crate, now available for download from crates.io.

Highlighted Changes

Atlas Search Helpers

The driver now includes helpers for building Atlas Search aggregation pipelines. See the documentation for more details and examples.

OpenTelemetry Support

The driver now supports tracing database commands and driver operations for OpenTelemetry.

Text Indexes for Queryable Encryption

The driver now supports text indexes for both automatic and explicit encryption. Note that this feature is in preview and should only be used in experimental workloads. The text-indexes-unstable feature flag must be enabled to use text indexes. The GA version of this feature may not be backwards-compatible with the preview version.

Dependency Improvements

Thank you to @tottoto and @FalkWoldmann for their several contributions to update and refine our dependencies!

Full Release Notes

Impactful changes are listed below; for a complete list of changes, see this GitHub query.

New Features

• RUST-2138 Add optional support for OpenTelemetry (#1495)
• RUST-1308 Implement Display and Serialize for ConnectionString (#1494)
• RUST-2237 Support for text indexes in explicit encryption (#1479)
• RUST-1405 Expose full server response in Error (#1474)
• RUST-2113 Add has_next to cursor API (#1485)
• RUST-2203 Allow client metadata to be appended post-construction (#1471)
• RUST-2157 Complete set of Atlas Search helpers (#1462)
• RUST-2137 Support $lookup in CSFLE and QE (#1521)

Improvements

• RUST-2293 Un-deprecate and_run (#1497)
• RUST-2127 Lint for sign loss when casting (#1481)

Bug Fixes

• TUNE-449 Fix a potential duration overflow (#1530)

The MongoDB Rust driver team is pleased to announce the v3.3.0 release of the mongodb crate, now available for download from crates.io.

Highlighted Changes

Compatibility With bson 3.0

This version of the driver provides the bson-3 feature, which allows opting in to use the 3.0 version of the bson crate where the driver API exposes those types. Any usage without that feature (e.g. all existing projects) will continue to use the 2.x version. See the bson 3.0 migration guide for more information.

Improved Convenient Transaction API

With the stabilization of async closures, the convenient transaction API (StartTransaction::and_run) has been deprecated in favor of StartTransaction::and_run2, which provides the same functionality but without needing to box the closure or pass a distinct data argument.

GSSAPI Authentication Support

The driver now supports the use of GSSAPI for authentication of driver connections on Linux, MacOS, and Windows.

Minimum Server Version Increase

The minimum server version supported by the driver is now 4.2; support for 4.0 was deprecated in driver version 3.2.0 and has now been removed.

Full Release Notes

Impactful changes are listed below; for a complete list of changes see this GitHub query.

New Features

• RUST-1891 Implement Default on results structs (#1289)
• RUST-2140 Support the nsType field for change streams (#1316)
• RUST-2087 Add hint option to distinct (#1341)
• RUST-2090 gridfs helpers (#1351)
• RUST-2198 Add run_raw_command method (#1356) (thanks @beckerinj!)
• RUST-2166 Update convenient transactions API to use async closures (#1372)
• RUST-2217 Optionally support bson crate 3.0 (#1380)
• RUST-2235 Implement GSSAPI auth support for Linux and macOS (#1413)
• RUST-2245 Implement GSSAPI auth support for Windows (#1444)
• RUST-2078 Support QE with bulk write (#1445)

Improvements

• RUST-1765 Make slash between hosts and options in the URI optional (#1314)
• RUST-1954 Disallow commas in authMechanismProperties values (#1315)
• RUST-2171 Update rustls to 0.23 (#1322) (thanks @ctz!)
• RUST-2020 Ignore speculative authentication on reauthentication (#1320)
• RUST-2167 Deprecate hedged reads (#1330)
• RUST-2071 Increase batchSize for find when batchSize == limit (#1348)
• RUST-2095 Add an error message when marking primaries stale (#1346)
• RUST-663 Support $merge and $out executing on secondaries (#1360)
• RUST-1826 Use serde attribute to remove empty write concerns (#1392)
• RUST-2104 Implement From<std::net::SocketAddr> for ServerAddress (#1396)
• Update rustls to non-yanked version (#1439)
• RUST-1529 Use AWS SDK to get credentials (#1435)
• RUST-1529 Use AWS SDK for sigv4 signing (#1438)
• minor: include bson feature version in metadata (#1456)
• RUST-2190 Remove support for server 4.0 (#1461)

Bugfixes

• HELP-70689 Use openssl cert parsing when openssl-tls is enabled (#1302)
• HELP-68823 Fix invalid_me comparison and normalize host strings (#1319)
• RUST-2191 Fix type propagation for Aggregate::session (#1353)
• RUST-2131 Fix bulk write cursor iteration on load balanced topologies (#1358)
• RUST-2204 Enforce size limits on outgoing messages (#1369)
• RUST-2074 Fix retryability bug, add disabled test (#1427)
• RUST-2184 Accept any BSON number for CreateCollectionOptions::size (#1460)
• Always use "admin" target_db during handshake (#1463) (thanks @krinart!)