2.18.0.beta1

This beta release of the Ruby driver supports MongoDB version 5.2 and 6.0. This release can be used for early testing of new features, but are not suitable for production deployments.

Please note that MongoDB 6.0 binaries are currently available only as release candidates. Release candidates can be used for early testing of new features, but are not suitable for production deployments.

This release includes the following new features:

• Added support for queryable encryption.
• Added support for Azure Key Vault, Google Cloud Key Management, and any
  KMIP compliant Key Management System to be used as master key storage for
  client side encryption.

Following issues were also implemented or fixed:

• RUBY-2922 Use the count command instead of collStats to implement estimatedDocumentCount
• RUBY-2909 Snapshot Query Examples for the Manual
• RUBY-2682 Specify 5.0 cursor behaviour
• RUBY-2920 "ChangeStream Spec: fullDocument field in ChangeStreamOptions should be an optional to handle ""default"" case."
• RUBY-2766 Allow hint for unacknowledged writes using OP_MSG when supported by the server
• RUBY-2746 Provide options to limit number of mongos servers used in connecting to sharded clusters
• RUBY-2736 Add server connectionId to command monitoring events
• RUBY-2528 Permit inserting dollar-prefixed or dotted keys
• RUBY-2525 Expose the Reason an Operation Fails Document Validation
• RUBY-2737 Allow custom service names with srvServiceName URI option
• RUBY-2990 Terminate push monitor when it fails
• RUBY-2973 Add the acknowledged? field to the BulkWrite::Result class
• RUBY-2966 QueryCache: Add ActiveJob wrapper
• RUBY-2845 JRuby 9.3 Support
• RUBY-2969 Always report 'wallTime' in the change stream event output
• RUBY-2959 Clustered Indexes for all Collections
• RUBY-2956 Make allowDiskUse opt-out rather than opt-in in 6.0
• RUBY-2891 Change streams support for user-facing PIT pre- and post-images
• RUBY-2822 Add support for the comment field to all helpers
• RUBY-2814 Support authorizedCollections option for listCollections helpers
• RUBY-2742 "Remove OP_KILL_CURSORS, OP_INSERT, OP_UPDATE, OP_DELETE implementations + tests"
• RUBY-2715 Document Time-Series Collections
• RUBY-2480 to_bson getting called 6 times on a collection insert
• RUBY-2443 Adjust batch size based on limit & remaining # of documents
• RUBY-2090 Move driver DBRef class to bson-ruby
• RUBY-2834 Rails 7 Support
• RUBY-2590 Driver Handling of DBRefs
• RUBY-2978 Ruby 3.1: Synchronize can't be called from trap context
• RUBY-2972 Calling find_one_and_* methods with write_concern 0 causes an error
• RUBY-2923 Slow spawn of mongocryptd
• RUBY-3009 Update min_pool_size documentation for population
• RUBY-2961 Zero & negative limits not emulated correctly by QueryCache
• RUBY-2996 Implement update and replace validation
• RUBY-2869 ruby 3.1.0: finalizer can't synchronize using mutexes
• RUBY-2843 count_documents is not documented/tested to take session option

2.17.1

This bug fix release in the 2.17 series repairs the following issues:

• RUBY-2869 Avoid using mutexes in code called from finalizers for Ruby 3.1 compatibility
• RUBY-2932 Repair read preference passing in Mongoid when using map_reduce

2.16.2

This bug fix release in the 2.16 series repairs a regression manifesting in Mongoid when using map_reduce and passing read preference:

• RUBY-2932 map_reduce changes broke read preference passing from Mongoid

2.17.0

This feature release of the Ruby Driver adds support for MongoDB server 5.1.

This release includes the following new features:

• RUBY-2524 Snapshot reads. Added new readConcern level "snapshot" (non-speculative) for read commands outside of transactions, including on secondaries.
• RUBY-2526 Support $merge and $out executing on secondaries
• RUBY-2659 Support 'let' option for aggregate command
• RUBY-2821 Support 'let' option for CRUD commands

This release removes support for Ruby versions 2.3 and 2.4. The minimal required Ruby version is now 2.5. Read more about this change here.

This release also removes support for MongoDB versions older than 3.6. Read more about this change here.

The following bugs were fixed:

• RUBY-2805 Push monitor thread can exit when address resolution fails

The following non-breaking changes were made:

• RUBY-2806 Avoid tight looping in push monitor
• RUBY-2733 mapReduce command is now deprecated

2.16.1

This is a patch release in the 2.16 series.

The following bugs were fixed:

• RUBY-2805 Push monitor thread can exit when address resolution fails

The following non-breaking changes were made:

• RUBY-2806 Avoid tight looping in push monitor

2.16.0

This release adds the following new feature:

• Load balancer support.

This release of the Ruby driver deprecates support for MongoDB server versions below 3.6.

2.16.0.alpha1

This release adds the following new feature:

• Experimental load balancer support.

The following minor improvement has been made:

• GridFS file retrieval no longer requires index creation privileges when the indexes already exist, and is thus usable with users that have only read permissions.

This release of the Ruby driver increases the minimum required Ruby versionto 2.4.

2.15.1

This patch release in the 2.15 series fixes the following issue:

• RUBY-2675 QueryCache returns wrong results after partial iteration of result set, e.g. after calling none?

2.14.1

This patch release in the 2.14 series fixes the following issues:

• RUBY-2453 Segfault at program exit due to SRV polling
• RUBY-2558 :secondary_preferred read preference in 3.6+ sharded clusters performs primary read
• RUBY-2675 QueryCache returns wrong results after partial iteration of result set, e.g. after calling none?

2.13.3

This patch release in the 2.15 series fixes the following issue:

• RUBY-2558 :secondary_preferred read preference in 3.6+ sharded clusters performs primary read