MongoDB Ruby Driver

The MongoDB database is a document-oriented NoSQL database, perfect for high intensive load environments.

The MongoDB Ruby Driver enables developers to write apps that connect, store and retrieve information from a MongoDB database.

This is a MongoDB connector created and supported by the official MongoDB development team, coming packed with lots of examples and documentation.

The MongoDB Ruby Driver includes support for primary keys, cursors, connection pooling, string encoding, forking, and socket timeouts.

Tested to work on both Ruby and JRuby.

MongoDB also comes with drivers for various other programming languages as well:

C

Perl

Haskell

What is new in this release:

• Only use SSL options if :ssl is true
• Fix authentication sources and slight auth refactor.
• Don't raise an error if a non-existent collection is dropped.
• Raise error for malformed queries and don't send to the server.
• Print first 250 chars of query selector when logging and rescue inspect error.
• Cluster returns empty list of servers if there are none instead of nil.
• Topology refactor to use Single naming and semantics.
• Auto test patched ruby versions on Travis.
• Update collection namespace to show database first.
• Updates so test suite can run using SSL in Jenkins.
• Use #getaddrinfo to determine protocol in Address class.
• URI errors moved to appropriate directory.

What is new in version 2.1.0:

• Only use SSL options if :ssl is true
• Fix authentication sources and slight auth refactor.
• Don't raise an error if a non-existent collection is dropped.
• Raise error for malformed queries and don't send to the server.
• Print first 250 chars of query selector when logging and rescue inspect error.
• Cluster returns empty list of servers if there are none instead of nil.
• Topology refactor to use Single naming and semantics.
• Auto test patched ruby versions on Travis.
• Update collection namespace to show database first.
• Updates so test suite can run using SSL in Jenkins.
• Use #getaddrinfo to determine protocol in Address class.
• URI errors moved to appropriate directory.

What is new in version 2.0.5:

• Only use SSL options if :ssl is true
• Fix authentication sources and slight auth refactor.
• Don't raise an error if a non-existent collection is dropped.
• Raise error for malformed queries and don't send to the server.
• Print first 250 chars of query selector when logging and rescue inspect error.
• Cluster returns empty list of servers if there are none instead of nil.
• Topology refactor to use Single naming and semantics.
• Auto test patched ruby versions on Travis.
• Update collection namespace to show database first.
• Updates so test suite can run using SSL in Jenkins.
• Use #getaddrinfo to determine protocol in Address class.
• URI errors moved to appropriate directory.

What is new in version 2.0.4:

• Only use SSL options if :ssl is true
• Fix authentication sources and slight auth refactor.
• Don't raise an error if a non-existent collection is dropped.
• Raise error for malformed queries and don't send to the server.
• Print first 250 chars of query selector when logging and rescue inspect error.
• Cluster returns empty list of servers if there are none instead of nil.
• Topology refactor to use Single naming and semantics.
• Auto test patched ruby versions on Travis.
• Update collection namespace to show database first.
• Updates so test suite can run using SSL in Jenkins.
• Use #getaddrinfo to determine protocol in Address class.
• URI errors moved to appropriate directory.

What is new in version 2.0.3:

• Only use SSL options if :ssl is true
• Fix authentication sources and slight auth refactor.
• Don't raise an error if a non-existent collection is dropped.
• Raise error for malformed queries and don't send to the server.
• Print first 250 chars of query selector when logging and rescue inspect error.
• Cluster returns empty list of servers if there are none instead of nil.
• Topology refactor to use Single naming and semantics.
• Auto test patched ruby versions on Travis.
• Update collection namespace to show database first.
• Updates so test suite can run using SSL in Jenkins.
• Use #getaddrinfo to determine protocol in Address class.
• URI errors moved to appropriate directory.

What is new in version 1.12.0 / 2.0.0.beta:

• Allow certain URI options to have mixed cases.
• Bug fix in MongoReplicaSetClient when no manager is set and max batch size is referenced.
• Bug fix when creating/removing users and creating an index in mongos versions < 2.4.
• Bug fix that jnote and wnote should not raise errors when connected to legacy servers.

What is new in version 1.9.2:

• Exception should be raised when using limit() with an exhaust cursor
• Support URI encoded characters in passwords
• Problem connecting to multiple databases
• Crash with BSON::ObjectId.new('\xff')
• Raise error when exhaust flag is used with mongos
• find_and_modify does not return lastErrorObject

What is new in version 1.9.0:

