Skip to content

Releases: mongodb/mongo-go-driver

MongoDB Go Driver 1.16.0

28 Jun 01:40
Compare
Choose a tag to compare

The MongoDB Go Driver Team is pleased to release version 1.16.0 of the official Go driver.

Release Notes

This release adds the ability to specify an index type when creating an Atlas Search Index, reduces memory usage when using "zstd" compression, and upgrades dependencies.

Specify type when creating a search index

Allow specifying index type via SearchIndexModel.Options.SetType when creating a search index.

Reduce zstd memory usage

When "zstd" compression is enabled, static memory usage and per-operation memory usage are reduced.

Upgrade dependencies

  • Bump golang.org/x/crypto from 0.17.0 to 0.22.0
  • Bump github.com/google/go-cmp from 0.5.2 to 0.6.0
  • Bump github.com/montanaflynn/stats from 0.0.0-20171201202039-1bf9dbcd8cbe to 0.7.1
  • Bump golang.org/x/sync from 0.1.0 to 0.7.0
  • Bump github.com/golang/snappy from 0.0.1 to 0.0.4

For a full list of tickets included in this release, please see the links below:

Full Changelog: v1.15.1...v1.16.0

Documentation for the Go driver can be found on pkg.go.dev and the MongoDB documentation site. BSON library documentation is also available on pkg.go.dev. Questions and inquiries can be asked on the MongoDB Developer Community. Bugs can be reported in the Go Driver project in the MongoDB JIRA where a list of current issues can be found. Your feedback on the Go driver is greatly appreciated!

MongoDB Go Driver 1.15.1

17 Jun 15:42
v1.15.1
b87684f
Compare
Choose a tag to compare

The MongoDB Go Driver Team is pleased to release version 1.15.1 of the official Go driver.

Release Notes

This release fixes various bugs and addresses a few usability issues:

  • (GODRIVER-3107) Fixes a possible connection leak in the background round-trip-time monitor.
  • (GODRIVER-3217) Allows manually specifying a maxTimeMS value for Find and Aggregate operations when a client-wide timeout (e.g. via timeoutMS or SetTimeout) is set and an operation timeout (i.e. a Context with deadline) is set. Previously, maxTimeMS was always omitted, even if it was set using the SetMaxTime option.
  • (GODRIVER-2992) Add a RemainingBatchLength method to the ChangeStream, similar to the identically named method on the Cursor type.

For a full list of tickets included in this release, please see the links below:

Full Changelog: v1.15.0...1.15.1

Documentation for the Go driver can be found on pkg.go.dev and the MongoDB documentation site. BSON library documentation is also available on pkg.go.dev. Questions and inquiries can be asked on the MongoDB Developer Community. Bugs can be reported in the Go Driver project in the MongoDB JIRA where a list of current issues can be found. Your feedback on the Go driver is greatly appreciated!

Full Changelog: v1.15.0...v1.15.1

MongoDB Go Driver 1.14.1

09 May 20:55
v1.14.1
d265534
Compare
Choose a tag to compare

The MongoDB Go Driver Team is pleased to release version 1.14.1 of the official Go driver.

Release Notes

This release fixes a bug of connection leaking.


For a full list of tickets included in this release, please see the links below:

Full Changelog: v1.14.0...1.14.1

Documentation for the Go driver can be found on pkg.go.dev and the MongoDB documentation site. BSON library documentation is also available on pkg.go.dev. Questions and inquiries can be asked on the MongoDB Developer Community. Bugs can be reported in the Go Driver project in the MongoDB JIRA where a list of current issues can be found. Your feedback on the Go driver is greatly appreciated!

MongoDB Go Driver 1.13.4

08 May 20:14
v1.13.4
c1bb261
Compare
Choose a tag to compare

The MongoDB Go Driver Team is pleased to release version 1.13.4 of the official Go driver.

Release Notes

This release fixes a bug of connection leaking.


For a full list of tickets included in this release, please see the links below:

Full Changelog: v1.13.2...1.13.4

