Docs Menu
Docs Home
/ / /
Go Driver

What's New

On this page

  • What's New in 1.15
  • What's New in 1.14
  • What's New in 1.13
  • What's New in 1.12.1
  • What's New in 1.12
  • What's New in 1.11
  • What's New in 1.10
  • What's New in 1.9
  • What's New in 1.8
  • What's New in 1.7
  • What's New in 1.6
  • What's New in 1.5
  • What's New in 1.4
  • What's New in 1.3
  • What's New in 1.2
  • What's New in 1.1
  • What's New in 1.0


Release Notes

To learn more about changes and updates between versions, you can read the release notes published with the driver source code.

Learn what's new in:

The 1.15 Go driver release includes the following improvements and fixes:

  • Connection churn can be mitigated by setting a client-wide timeout by specifying the timeoutMS connection option or by calling the SetTimeout() function. When the timeout is set, the driver attempts to reuse a connection after an operation times out and waits for up to one second to check if the connection can be reused before closing it.

  • Connection pool events include a Duration field to measure the checkout duration and total amount of time it took to establish a connection.

The 1.14 Go driver release includes the following improvements and fixes:

  • Go versions before 1.18 are no longer supported.

  • In case of a heartbeat timeout, in-progress operations are preemptively canceled.

  • Connection strings that include the "mongodb+srv://" prefix can contain capital letters in the SRV hostname.

The 1.13 Go driver release includes the following improvements and fixes:

  • Logging for server selection and SDAM. To learn more about logging, see the Logging documentation.

  • Methods on the Collection type that allow you to manage search indexes programmatically.

  • The event.CommandStartedEvent and event.CommandFinishedEvent events return the DatabaseName field. This field is also included in the command-logging analogs.

  • In a sharded topology, when selecting a server to retry an unsuccessful query, the driver excludes the server used for the initial attempt. Instead, if there's more than one eligible mongos instance, the driver randomly selects one. Unhealthy instances are automatically excluded from selection.

  • Streaming SDAM is disabled by default on AWS Lambda and similar function-as-a-service (FaaS) platforms. You can enable monitoring by using the serverMonitoringMode URI option.

The 1.12 Go driver release includes the following improvements and fixes:

  • The driver unpins connections when ending a session. This prevents connections from leaking when a user runs a transaction while connected to a load balancer.

  • The driver does not throw a runtime error when you unmarshal an empty bson.RawValue type with an invalid type or marshal a nil pointer of a ReadConcern instance.

  • Setting options.LogComponentAll as the log component correctly results in the publication of logs against all components.


Deprecation Notice

  • The mongo.NewClient() and client.Connect() methods are deprecated. You can create a client and connect in one call by using the mongo.Connect() method.

New features of the 1.12 Go driver release include:

This driver version adds support for Queryable Encryption (QE). To learn more about the requirements for using the QE feature, see the Queryable Encryption Driver Compatibility Table.

The ClientEncryption.CreateEncryptedCollection() method automatically creates data encryption keys when you create a new encrypted collection. To learn how to use the QE feature, see the Quick Start in the Server manual.

You can now record connection management and command execution events by using the LogSink logging interface.

To learn more, see the Logging Fundamentals guide.

This driver version adds features to the options package to specify how the driver marshals and unmarshals BSON.

The following example shows how to set BSON options on your Client. The options specify the following behaviors:

  • The driver falls back to json struct tags if bson struct tags are absent.

  • The driver marshals nil Go map types as empty BSON documents.

  • The driver marshals nil Go slice types as empty BSON arrays.