• Added support for batch insert over multiple messages.
• Added support for delegated authentication.
• Added support for SSL certificate validation.
• Fixed issue with support for auth params the URI parser.
• Fixed Apache 2.0 license compliance.
• Fixed bson c-extension bugs.

What is new in version 1.8.6:

• Fixed:
• Concurrency issue in PoolManager#connect_to_members
• Replica set :nearest read preference
• Replica/sharded client reconnection errors
• ShardingPoolManager::check_connection_health not supporting authentication

What is new in version 1.8.0:

• MongoClient, MongoReplicaSetClient, MongoShardedClient and GridFS implement a new write concern interface at Client, DB, Collection, and Operation levels
• Deprecation of Mongo::Connection in favor of Mongo::MongoClient
• Deprecation of Mongo::ReplSetConnection in favor of Mongo::MongoReplicaSetClient
• Deprecation of Mongo::ShardedConnection in favor of Mongo::MongoShardedClient
• Allow specification of comment query opt (Evan Broder)
• Fix for pool authentication and logout (Olivier Bonnaure)
• Fix for cursor not being closed in presense of exceptions (Simon Simeonov)
• Fix for data send failure not closing socket (Nelson Elhage)
• Tutorials and non code documentation moved to GitHub wiki
• Provided binary mongo_client has been renamed to mongo_console

What is new in version 1.7.0:

• Added testing and full support for MongoDB 2.1 & 2.2
• Added Aggregation Framework helper method
• Added support for Mongos high availability
• Modified and added new read preferences (details in documentation)
• Added support for data center awareness (tag_sets)
• Fixed bug which attempted to close cursors on wrong replica set member

What is new in version 1.6.3:

• Performance measurements and enhancements (especially for C-extensions)
• Bug fixes for checking strings with non UTF-8 forced or implied encodings
• Added refresh support for multiple threaded instances of ReplSetConnection
• Added ability to handle IRB::Abort Exception (ctrl-c) cleanly
• Added support for large dates on 32-bit platforms (Ruby 1.9+)
• Added #to_ary method for BSON::ObjectId

What is new in version 1.6.2:

• Added ability to authentication via secondary if primary node unavailable
• Replica set refresh interval now enforces a lower bound of 60 seconds
• Added documentation for dropping indexes, collections, databases
• Test output cleanup (...)s unless failure occurs

What is new in version 1.6.1:

• Added thread affinity to Mongo::Pool.
• Added deploy tasks.
• Added Travis CI support.
• Logging warning message is only displayed for level :debug.

What is new in version 1.6.0:

• Added Gemfile.
• ReplSetConnection seed format is now array of 'host:port' strings.
• Added read preference :secondary_only.
• Added ability to log duration -- enabled by default.
• Added readonly option for DB#adduser.
• Added :collectonerror option for bulk-insert.
• Added and updated URI options (now case insensitive).
• Bug fix for ReplSet refresh attempting to close a closed socket.
• Default op_timeout for ReplSetConnection is now disabled (was 30 seconds).
• Support db output option for map reduce.
• Support for keeping limited versions of files using GridFS.

What is new in version 1.5.0:

• Removed: async refresh mode.
• Disabled auto refresh mode by default. If you want the driver to automatically check the state of the replica set, you must use :sync mode. Note that replica set refresh is designed only to account for benign changes to the replica set (adding and removing nodes that don't affect current connections).
• Fixed bug with commands being sent to secondary nodes. The next release will allow you to specify where commands can be sent.
• Support: j safe mode option.
• Fix: max_scan and :show_disk_loc Cursor options.

What is new in version 1.4.1:

• Simplified replica set refresh.
• Fix bugs associated with replica set refresh.
• Make cursor smart enough to continue functioning even if a refresh is triggered.

What is new in version 1.3.1:

• Fix GridIO#gets infinite loop error
• Fix BSON::OrderedHash#reject! leaving keys with null values
• Minor semantic fix for OrderedHash#reject!
• Fix Mongo::DB to allow symbols in method traversing collection names
• Support new server regex option "s" (dotall). This is folded in with \m in Ruby.
• Fix so that Cursor#close hits the right node when :read_secondary is enabled.
• Support maxScan, showDiskLoc, and returnKey cursor options.
• Make DB#validate_collection compatible with server v1.9.1.
• Fix so that GridIO#gets returns local md5 with md5 matches server md5.
• Fix bug in BSON::OrderedHash that prevents YAML.load.
• Fix example from /examples.
• Ensure that we do not modify hash arguments by calling Hash#dup when appropriate.
• Ensure that JRuby deserializer preserves binary subtypes properly.
• Fix for streaming an empty file into GridFS.
• Minor doc fixes.