What's New

Deprecations

• Deprecates the bson_string_t and associated functions

• Deprecates compiling with BSON_MEMCHECK

• Deprecates bson_in_range_*() and bson_cmp_*() functions

• Deprecates bson_atomic_*() and bson_thrd-yield() functions

• Deprecates bson_as_json() and bson_array_as_json() functions

Deprecations

• Deprecates mongoc_client_command. Use mongoc_client_command_simple instead.

• Deprecates mongoc_database_command. Use mongoc_database_command_simple instead.

• Deprecates mongoc_collection_command. Use mongoc_collection_command_simple instead.

Changes

• Drops support for Visual Studio 2013

• Raises required version of the libmongocrypt dependency to 1.12.0 to support the In-Use Encryption feature

For more information about this release, see the v1.29 release notes.

New Features

• Adds bson_validate_with_error_and_offset() function

Changes

• Removes automatic ccache detection and usage

• Removes Mongo_USE_CCACHE

New Features

• Adds support for In-Use Encryption range queries

• mongoc_collection_insert_one includes the insert ID

• Adds new bulk write API mongoc_bulkwrite_t

• Adds serverMonitoringMode URI option

Changes

• Raises minimum wire protocol version from 6 to 7

• Raises required libmongocrypt version to v1.11.0 to support In-Use Encryption

Deprecations

• Deprecates *_hint option. Instead, use the *_server_id option.

  • Deprecates mongoc_bulk_operation_set_hint. Instead, use mongoc_bulk_operation_set_server_id.

  • Deprecates mongoc_bulk_operation_get_hint. Instead, use mongoc_bulk_operation_get_server_id.

  • Deprecates mongoc_cursor_set_hint. Instead, use mongoc_cursor_set_server_id.

  • Deprecates mongoc_cursor_get_hint. Instead, use mongoc_cursor_get_server_id .

• Deprecates ENABLE_SSL=LIBRESSL and mongoc_stream_tls_libressl_new.

• Deprecates ENABLE_SASL=CYRUS and the CYRUS_PLUGIN_PATH_PREFIX option on Windows platforms.

For more information about this release, see the v1.28 release notes.

Fixes

• Fixes handling of malformed extended JSON for special BSON types

Fixes

• Fixes TSan warning

• Fixes C23 compile

Improvements

• Documents expected behavior of command errors in a transaction

Fixes

• Fixes large string handling in bson_append_utf8

Fixes

• Fixes possible build error in environments where bool or _Bool is a macro

Fixes

• Fixes build issues with Visual Studio 2013

Fixes

• Fixes possible crash reading malformed wired protocol message

• Fixes build issues with Visual Studio 2013

Changes

• Introduces changes surrounding the development processes, including new code signing and dependency tracking. There are no behavioral or API changes.

Fixes

• Upgrades bundled Zlib from 1.2.3 to 1.3.1

Fixes

• Fixes parsing of colon in timezone

• Fixes error on failure to initialize a subdocument in bson_iter_visit_all

Fixes

• Closes leftover connections to remote servers

New Features

• Checks environment variable MONGO_EXPERIMENTAL_SRV_PREFER_TCP to prefer TCP over SRV lookup

Fixes

• Fixes large string handling in bson_string_new and bson_string_append

Changes

• Raises the required version of libmongocrypt to 1.10.0 to support In-Use Encryption. This corresponds to CMake option ENABLE_CLIENT_SIDE_ENCRYPTION.

Fixes

• Fixes possible crash when client is configured with an empty password

New Features

• Adds database name to command events mongoc_apm_command_failed_get_database_name and mongoc_apm_command_succeeded_get_database_name

• Supports delegated KMIP protocol for In-Use Encryption

• Enables setting socket timeout per client

Fixes

• Fixes iteration on bson_strfreev

Changes

• By default, disables plugin loading with Cyrus SASL on Windows. To re-enable, set the CMake option CYRUS_PLUGIN_PATH_PREFIX to the absolute path prefix of the Cyrus SASL plugins.

Fixes

• Fixes possible hang if mongoc_gridfs_file_readv is called with a corrupt chunk with incomplete data

• Fixes assert with legacy exhaust cursor protocol when connected to MongoDB server versions earlier than 4.2

Fixes

• Uses aligned allocation for bson_array_builder_t

Fixes

• Fixes 32-bit compile with 64-bit time_t

New Features

• Supports named KMS providers

• Redirects retries in sharded clusters to another mongos if possible

Improvements

• Adds VERSION_CURRENT file in source to ease building

• Considers more errors retryable