Releases: mongodb/mongo-go-driver
MongoDB Go Driver 1.17.2
The MongoDB Go Driver Team is pleased to release version 1.17.2 of the official MongoDB Go driver.
Release Notes
This release addresses several issues and tasks to improve the functionality of the Go Driver. It includes a fix for a bug in the DefaultValueDecoders.ValueUnmarshalerDecodeValue to avoid inappropriately instantiating a pointer field decoded from null data if the user defined an UnmarshalBSONValue. Additionally, the release resolves a goroutine and memory leak issue found in the Zstandard (zstd) network compression decoding process.
Furthermore, the release includes a task to restore the ReadCompressedCompressedMessage() function to the wiremessage API. This function was previously removed under task GODRIVER-3303 with the aim of preventing out-of-bounds runtime errors, as it was identified as complicit in such issues and was not needed by the driver itself. However, it has been identified as a convenient utility for some users of the Go Driver.
For a full list of tickets included in this release, please see the links below:
Full Changelog: v1.17.1...v1.17.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 2.0.0
The MongoDB Go Driver Team is pleased to release version 2.0.0 of the official MongoDB Go driver.
Release Notes
This release includes a host of new features and several breaking changes. Below, we provide an overview of the key highlights, changes, and guidance for migrating from version 1.x to 2.0. See the MongoDB docs for a complete list of breaking changes and additional information on what's new.
This release includes several breaking changes that users must account for when upgrading, including:
- Options Package: The approach to managing options has been restructured to use a builder pattern, changing how options are constructed and applied. This alteration allows for more flexible and dynamic option configurations, but may require changes to existing code that directly manipulates options objects.
- Mongo Package: The
Client.Connect()method has been removed, favoringmongo.Connect()to streamline connection handling. - Event Package: References to the
descriptionpackage have been transitioned toevent.ServerDescriptionandevent.TopologyDescription, impacting how server and topology details are accessed. - BSON Package Consolidation: All previously separate BSON-related packages, including
bsoncodec,bsonoptions,bsonrw, andmgocompat, have been merged into the singlebsonpackage. Many functionalities from these packages have been reorganized or renamed. For instance,bson.NewRegistryBuilderhas been replaced with new APIs tailored for registry configuration, and interfaces likeValueReaderandValueWriterare now part of the consolidatedbsonpackage. This consolidation simplifies the package structure but requires updates to import paths and related logic.
To ease the transition to 2.0, a comprehensive migration guide has been provided. This guide includes detailed instructions to navigate the changes, including the updated options pattern, altered imports, and revised method signatures.
Additionally, this release deprecates support for MongoDB server versions below 3.6. Support for MongoDB 3.6 will be dropped in a future update.
New features will no longer be added to the 1.x versions. However, critical bug fixes and CVE resolutions will continue to be back-ported to 1.x versions for one year until November 25, 2025. After this date, support for 1.x versions will be discontinued.
We express our gratitude to our contributors and the community for all the support in developing this release.
For a full list of tickets included in this release, please see the links below:
Full Changelog: v1.17.1...v2.0.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.17.1
The MongoDB Go Driver Team is pleased to release version 1.17.1 of the official Go driver.
Release Notes
This release improves the behavior of connection checkout by checking for closed connections.
It also fixes a bug where the authSource from a TXT record would be overridden for auth mechanisms
that require an authSource of $external.
For a full list of tickets included in this release, please see the links below:
Full Changelog: v1.17.0...v1.17.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 2.0.0-beta2
The MongoDB Go Driver Team is pleased to pre-release version 2.0.0-beta2 of the official MongoDB Go driver.
See the full details in the forum post.
MongoDB Go Driver 1.17.0
The MongoDB Go Driver Team is pleased to release version 1.17.0 of the official MongoDB Go driver.
Release Notes
This release adds support for client authentication using OpenID Connect (MONGODB-OIDC), and for the Queryable Encryption Range Protocol. The driver now supports MongoDB 8.0. Additionally, IndexView has been extended to include methods for dropping indexes by key (i.e. DropOneWithKey and DropWithKey).
Note
This is the last planned minor release in the 1.x series. Future driver versions will be in the 2.x series. The v1.17.x will still receive security and bug fixes for a year.
Queryable Encryption Range Protocol
Added range protocol support for Queryable Encryption.
MONGODB-OIDC
Added support OpenID Connect (OIDC) authentication for workload identities. A workload identity is an identity you assign to a software workload, such as an application, service, script, or container, to authenticate and access other services and resources.
See the documentation for more details.
For a full list of tickets included in this release, please see the links below:
Full Changelog: v1.16.1...v1.17.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.16.1
The MongoDB Go Driver Team is pleased to release version 1.16.1 of the official Go driver.
Release Notes
This release fixes a bug where excessive heartbeat checks would be emitted in polling mode.
For a full list of tickets included in this release, please see the links below:
Full Changelog: v1.16.0...v1.16.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.16.0
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
matthewdale
Matt Dale
b87684f
matthewdale
Matt Dale
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
maxTimeMSvalue for Find and Aggregate operations when a client-wide timeout (e.g. viatimeoutMSor SetTimeout) is set and an operation timeout (i.e. aContextwith deadline) is set. Previously,maxTimeMSwas always omitted, even if it was set using the SetMaxTime option. - (GODRIVER-2992) Add a
RemainingBatchLengthmethod to theChangeStream, similar to the identically named method on theCursortype.
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
qingyang-hu
Qingyang Hu
d265534
qingyang-hu
Qingyang Hu
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
qingyang-hu
Qingyang Hu
c1bb261
qingyang-hu
Qingyang Hu
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!