What's New

New Features

• In anticipation of the v2.0 release, adds new CMake packages and imported targets for bson to allow you to support both major versions without modifying your CMake project.

  • To import bson with the new names, call find_package for the bson package. The new imported target names are bson::static, bson::shared, and bson::bson.

New Features

• In anticipation of the v2.0 release, adds new CMake packages and imported targets for bson and mongoc to allow you to support both major versions without modifying your CMake project.

  • To import mongoc with the new names, call find_package for the mongoc package. The new imported target names are mongoc::static, mongoc::shared, and mongoc::mongoc.

  • To import bson with the new names, call find_package for the bson package. The new imported target names are bson::static, bson::shared, and bson::bson.

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

Deprecations

• Deprecates support for Debian 9 and Debian 10

Improvements

• Improves the performance of BSON to JSON serialization for nested documents

Fixes

• Updates the truncated output of the bson_as_json_with_opts() function to no longer split valid UTF-8 sequences

• Updates generated JSON text in the following ways:

  • Serializes all empty arrays and documents with one space

  • Serializes arrays that the driver omits because of the maximum recursion limit to [ ... ] instead of { ... }

  • Applies the maximum recursion limit to legacy CodeWScope documents

• Fixes an output parameter leaked after unsuccessful calls to the bson_append_array_builder_begin() function

Deprecations

• Deprecates support for Debian 9 and Debian 10

New Features

• Adds support for structured logging. To configure this feature, use the mongoc_client_set_structured_log_opts() and mongoc_client_pool_set_structured_log_opts() functions.

• Adds support for cache lifetime configuration of In-Use Encryption data encryption keys. To configure this feature, use the mongoc_auto_encryption_opts_set_key_expiration() and mongoc_client_encryption_opts_set_key_expiration() functions.

  To learn more about In-Use Encryption, see In-Use Encryption in the MongoDB Server manual.

• Adds support for the sort option for update and replace operations.

• Adds support for constructing a mongoc_bulkwrite_t type without a client by using the mongoc_bulkwrite_new() and mongoc_bulkwrite_set_client() functions.

Improvements

• Improves the performance of the mongoc_server_description_new_copy() function

Fixes

• Includes the following APM event fixes required by the SDAM specification:

  • After delivering a server_opening event, the driver must deliver a corresponding server_closed event before delivering topology_closed

  • Before delivering a topology_closed event, the driver delivers a topology_changed event that has a new_description of type Unknown

• Fixes possible crashes when the driver reports the inserted document IDs in the verbose results of client bulk writes

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

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