In this guide, you can learn how to use the Ruby driver to update documents in a MongoDB collection by using the update_one and update_many methods.
The examples in this guide use the restaurants collection in the sample_restaurants database from the Atlas sample datasets. To access this collection from your Ruby application, create a Mongo::Client object that connects to an Atlas cluster and assign the following values to your database and collection variables:
database = client.use('sample_restaurants')collection = database[:restaurants]To learn how to create a free MongoDB Atlas cluster and load the sample datasets, see the Get Started with Atlas guide.
You can update documents in MongoDB by using the following methods:
update_one: Updates the first document that matches the search criteria
update_many: Updates all documents that match the search criteria
Each update method requires the following parameters:
Query filter, which matches the documents you want to update. To learn more about query filters, see the Specify a Query guide.
Update document, which specifies the update operator and the fields and values to be updated. The update operator specifies the type of update to perform. To view a list of update operators and learn about their usages, see the Field Update Operators guide page in the MongoDB Server manual.
The following example uses the update_one method to find the first document where the value of the name field is "Happy Garden". It then uses the $set operator to update the name field value to "Mountain House".
filter = { name: 'Happy Garden' }update = { '$set' => { name: 'Mountain House' } }single_result = collection.update_one(filter, update)puts "#{single_result.modified_count} document(s) updated."The following example uses the update_many method to update all documents where the value of the name field is "Starbucks". The update document uses the $rename operator to change the name of the address field to location.
filter = { name: 'Starbucks' }update = { '$rename' => { address: 'location' } }many_result = collection.update_many(filter, update)puts "#{many_result.modified_count} document(s) updated."The update_one and update_many methods accept options to configure the update operation. You can pass these options individually as parameters, or you can create a Hash object that contains the options and pass the object as a parameter. If you don't specify any options, the driver performs the update operation with default settings.
The following table describes the options that you can use to configure the update operation:
Option
Description
upsert
Whether the update operation performs an upsert operation if no documents match the query filter. For more information, see the
upsert statementin the MongoDB Server manual.
Default: false
bypass_document_validation
Whether the update operation bypasses document validation. This lets you update documents that don't meet the schema validation requirements, if any exist. For more information about schema validation, see
Schema Validationin the MongoDB Server manual.
Default: false
collation
Language collation to use when sorting results. For more information, see
Collationin the MongoDB Server manual.
array_filters
List of filters that you specify to select which array elements the update applies to.
hint
Index to use when matching documents. For more information, see the
hint statementin the MongoDB Server manual.
let
Map of parameter names and values to set top-level variables for the operation. Values must be constant or closed expressions that don't reference document fields. For more information, see the
let statementin the MongoDB Server manual.
The example uses the $equal operator to match documents where the value of the name field is "Sunrise Pizzeria". It then uses the $set operator to set the borough field value in the first matching document to "Queens" and the cuisine field value to "Italian".
Because the upsert option is set to true, if the query filter doesn't match any existing documents, the driver inserts a new document that contains the fields and values in the filter and update documents.
filter = { 'name' => 'Sunrise Pizzeria' }update = { '$set' => { borough: 'Queens', cuisine: 'Italian' } }upsert_result = collection.update_one(filter, update, upsert: true)puts "#{upsert_result.modified_count} document(s) updated."The update_one and update_many methods each return a Result object. You can access the following methods from a Result instance:
Method
Description
matched_count
Number of documents that matched the query filter, regardless of how many updates were performed.
modified_count
Number of documents modified by the update operation. If an updated document is identical to the original, it is not included in this count.
acknowledged?
Returns true if the server acknowledged the result.
upserted_count
Returns the number of documents that were upserted in the database, if the driver performed an upsert.
upserted_ids
Returns the _id value of the document that was upserted in the database, if the driver performed an upsert.
Check the value of the acknowledged? method before you try to call any other Result methods. If the acknowledged? method returns false, the driver throws an InvalidOperation exception if you try to call any other method on the Result object. The driver cannot determine these values if the server does not acknowledge the write operation.
To view runnable code examples that demonstrate how to update documents by using the Ruby driver, see Write Data to MongoDB.
To learn more about any of the methods or types discussed in this guide, see the following API documentation:
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4