Documentation for the Go driver can be found on pkg.go.dev and the MongoDB documentation site. BSON library documentation is also available on pkg.go.dev. Questions and inquiries can be asked on the MongoDB Developer Community. Bugs can be reported in the Go Driver project in the MongoDB JIRA where a list of current issues can be found. Your feedback on the Go driver is greatly appreciated!

MongoDB Go Driver 1.15.0

16 Apr 17:44
v1.15.0
7a495f2
Compare
Choose a tag to compare

The MongoDB Go Driver Team is pleased to release version 1.15.0 of the official Go driver.

Release Notes

This release adds a feature that can prevent "connection churn" caused by operation timeouts.

Prevent "Connection Churn" Caused by Timeouts

Previously, the Go Driver would close the in-use connection when an operation timed out. However, closing the in-use connection can cause significant additional application and database load if many timeouts happen quickly, potentially causing "connection churn" that can exacerbate latency issues. The Go Driver now offers a new feature that waits (for a maximum of 1 second) for the connection to be reusable after an operation times out instead of closing it.

To enable the new feature, set a Client-wide timeout by using SetTimeout or by specifing the timeoutMS connection string option. Use SetTimeout(0) or timeoutMS=0 to enable the new feature without adding new timeouts. See SetTimeout for more information about the Client-wide timeout configuration.


For a full list of tickets included in this release, please see the links below:

Full Changelog: v1.14.0...1.15.0

Documentation for the Go driver can be found on pkg.go.dev and the MongoDB documentation site. BSON library documentation is also available on pkg.go.dev. Questions and inquiries can be asked on the MongoDB Developer Community. Bugs can be reported in the Go Driver project in the MongoDB JIRA where a list of current issues can be found. Your feedback on the Go driver is greatly appreciated!

MongoDB Go Driver 1.14.0

15 Feb 13:39
v1.14.0
Compare
Choose a tag to compare

The MongoDB Go Driver Team is pleased to release version 1.14.0 of the official Go driver.

Release Notes

This release bumps the minimum Go version from 1.13 to 1.18. It also brings several additional changes and improvements.

Notable Changes

  • In case of a heartbeat timeout, in-progress operations are preemptively canceled.
  • Support connecting with a "mongodb+srv://" URI that contains capital letters in the SRV hostname.

For a full list of tickets included in this release, please see the links below:

Full Changelog: v1.13.2...1.14.0

Documentation for the Go driver can be found on pkg.go.dev and the MongoDB documentation site. BSON library documentation is also available on pkg.go.dev. Questions and inquiries can be asked on the MongoDB Developer Community. Bugs can be reported in the Go Driver project in the MongoDB JIRA where a list of current issues can be found. Your feedback on the Go driver is greatly appreciated!

MongoDB Go Driver 1.13.2

14 Feb 14:20
v1.13.2
6ac7f31
Compare
Choose a tag to compare

The MongoDB Go Driver Team is pleased to release version 1.13.2 of the official Go driver.

Release Notes

This release restores the behavior that an empty map or slice is decoded as nil, and fixes a bug of connecting via UNIX sockets like mongodb://%2Ftmp%2Fmongodb-27017.sock.

This release also stops propagating passwords in error messages.


For a full list of tickets included in this release, please see the links below:

Full Changelog: v1.13.1...1.13.2

Documentation for the Go driver can be found on pkg.go.dev and the MongoDB documentation site. BSON library documentation is also available on pkg.go.dev. Questions and inquiries can be asked on the MongoDB Developer Community. Bugs can be reported in the Go Driver project in the MongoDB JIRA where a list of current issues can be found. Your feedback on the Go driver is greatly appreciated!

MongoDB Go Driver 1.13.1

06 Dec 22:51
v1.13.1
a2e5cba
Compare
Choose a tag to compare

The MongoDB Go Driver Team is pleased to release version 1.13.1 of the official Go driver.

Release Notes

This release fixes a bug that can cause a panic when encoding or decoding Go error values as BSON and a bug that prevented BSONOptions from being applied when set on a Database or Collection.


For a full list of tickets included in this release, please see the links below:

Full Changelog: v1.13.0...1.13.1