bsonOpts := &options.BSONOptions{
UseJSONStructTags: true,
NilMapAsEmpty: true,
NilSliceAsEmpty: true,

For a full example of how to specify and implement the BSONOptions type, see the API documentation.

This driver version simplifies the WriteConcern API. To learn more about the changes, see Write Concern.

  • Support for authentication with AWS IAM roles in EKS.

  • Addition of the Cursor.SetBatchSize() method to allow specification of the size of batches fetched when iterating through a cursor.

  • Addition of the UnmarshalValue() method to allow ummarshalling of BSON values marshalled with the MarshalValue() method.


Upgrade to Version 1.11.9 or Later

Versions 1.11.0 through 1.11.2 of the driver have been retracted because of a bug that could cause undefined behavior when reading the Raw field on database error types, such as CommandError and WriteException.

Version 1.11.8 of the driver has been retracted because it incorrectly contains changes intended for 1.12.1.

Upgrade to version 1.11.9 or later if you are using a retracted version of the driver.

New features of the 1.11 Go driver release include:

  • Removal of support for MongoDB versions 3.5 and older.

  • Removal of support for Go versions 1.12 and older.

  • Improvements to Timeout API and behavior, including:

    • Modified retry logic for greater application resiliency.

    • Extended mongo.IsTimeout error helper to catch more timeout errors.

    • New GridFS methods that take contexts instead of using SetReadDeadline and SetWriteDeadline.

  • Reduced memory allocations during operation execution.

  • Fix for SRV polling bug that prevented changes in SRV records when the associated MongoDB connection string included a username and password.

  • Support for GCP service accounts when using Google Cloud Key Management Services.

  • Improvements to server-side resource cleanup when using the Cursor.All and Session.WithTransaction functions.

  • SERVICE_HOST Kerberos authentication parameter specification enabled with the authMechanismProperties connection string option.

  • Corrected output from the bson.Raw.String() method to Extended JSON type for timestamps when the BSON document contains a UTC Timestamp field.

  • Resolution of conflicts when retrying reads with read concern "available" or "linearizable".


Upgrade to Version 1.10.1 or Higher

The 1.10.1 Go driver patches a bug that can cause data corruption when rotating Data Encryption Keys encrypted with a Customer Master Key hosted on Google Cloud Key Management Service or Azure Key Vault.

New features of the 1.10 Go driver release include:

  • Full compatibility with MongoDB 6.0.

  • Support for new features related to Queryable Encryption, including new options for automatic and manual encryption.

  • Support for the new Automatic Encryption Shared Library, which replaces the mongocryptd process. The shared library requires MongoDB v6.0 Enterprise or later and libmongocrypt 1.5.0 or later.

  • clustered index creation support.

  • A new API and ClientEncryption entity operations for encryption key management.

  • A Timeout client option to set default context timeouts for each operation sent through that client.

  • A patch to default data to either primitive.M or primitive.D when decoding empty types.

  • Support for encoding atypical map key types for data that can be unmarshalled into a textual representation of itself.

  • Performance optimizations, including:

    • Improved full document requests for before and after updates in change stream events.

    • Improved PRN and UUID generation.

    • Reduced memory consumption when compressing wire messages.

  • Troubleshooting support for frequently encountered issues.

New features of the 1.9 Go driver release include:

  • Improved connection storm mitigation.

  • Custom options to change-stream and aggregate operations.

  • Let option on most CRUD commands that specifies parameters for use in an aggregate expression. Let must be a document that maps parameter names to values that are constant or closed expressions without references to document fields. MongoDB v5.0 or later is required.

  • New constructor functions that create Cursor and SingleResult instances from marshallable and non-nil BSON documents.

New features of the 1.8 Go driver release include:

  • Full compatibility with MongoDB 5.1.

  • Support for KMIP as a KMS provider for CSFLE.

  • Redesigned driver connection pool for low operation Context timeouts and to reduce connection churn. Behavior changes include:

    • New connection creation times out at connectTimeoutMS.

    • At most, two new connections can be established at the same time.

  • Removal of oppressive and unnecessarily gendered language in the Go driver documentation, code, tests, and spec tests.


Upgrade to Version 1.7.2 or Higher

The 1.7.2 Go driver contains a bug fix for a data race that can occur between creating and checking out connections when minPoolSize > 0.

New features of the 1.7 Go driver release include:

  • Full compatibility with MongoDB 5.0.

  • Support for the "snapshot" read concern outside of multi-document transactions for certain read operations.

  • Improved WriteException and BulkWriteException error messages for schema validation reported by the WriteError.Details field.


Upgrade to Version 1.6.2 or Higher

The 1.6.2 Go driver contains a bug fix for a data race that can occur between creating and checking out connections when minPoolSize > 0.

New features of the 1.6 Go driver release include:

  • Support for the MongoDB Stable API. For more information, see the Stable API Guide.

  • Support for connections to any MongoDB service that runs behind a load balancer.

  • Support for creating time series collections. For more information, see the Time Series Collections Guide.

  • Let option for aggregate expressions.

New features of the 1.5 Go driver release include:

  • Support for Azure and GCP key-management services with Client-side Field Level Encryption.

  • New errors API to detect duplicate-key errors, timeouts, and network errors.

  • Server monitoring to monitor changes on a MongoDB deployment.

  • Errors to prevent unexpected behavior on maps that contain multiple keys being used as a hint option, as a sort option, or for index creation.

New features of the 1.4 Go driver release include:

  • Full compatibility with MongoDB 4.4.

  • Support for stapled and non-stapled OCSP verification.

  • New tlsDisableOCSPEndpointCheck=true URI option to disable sending HTTP requests if the OCSP responder is not reachable from the driver and there is no stapled response.

  • Additional context to errors encountered during BSON unmarshalling.

  • Proper Unwrap functions for various driver error types.

New features of the 1.3 Go driver release include:

  • mgocompat package that exports a BSON registry compatible with globalsign/mgo/bson, which can be used by calling the ClientOptions.SetRegistry method.

  • RegisterTypeEncoder and RegisterHookEncoder methods, which replace the deprecated RegisterEncoder method. A corresponding change has been made to replace RegisterDecoder.

New features of the 1.2 Go driver release include:

  • Support for CSFLE.

  • bson.MarshalValue function, which marshals Go types to BSON.

  • StringCodec, which allows non-string fields to be decoded into a String field in a struct.

  • IntCodec, UIntCodec, BoolCodec, and FloatCodec added to mgocompat to allow codecs to convert between numbers and booleans.

New features of the 1.1 Go driver release include:

  • Full compatibility with MongoDB 4.2.

  • Redesigned lower-level driver implementation to improve maintainability and performance.

  • Connection Monitoring and Pooling specifications to monitor various connection and connection pool events with improved efficiency.

This release adds no new features.

← Quick Reference