Documentation for the Go driver can be found on pkg.go.dev and the MongoDB documentation site. BSON library documentation is also available on pkg.go.dev. Questions and inquiries can be asked on the MongoDB Developer Community. Bugs can be reported in the Go Driver project in the MongoDB JIRA where a list of current issues can be found. Your feedback on the Go driver is greatly appreciated!

MongoDB Go Driver 1.12.2

08 Nov 20:13
v1.12.2
Compare
Choose a tag to compare

The MongoDB Go Driver Team is pleased to release version 1.12.2 of the official Go driver.

Release Notes

This release comes with several performance improvements in marshaling and compression, along with a bug fix in the Client Side Encryption. It also improves the reliability of WithTransaction by preventing timeouts while committing a transaction.


For a full list of tickets included in this release, please see the links below:

Full Changelog: v1.12.1...1.12.2

Documentation for the Go driver can be found on pkg.go.dev and the MongoDB documentation site. BSON library documentation is also available on pkg.go.dev. Questions and inquiries can be asked on the MongoDB Developer Community. Bugs can be reported in the Go Driver project in the MongoDB JIRA where a list of current issues can be found. Your feedback on the Go driver is greatly appreciated!

MongoDB Go Driver 1.13.0

08 Nov 19:59
v1.13.0
01cc2a2
Compare
Choose a tag to compare

⚠️ Retracted

v1.13.0 has been retracted because the Github tag was modified, leading to a security error when dowloading the Go module. The original tag does not include all changes intended for v1.13.0 and should not be used.

Please use version 1.13.1 or higher.


The MongoDB Go Driver Team is pleased to release version 1.13.0 of the official Go driver.

Release Notes

This release enhances logging, search index management, and command events. This release also introduces smarter server selection for sharded clusters, optimizing retry selection. Additionally, we streamline resource usage on FaaS platforms by disabling streaming SDAM and introduce the serverMonitoringMode=stream/poll/auto URI option.

Logging

In this release, we add logging for server selection and SDAM (Server Discovery and Monitoring). See the Go Driver logging documentation for usage.

Search Index Management Helpers

New mongo.Collection methods have been added to support search index management. For more information on search indexes, see the documentation here.

Users can create and manage search indexes programmatically. This update provides more flexibility and a smoother user experience, allowing you to define your search index within your code.

Include DatabaseName in Command Events

DatabaseName is now returned by event.CommandStartedEvent and event.CommandFinishedEvent. This field will also be included in the command logging analogues. This addition will improve performance for users needing to keep a thread-safe map to maintain command-database relations, whereas now such a map can be deprecated.

Possible Retries to Alternate Mongos for Read/Write

In sharded MongoDB cluster deployments, it's essential to avoid repeatedly selecting a failing mongos instance. Currently, the driver randomly selects a mongos for each operation, which can lead to retrying failed operations with the same problematic mongos. This enhancement introduces smarter server selection for sharded topologies:

  1. The driver will distinguish between the initial attempt and a retry.
  2. It will remember the server used for the initial attempt.
  3. When retrying, if multiple eligible mongos servers are available, the driver will select randomly from the healthy ones, excluding the previously used server.

The driver can assess mongos health before attempting a query and exclude unhealthy mongos from selection.

Transition to Polling Monitoring in FaaS Environments

In this release, we make important changes to enhance performance and flexibility. By default, streaming SDAM is now disabled on AWS Lambda and similar FaaS platforms, ensuring efficient resource utilization. We also introduce the serverMonitoringMode=stream/poll/auto URI option to give you greater control over monitoring modes. To improve client behavior, we mandate that clients refrain from using dedicated connections to measure Round-Trip Time (RTT) when employing the polling protocol. These updates aim to provide a more versatile and efficient experience for users.


For a full list of tickets included in this release, please see the links below:

Full Changelog: v1.12.2...1.13.0

Documentation for the Go driver can be found on pkg.go.dev and the MongoDB documentation site. BSON library documentation is also available on pkg.go.dev. Questions and inquiries can be asked on the MongoDB Developer Community. Bugs can be reported in the Go Driver project in the MongoDB JIRA where a list of current issues can be found. Your feedback on the Go driver is greatly appreciated!