Update Documents更新文档

The following example uses the db.collection.updateOne() method on the inventory collection to update the first document where item equals "paper":以下示例在inventory集合上使用db.collection.updateOne()方法来更新第一个项目等于“纸张”的文档：

The following example demonstrates using MongoDB Compass to modify a single document where item: paper in the inventory collection:以下示例演示了如何使用MongoDB Compass修改inventory集合中item:paper所在的单个文档：

The following example uses the IMongoCollection.UpdateOne() method on the inventory collection to update the first document where item equals "paper":以下示例在inventory集合上使用IMongoCollection.UpdateOne()方法来更新第一个item等于"paper"的文档：

The following example uses the Collection.UpdateOne method on the inventory collection to update the first document where item equals "paper":以下示例使用inventory集合上的Collection.UpdateOne方法来更新第一个item等于"paper"的文档：

The following example uses the com.mongodb.reactivestreams.client.MongoCollection.updateOne on the inventory collection to update the first document where item equals "paper":以下示例使用inventory集合上的com.mongodb.reactivestreams.client.MongoCollection.updateOne来更新item等于"paper"的第一个文档：

The following example uses the com.mongodb.client.MongoCollection.updateOne method on the inventory collection to update the first document where item equals "paper":以下示例使用inventory集合上的com.mongodb.client.MongoCollection.updateOne方法来更新第一个item等于"paper"的文档：

The following example uses the MongoCollection.updateOne() method on the inventory collection to update the first document where item equals "paper":以下示例在inventory集合上使用MongoCollection.updateOne()方法来更新item等于"paper"的第一个文档：

The following example uses the update_one method on the inventory collection to update the first document where item equals "paper":以下示例使用inventory集合上的update_one方法更新第一个item等于"paper"的文档：

The following example uses the Collection.updateOne() method on the inventory collection to update the first document where item equals "paper":以下示例使用inventory集合上的Collection.updateOne()方法来更新item等于"paper"的第一个文档：

The following example uses the updateOne() method on the inventory collection to update the first document where item equals "paper":以下示例在inventory集合中使用updateOne()方法更新第一个item等于"paper"的文档：

The following example uses the update_one method on the inventory collection to update the first document where item equals "paper":以下示例使用inventory集合上的update_one方法更新第一个item等于"paper"的文档：

The following example uses the update_one() method on the inventory collection to update the first document where item equals "paper":以下示例使用inventory集合上的update_one()方法来更新item等于"paper"的第一个文档：

The following example uses the updateOne() method on the inventory collection to update the first document where item equals "paper":以下示例在inventory集合中使用updateOne() method on the inventory collection to update the first document where item方法更新第一个item等于"paper"的文档：

db.inventory.updateOne(
   { item: "paper" },
   {
     $set: { "size.uom": "cm", status: "P" },
     $currentDate: { lastModified: true }
   }
)

The update operation:更新操作：

• uses the $set operator to update the value of the size.uom field to "cm" and the value of the status field to "P",使用$set运算符将size.uom字段的值更新为"cm"，将status字段的值修改为"P"，
• uses the $currentDate operator to update the value of the lastModified field to the current date. If lastModified field does not exist, $currentDate will create the field. See $currentDate for details.使用$currentDate运算符将lastModified字段的值更新为当前日期。如果lastModified字段不存在，则$currentDate将创建该字段。有关详细信息，请参阅$currentDate。

Modify the target document as follows:按如下方式修改目标文档：

• Change the status field from D to P.将status字段从D更改为P。
• Change the size.uom field from in to cm.将size.uom字段从in更改为cm。
• Add a new field called lastModified whose value will be today's date.添加一个名为lastModified的新字段，其值将是今天的日期。

1. Click the Table button in the top navigation to access the Table View:单击顶部导航中的“表格”按钮以访问表格视图：

   

2. Use the Compass query bar to locate the target document.使用Compass查询栏定位目标文档。

   Copy the following filter document into the query bar and click Find:将以下筛选文档复制到查询栏中，然后单击“查找”：

   { item: "paper" }

   

3. Hover over the status field and click the pencil icon which appears on the right side of the document to enter edit mode:将鼠标悬停在status字段上，然后单击出现在文档右侧的铅笔图标以进入编辑模式：

   

4. Change the value of the field to "P".将字段的值更改为"P"。
5. Click the Update button below the field to save your changes.单击字段下方的“更新”按钮以保存更改。

6. Hover over the size field and click the outward-pointing arrows which appear on the right side of the field. This opens a new tab which displays the fields within the size object:将鼠标悬停在size字段上，然后单击字段右侧出现的向外指向的箭头。这将打开一个新选项卡，显示size对象中的字段：

   

7. Using the same process outlined in steps 3-5 for editing the status field, change the value of the size.uom field to "cm".使用步骤3-5中概述的编辑status字段的相同过程，将size.uom字段的值更改为"cm"。

8. Click the left-most tab above the table labelled inventory to return to the original table view, which displays the top-level document:单击标记为inventory的表上方最左侧的选项卡，返回原始表视图，显示顶级文档：

   

9. Hover over the status field and click the pencil icon which appears on the right side of the document to re-enter edit mode.将鼠标悬停在status字段上，然后单击出现在文档右侧的铅笔图标以重新进入编辑模式。

10. Click inside of the status field and click the plus button icon which appears in the edit menu.单击status字段内部，然后单击编辑菜单中显示的加号按钮图标。

    Click the Add Field After status button which appears below the plus button:单击加号按钮下方显示的“在status后添加字段”按钮：

    

11. Add a new field called lastModified with a value of today's date. Set the field type to Date:添加一个名为lastModified的新字段，其值为今天的日期。将字段类型设置为Date：

    

12. Click the Update button below the field to save your changes.单击字段下方的“更新”按钮以保存更改。

    Note

    Because MongoDB Compass does not support $currentDate or any other Field Update Operators, you must manually enter the date value in Compass.由于MongoDB Compass不支持$currentDate或任何其他字段更新运算符，您必须在Compass中手动输入日期值。

mongoc_collection_t *collection;
bson_t *selector;
bson_t *update;
bool r;
bson_error_t error;

collection = mongoc_database_get_collection (db, "inventory");
selector = BCON_NEW ("item", BCON_UTF8 ("paper"));
update = BCON_NEW (
   "$set", "{",
   "size.uom", BCON_UTF8 ("cm"),
   "status", BCON_UTF8 ("P"),
   "}",
   "$currentDate", "{",
   "lastModified", BCON_BOOL (true),
   "}");

r = mongoc_collection_update_one(collection, selector, update, NULL, NULL, &error);
bson_destroy (selector);
bson_destroy (update);

if (!r) {
   MONGOC_ERROR ("%s\n", error.message);
   goto done;
}

var filter = Builders<BsonDocument>.Filter.Eq("item", "paper");
var update = Builders<BsonDocument>.Update.Set("size.uom", "cm").Set("status", "P").CurrentDate("lastModified");
var result = collection.UpdateOne(filter, update);

The update operation:更新操作：

• uses the $set operator to update the value of the size.uom field to "cm" and the value of the status field to "P",使用$set运算符将size.uom字段的值更新为"cm"，将status字段的值修改为"P"，
• uses the $currentDate operator to update the value of the lastModified field to the current date. 使用$currentDate运算符将lastModified字段的值更新为当前日期。If lastModified field does not exist, $currentDate will create the field. 如果lastModified字段不存在，则$currentDate将创建该字段。See $currentDate for details.有关详细信息，请参阅$currentDate。

result, err := coll.UpdateOne(
	context.TODO(),
	bson.D{
		{"item", "paper"},
	},
	bson.D{
		{"$set", bson.D{
			{"size.uom", "cm"},
			{"status", "P"},
		}},
		{"$currentDate", bson.D{
			{"lastModified", true},
		}},
	},
)

The update operation:更新操作：

• uses the $set operator to update the value of the size.uom field to "cm" and the value of the status field to "P",使用$set运算符将size.uom字段的值更新为"cm"，将状态字段的值修改为"P"，
• uses the $currentDate operator to update the value of the lastModified field to the current date. 使用$currentDate运算符将lastModified字段的值更新为当前日期。If lastModified field does not exist, $currentDate will create the field. 如果lastModified字段不存在，则$currentDate将创建该字段。See $currentDate for details.有关详细信息，请参阅$currentDate。

Publisher<UpdateResult> updateOnePublisher = collection.updateOne(eq("item", "paper"),
        combine(set("size.uom", "cm"), set("status", "P"), currentDate("lastModified")));

The update operation:更新操作：

• uses the $set operator to update the value of the size.uom field to "cm" and the value of the status field to "P",使用$set运算符将size.uom字段的值更新为"cm"，将status字段的值修改为"P"，
• uses the $currentDate operator to update the value of the lastModified field to the current date. 使用$currentDate运算符将lastModified字段的值更新为当前日期。If lastModified field does not exist, $currentDate will create the field. See $currentDate for details.如果lastModified字段不存在，则$currentDate将创建该字段。有关详细信息，请参阅$currentDate。

collection.updateOne(eq("item", "paper"),
        combine(set("size.uom", "cm"), set("status", "P"), currentDate("lastModified")));

The update operation:更新操作：

• uses the $set operator to update the value of the size.uom field to "cm" and the value of the status field to "P",使用$set运算符将size.uom字段的值更新为"cm"，将status字段的值修改为"P"，
• uses the $currentDate operator to update the value of the lastModified field to the current date. 使用$currentDate运算符将lastModified字段的值更新为当前日期。If lastModified field does not exist, $currentDate will create the field. 如果lastModified字段不存在，则$currentDate将创建该字段。See $currentDate for details.有关详细信息，请参阅$currentDate。

collection.updateOne(eq("item", "paper"),
    combine(set("size.uom", "cm"), set("status", "P"), currentDate("lastModified")));

The update operation:更新操作：

• uses the $set operator to update the value of the size.uom field to "cm" and the value of the status field to "P",使用$set运算符将size.uom字段的值更新为"cm"，将status字段的值修改为"P"，
• uses the $currentDate operator to update the value of the lastModified field to the current date. 使用$currentDate运算符将lastModified字段的值更新为当前日期。If lastModified field does not exist, $currentDate will create the field. 如果lastModified字段不存在，则$currentDate将创建该字段。See $currentDate for details.有关详细信息，请参阅$currentDate。

await db.inventory.update_one(
    {"item": "paper"},
    {"$set": {"size.uom": "cm", "status": "P"}, "$currentDate": {"lastModified": True}},
)

The update operation:更新操作：

• uses the $set operator to update the value of the size.uom field to "cm" and the value of the status field to "P",使用$set运算符将size.uom字段的值更新为"cm"，将status字段的值修改为"P"，
• uses the $currentDate operator to update the value of the lastModified field to the current date. 使用$currentDate运算符将lastModified字段的值更新为当前日期。If lastModified field does not exist, $currentDate will create the field. 如果lastModified字段不存在，则$currentDate将创建该字段。See $currentDate for details.有关详细信息，请参阅$currentDate。

await db.collection('inventory').updateOne(
  { item: 'paper' },
  {
    $set: { 'size.uom': 'cm', status: 'P' },
    $currentDate: { lastModified: true }
  }
);

The update operation:更新操作：

• uses the $set operator to update the value of the size.uom field to "cm" and the value of the status field to "P",使用$set运算符将size.uom字段的值更新为"cm"，将status字段的值修改为"P"，
• uses the $currentDate operator to update the value of the lastModified field to the current date. 使用$currentDate运算符将lastModified字段的值更新为当前日期。If lastModified field does not exist, $currentDate will create the field. 如果lastModified字段不存在，则$currentDate将创建该字段。See $currentDate for details.有关详细信息，请参阅$currentDate。

$updateResult = $db->inventory->updateOne(
    ['item' => 'paper'],
    [
        '$set' => ['size.uom' => 'cm', 'status' => 'P'],
        '$currentDate' => ['lastModified' => true],
    ],
);

The update operation:更新操作：

• uses the $set operator to update the value of the size.uom field to "cm" and the value of the status field to "P",使用$set运算符将size.uom字段的值更新为"cm"，将status字段的值修改为"P"，
• uses the $currentDate operator to update the value of the lastModified field to the current date. 使用$currentDate运算符将lastModified字段的值更新为当前日期。If lastModified field does not exist, $currentDate will create the field. 如果lastModified字段不存在，则$currentDate将创建该字段。See $currentDate for details.有关详细信息，请参阅$currentDate。

db.inventory.update_one(
    {"item": "paper"},
    {"$set": {"size.uom": "cm", "status": "P"}, "$currentDate": {"lastModified": True}},
)

client[:inventory].update_one({ item: 'paper'},
                              { '$set' => { 'size.uom' => 'cm', 'status' => 'P' },
                                '$currentDate' => { 'lastModified' => true } })

The update operation:更新操作：

• uses the $set operator to update the value of the size.uom field to "cm" and the value of the status field to "P",使用$set运算符将size.uom字段的值更新为"cm"，将status字段的值修改为"P"，
• uses the $currentDate operator to update the value of the lastModified field to the current date. 使用$currentDate运算符将lastModified字段的值更新为当前日期。If lastModified field does not exist, $currentDate will create the field. 如果lastModified字段不存在，则$currentDate将创建该字段。See $currentDate for details.有关详细信息，请参阅$currentDate。

collection.updateOne(equal("item", "paper"),
  combine(set("size.uom", "cm"), set("status", "P"), currentDate("lastModified"))
).execute()

The update operation:更新操作：

• uses the $set operator to update the value of the size.uom field to "cm" and the value of the status field to "P",使用$set运算符将size.uom字段的值更新为"cm"，将status字段的值修改为"P"，
• uses the $currentDate operator to update the value of the lastModified field to the current date. 使用$currentDate运算符将lastModified字段的值更新为当前日期。If lastModified field does not exist, $currentDate will create the field. 如果lastModified字段不存在，则$currentDate将创建该字段。See $currentDate for details.有关详细信息，请参阅$currentDate。

The following example uses the db.collection.updateMany() method on the inventory collection to update all documents where qty is less than 50:以下示例在inventory集合上使用db.collection.updateMany()方法来更新所有qty小于50的文档：

You can update only one document at a time in MongoDB Compass. To update multiple documents, connect to your MongoDB deployment from mongosh or a MongoDB driver and follow the examples in this section for your preferred method.在MongoDB Compass中，一次只能更新一个文档。要更新多个文档，请从mongosh或MongoDB驱动程序连接到MongoDB部署，并按照本节中的示例选择首选方法。

The following example uses the IMongoCollection.UpdateMany() method on the inventory collection to update all documents where qty is less than 50:以下示例在inventory集合上使用IMongoCollection.UpdateMany()方法来更新所有qty小于50的文档：

The following example uses the Collection.UpdateMany method on the inventory collection to update all documents where qty is less than 50:以下示例使用inventory集合上的Collection.UpdateMany方法来更新qty小于50的所有文档：

The following example uses the com.mongodb.reactivestreams.client.MongoCollection.updateMany method on the inventory collection to update all documents where qty is less than 50:以下示例使用inventory集合上的com.mongodb.reactivestreams.client.MongoCollection.updateMany方法更新所有qty小于50的文档：

The following example uses the com.mongodb.client.MongoCollection.updateMany method on the inventory collection to update all documents where qty is less than 50:以下示例使用inventory集合上的com.mongodb.client.MongoCollection.updateMany方法更新所有qty小于50的文档：

The following example uses the MongoCollection.updateMany() method on the inventory collection to update all documents where qty is less than 50:以下示例在inventory集合上使用MongoCollection.updateMany()方法来更新所有qty小于50的文档：

The following example uses the update_many method on the inventory collection to update all documents where qty is less than 50:以下示例使用inventory集合上的update_many方法更新所有qty小于50的文档：

The following example uses the Collection.updateMany() method on the inventory collection to update all documents where qty is less than 50:以下示例使用inventory集合上的Collection.updateMany()方法来更新所有qty小于50的文档：

The following example uses the updateMany() method on the inventory collection to update all documents where qty is less than 50:以下示例在inventory集合中使用updateMany()方法来更新所有qty小于50的文档：

The following example uses the update_many method on the inventory collection to update all documents where qty is less than 50:以下示例使用inventory集合上的update_many方法更新所有qty小于50的文档：

The following example uses the update_many() method on the inventory collection to update all documents where qty is less than 50:以下示例使用inventory集合上的update_many()方法更新所有qty小于50的文档：

The following example uses the updateMany() method on the inventory collection to update all documents where qty is less than 50:以下示例在inventory集合中使用updateMany()方法来更新所有qty小于50的文档：

db.inventory.updateMany(
   { "qty": { $lt: 50 } },
   {
     $set: { "size.uom": "in", status: "P" },
     $currentDate: { lastModified: true }
   }
)

The update operation:更新操作：

• uses the $set operator to update the value of the size.uom field to "in" and the value of the status field to "P",使用$set运算符将size.uom字段的值更新为"in"，将status字段的值修改为"P"，
• uses the $currentDate operator to update the value of the lastModified field to the current date. 使用$currentDate运算符将lastModified字段的值更新为当前日期。If lastModified field does not exist, $currentDate will create the field. 如果lastModified字段不存在，则$currentDate将创建该字段。See $currentDate for details.有关详细信息，请参阅$currentDate。

mongoc_collection_t *collection;
bson_t *selector;
bson_t *update;
bool r;
bson_error_t error;

collection = mongoc_database_get_collection (db, "inventory");
selector = BCON_NEW (
   "qty", "{",
   "$lt", BCON_INT64 (50),
   "}");
update = BCON_NEW (
   "$set", "{",
   "size.uom", BCON_UTF8 ("in"),
   "status", BCON_UTF8 ("P"),
   "}",
   "$currentDate", "{",
   "lastModified", BCON_BOOL (true),
   "}");

r = mongoc_collection_update_many(collection, selector, update, NULL, NULL, &error);
bson_destroy (selector);
bson_destroy (update);

if (!r) {
   MONGOC_ERROR ("%s\n", error.message);
   goto done;
}

var filter = Builders<BsonDocument>.Filter.Lt("qty", 50);
var update = Builders<BsonDocument>.Update.Set("size.uom", "in").Set("status", "P").CurrentDate("lastModified");
var result = collection.UpdateMany(filter, update);

The update operation:更新操作：

• uses the $set operator to update the value of the size.uom field to "in" and the value of the status field to "P",使用$set运算符将size.uom字段的值更新为"in"，将status字段的值修改为"P"，
• uses the $currentDate operator to update the value of the lastModified field to the current date. 使用$currentDate运算符将lastModified字段的值更新为当前日期。If lastModified field does not exist, $currentDate will create the field. 如果lastModified字段不存在，则$currentDate将创建该字段。See $currentDate for details.有关详细信息，请参阅$currentDate。

result, err := coll.UpdateMany(
	context.TODO(),
	bson.D{
		{"qty", bson.D{
			{"$lt", 50},
		}},
	},
	bson.D{
		{"$set", bson.D{
			{"size.uom", "cm"},
			{"status", "P"},
		}},
		{"$currentDate", bson.D{
			{"lastModified", true},
		}},
	},
)

The update operation:更新操作：

• uses the $set operator to update the value of the size.uom field to "in" and the value of the status field to "P",使用$set运算符将size.uom字段的值更新为"in"，将status字段的值修改为"P"，
• uses the $currentDate operator to update the value of the lastModified field to the current date. 使用$currentDate运算符将lastModified字段的值更新为当前日期。If lastModified field does not exist, $currentDate will create the field. 如果lastModified字段不存在，则$currentDate将创建该字段。See $currentDate for details.有关详细信息，请参阅$currentDate。

Publisher<UpdateResult> updateManyPublisher = collection.updateMany(lt("qty", 50),
        combine(set("size.uom", "in"), set("status", "P"), currentDate("lastModified")));

The update operation:更新操作：

• uses the $set operator to update the value of the size.uom field to "in" and the value of the status field to "P",使用$set运算符将size.uom字段的值更新为"in"，将status字段的值修改为"P"，
• uses the $currentDate operator to update the value of the lastModified field to the current date. 使用$currentDate运算符将lastModified字段的值更新为当前日期。If lastModified field does not exist, $currentDate will create the field. 如果lastModified字段不存在，则$currentDate将创建该字段。See $currentDate for details.有关详细信息，请参阅$currentDate。

collection.updateMany(lt("qty", 50),
        combine(set("size.uom", "in"), set("status", "P"), currentDate("lastModified")));

The update operation:更新操作：

• uses the $set operator to update the value of the size.uom field to "in" and the value of the status field to "P",使用$set运算符将size.uom字段的值更新为"in"，将status字段的值修改为"P"，
• uses the $currentDate operator to update the value of the lastModified field to the current date. 使用$currentDate运算符将lastModified字段的值更新为当前日期。If lastModified field does not exist, $currentDate will create the field. 如果lastModified字段不存在，则$currentDate将创建该字段。See $currentDate for details.有关详细信息，请参阅$currentDate。

collection.updateOne(eq("item", "paper"),
    combine(set("size.uom", "cm"), set("status", "P"), currentDate("lastModified")));

The update operation:更新操作：

• uses the $set operator to update the value of the size.uom field to "in" and the value of the status field to "P",使用$set运算符将size.uom字段的值更新为"in"，将status字段的值修改为"P"，
• uses the $currentDate operator to update the value of the lastModified field to the current date. 使用$currentDate运算符将lastModified字段的值更新为当前日期。If lastModified field does not exist, $currentDate will create the field. 如果lastModified字段不存在，则$currentDate将创建该字段。See $currentDate for details.有关详细信息，请参阅$currentDate。

await db.inventory.update_many(
    {"qty": {"$lt": 50}},
    {"$set": {"size.uom": "in", "status": "P"}, "$currentDate": {"lastModified": True}},
)

The update operation:更新操作：

• uses the $set operator to update the value of the size.uom field to "in" and the value of the status field to "P",使用$set运算符将size.uom字段的值更新为"in"，将status字段的值修改为"P"，
• uses the $currentDate operator to update the value of the lastModified field to the current date. 使用$currentDate运算符将lastModified字段的值更新为当前日期。If lastModified field does not exist, $currentDate will create the field. 如果lastModified字段不存在，则$currentDate将创建该字段。See $currentDate for details.有关详细信息，请参阅$currentDate。

await db.collection('inventory').updateMany(
  { qty: { $lt: 50 } },
  {
    $set: { 'size.uom': 'in', status: 'P' },
    $currentDate: { lastModified: true }
  }
);

The update operation:更新操作：

• uses the $set operator to update the value of the size.uom field to "in" and the value of the status field to "P",使用$set运算符将size.uom字段的值更新为"in"，将status字段的值修改为"P"，
• uses the $currentDate operator to update the value of the lastModified field to the current date. 使用$currentDate运算符将lastModified字段的值更新为当前日期。If lastModified field does not exist, $currentDate will create the field. 如果lastModified字段不存在，则$currentDate将创建该字段。See $currentDate for details.有关详细信息，请参阅$currentDate。

$updateResult = $db->inventory->updateMany(
    ['qty' => ['$lt' => 50]],
    [
        '$set' => ['size.uom' => 'cm', 'status' => 'P'],
        '$currentDate' => ['lastModified' => true],
    ],
);

The update operation:更新操作：

• uses the $set operator to update the value of the size.uom field to "in" and the value of the status field to "P",使用$set运算符将size.uom字段的值更新为"in"，将status字段的值修改为"P"，
• uses the $currentDate operator to update the value of the lastModified field to the current date. 使用$currentDate运算符将lastModified字段的值更新为当前日期。If lastModified field does not exist, $currentDate will create the field. 如果lastModified字段不存在，则$currentDate将创建该字段。See $currentDate for details.有关详细信息，请参阅$currentDate。

db.inventory.update_many(
    {"qty": {"$lt": 50}},
    {"$set": {"size.uom": "in", "status": "P"}, "$currentDate": {"lastModified": True}},
)

client[:inventory].update_many({ qty: { '$lt' => 50 } },
                              { '$set' => { 'size.uom' => 'in', 'status' => 'P' },
                                '$currentDate' => { 'lastModified' => true } })

The update operation:更新操作：

• uses the $set operator to update the value of the size.uom field to "in" and the value of the status field to "P",使用$set运算符将size.uom字段的值更新为"in"，将status字段的值修改为"P"，
• uses the $currentDate operator to update the value of the lastModified field to the current date. 使用$currentDate运算符将lastModified字段的值更新为当前日期。If lastModified field does not exist, $currentDate will create the field. 如果lastModified字段不存在，则$currentDate将创建该字段。See $currentDate for details.有关详细信息，请参阅$currentDate。

collection.updateMany(lt("qty", 50),
  combine(set("size.uom", "in"), set("status", "P"), currentDate("lastModified"))
).execute()

The update operation:更新操作：

• uses the $set operator to update the value of the size.uom field to "in" and the value of the status field to "P",使用$set运算符将size.uom字段的值更新为"in"，将status字段的值修改为"P"，
• uses the $currentDate operator to update the value of the lastModified field to the current date. 使用$currentDate运算符将lastModified字段的值更新为当前日期。If lastModified field does not exist, $currentDate will create the field. 如果lastModified字段不存在，则$currentDate将创建该字段。See $currentDate for details.有关详细信息，请参阅$currentDate。

To replace the entire content of a document except for the _id field, pass an entirely new document as the second argument to db.collection.replaceOne().要替换文档中除_id字段外的全部内容，请将一个全新的文档作为第二个参数传递给db.collection.replaceOne()。

When replacing a document, the replacement document must consist of only field/value pairs. The replacement document cannot include update operators expressions.替换文档时，替换文档必须仅包含字段/值对。替换文档不能包含更新运算符表达式。

The replacement document can have different fields from the original document. In the replacement document, you can omit the _id field since the _id field is immutable. However, if you do include the _id field, it must have the same value as the current value.替换文档可以具有与原始文档不同的字段。在替换文档中，您可以省略_id字段，因为_id字段是不可变的。但是，如果您确实包含_id字段，则它必须具有与当前值相同的值。

The following example replaces the first document from the inventory collection where item: "paper":以下示例替换了inventory集合中item: "paper"的第一个文档：

You can't replace a document in MongoDB Compass. To replace a document, connect to your MongoDB deployment from mongosh or a MongoDB driver and follow the examples in this section for your preferred method.您无法在MongoDB Compass中替换文档。要替换文档，请从mongosh或MongoDB驱动程序连接到MongoDB部署，并按照本节中的示例选择您喜欢的方法。

To replace the entire content of a document except for the _id field, pass an entirely new document as the second argument to IMongoCollection.ReplaceOne().要替换文档中除_id字段外的全部内容，请将一个全新的文档作为第二个参数传递给IMongoCollection.ReplaceOne()。

When replacing a document, the replacement document must consist of only field/value pairs. The replacement document cannot include update operators expressions.替换文档时，替换文档必须仅包含字段/值对。替换文档不能包含更新运算符表达式。

The replacement document can have different fields from the original document. In the replacement document, you can omit the _id field since the _id field is immutable. However, if you do include the _id field, it must have the same value as the current value.替换文档可以具有与原始文档不同的字段。在替换文档中，您可以省略_id字段，因为_id字段是不可变的。但是，如果您确实包含_id字段，则它必须具有与当前值相同的值。

The following example replaces the first document from the inventory collection where item: "paper":以下示例替换了inventory集合中item: "paper"的第一个文档：

To replace the entire content of a document except for the _id field, pass an entirely new document as the second argument to Collection.ReplaceOne.要替换文档中除_id字段外的全部内容，请将一个全新的文档作为第二个参数传递给Collection.ReplaceOne。

When replacing a document, the replacement document must consist of only field/value pairs. The replacement document cannot include update operators expressions.替换文档时，替换文档必须仅包含字段/值对。替换文档不能包含更新运算符表达式。

The replacement document can have different fields from the original document. In the replacement document, you can omit the _id field since the _id field is immutable. However, if you do include the _id field, it must have the same value as the current value.替换文档可以具有与原始文档不同的字段。在替换文档中，您可以省略_id字段，因为_id字段是不可变的。但是，如果您确实包含_id字段，则它必须具有与当前值相同的值。

The following example replaces the first document from the inventory collection where item: "paper":以下示例替换了inventory集合中item: "paper"的第一个文档：

To replace the entire content of a document except for the _id field, pass an entirely new document as the second argument to com.mongodb.reactivestreams.client.MongoCollection.replaceOne.要替换文档中除_id字段外的全部内容，请将一个全新的文档作为第二个参数传递给com.mongodb.reactivestreams.client.MongoCollection.replaceOne。

When replacing a document, the replacement document must consist of only field/value pairs. The replacement document cannot include update operators expressions.替换文档时，替换文档必须仅包含字段/值对。替换文档不能包含更新运算符表达式。

The replacement document can have different fields from the original document. In the replacement document, you can omit the _id field since the _id field is immutable. However, if you do include the _id field, it must have the same value as the current value.替换文档可以具有与原始文档不同的字段。在替换文档中，您可以省略_id字段，因为_id字段是不可变的。但是，如果您确实包含_id字段，则它必须具有与当前值相同的值。

The following example replaces the first document from the inventory collection where item: "paper":以下示例替换了inventory集合中item: "paper"的第一个文档：

To replace the entire content of a document except for the _id field, pass an entirely new document as the second argument to com.mongodb.client.MongoCollection.replaceOne.要替换文档中除_id字段外的全部内容，请将一个全新的文档作为第二个参数传递给com.mongodb.client.MongoCollection.replaceOne。

When replacing a document, the replacement document must consist of only field/value pairs. The replacement document cannot include update operators expressions.替换文档时，替换文档必须仅包含字段/值对。替换文档不能包含更新运算符表达式。

The replacement document can have different fields from the original document. In the replacement document, you can omit the _id field since the _id field is immutable. 替换文档可以具有与原始文档不同的字段。在替换文档中，您可以省略_id字段，因为_id字段是不可变的。However, if you do include the _id field, it must have the same value as the current value.但是，如果您确实包含_id字段，则它必须具有与当前值相同的值。

The following example replaces the first document from the inventory collection where item: "paper":以下示例替换了inventory集合中item: "paper"的第一个文档：

To replace the entire content of a document except for the _id field, pass an entirely new document as the second argument to the MongoCollection.replaceOne() method.要替换文档中除_id字段外的全部内容，请将一个全新的文档作为第二个参数传递给MongoCollection.replaceOne()方法。

When replacing a document, the replacement document must consist of only field/value pairs. The replacement document cannot include update operators expressions.替换文档时，替换文档必须仅包含字段/值对。替换文档不能包含更新运算符表达式。

The replacement document can have different fields from the original document. In the replacement document, you can omit the _id field since the _id field is immutable. 替换文档可以具有与原始文档不同的字段。在替换文档中，您可以省略_id字段，因为_id字段是不可变的。However, if you do include the _id field, it must have the same value as the current value.但是，如果您确实包含_id字段，则它必须具有与当前值相同的值。

The following example replaces the first document from the inventory collection where item: "paper":以下示例替换了inventory集合中item: "paper"的第一个文档：

To replace the entire content of a document except for the _id field, pass an entirely new document as the second argument to replace_one.要替换文档中除_id字段外的全部内容，请传递一个全新的文档作为replace_one的第二个参数。

When replacing a document, the replacement document must consist of only field/value pairs. The replacement document cannot include update operators expressions.替换文档时，替换文档必须仅包含字段/值对。替换文档不能包含更新运算符表达式。

The replacement document can have different fields from the original document. In the replacement document, you can omit the _id field since the _id field is immutable. However, if you do include the _id field, it must have the same value as the current value.替换文档可以具有与原始文档不同的字段。在替换文档中，您可以省略_id字段，因为_id字段是不可变的。但是，如果您确实包含_id字段，则它必须具有与当前值相同的值。

The following example replaces the first document from the inventory collection where item: "paper":以下示例替换了inventory集合中item: "paper"的第一个文档：

To replace the entire content of a document except for the _id field, pass an entirely new document as the second argument to Collection.replaceOne().要替换文档中除_id字段外的全部内容，请将一个全新的文档作为第二个参数传递给Collection.replaceOne()。

When replacing a document, the replacement document must consist of only field/value pairs. The replacement document cannot include update operators expressions.替换文档时，替换文档必须仅包含字段/值对。替换文档不能包含更新运算符表达式。

The replacement document can have different fields from the original document. In the replacement document, you can omit the _id field since the _id field is immutable. However, if you do include the _id field, it must have the same value as the current value.<替换文档可以具有与原始文档不同的字段。在替换文档中，您可以省略_id字段，因为_id字段是不可变的。但是，如果您确实包含_id字段，则它必须具有与当前值相同的值</p>

The following example replaces the first document from the inventory collection where item: "paper":以下示例替换了inventory集合中item: "paper"的第一个文档：

To replace the entire content of a document except for the _id field, pass an entirely new document as the second argument to replaceOne().要替换文档中除_id字段外的全部内容，请传递一个全新的文档作为replaceOne()的第二个参数。

When replacing a document, the replacement document must consist of only field/value pairs. The replacement document cannot include update operators expressions.替换文档时，替换文档必须仅包含字段/值对。替换文档不能包含更新运算符表达式。

The replacement document can have different fields from the original document. In the replacement document, you can omit the _id field since the _id field is immutable. 替换文档可以具有与原始文档不同的字段。在替换文档中，您可以省略_id字段，因为_id字段是不可变的。However, if you do include the _id field, it must have the same value as the current value.但是，如果您确实包含_id字段，则它必须具有与当前值相同的值。

The following example replaces the first document from the inventory collection where item: "paper":以下示例替换了inventory集合中item: "paper"的第一个文档：

To replace the entire content of a document except for the _id field, pass an entirely new document as the second argument to replace_one.要替换文档中除_id字段外的全部内容，请传递一个全新的文档作为replace_one的第二个参数。

When replacing a document, the replacement document must consist of only field/value pairs. The replacement document cannot include update operators expressions.替换文档时，替换文档必须仅包含字段/值对。替换文档不能包含更新运算符表达式。

The replacement document can have different fields from the original document. In the replacement document, you can omit the _id field since the _id field is immutable. 替换文档可以具有与原始文档不同的字段。在替换文档中，您可以省略_id字段，因为_id字段是不可变的。However, if you do include the _id field, it must have the same value as the current value.但是，如果您确实包含_id字段，则它必须具有与当前值相同的值。

The following example replaces the first document from the inventory collection where item: "paper":以下示例替换了inventory集合中item: "paper"的第一个文档：

To replace the entire content of a document except for the _id field, pass an entirely new document as the second argument to replace_one().要替换文档中除_id字段外的全部内容，请将一个全新的文档作为replace_one()的第二个参数传递。

When replacing a document, the replacement document must consist of only field/value pairs. The replacement document cannot include update operators expressions.替换文档时，替换文档必须仅包含字段/值对。替换文档不能包含更新运算符表达式。

The replacement document can have different fields from the original document. In the replacement document, you can omit the _id field since the _id field is immutable. 替换文档可以具有与原始文档不同的字段。在替换文档中，您可以省略_id字段，因为_id字段是不可变的。However, if you do include the _id field, it must have the same value as the current value.但是，如果您确实包含_id字段，则它必须具有与当前值相同的值。

The following example replaces the first document from the inventory collection where item: "paper":以下示例替换了inventory集合中item: "paper"的第一个文档：

To replace the entire content of a document except for the _id field, pass an entirely new document as the second argument to replaceOne()要替换文档中除_id字段外的全部内容，请传递一个全新的文档作为replaceOne()的第二个参数

When replacing a document, the replacement document must consist of only field/value pairs. The replacement document cannot include update operators expressions.替换文档时，替换文档必须仅包含字段/值对。替换文档不能包含更新运算符表达式。

The replacement document can have different fields from the original document. In the replacement document, you can omit the _id field since the _id field is immutable. However, if you do include the _id field, it must have the same value as the current value.替换文档可以具有与原始文档不同的字段。在替换文档中，您可以省略_id字段，因为_id字段是不可变的。但是，如果您确实包含_id字段，则它必须具有与当前值相同的值。

The following example replaces the first document from the inventory collection where item: "paper":以下示例替换了inventory集合中item: "paper"的第一个文档：

db.inventory.replaceOne(
   { item: "paper" },
   { item: "paper", instock: [ { warehouse: "A", qty: 60 }, { warehouse: "B", qty: 40 } ] }
)

mongoc_collection_t *collection;
bson_t *selector;
bson_t *replacement;
bool r;
bson_error_t error;

collection = mongoc_database_get_collection (db, "inventory");
selector = BCON_NEW ("item", BCON_UTF8 ("paper"));
replacement = BCON_NEW (
   "item", BCON_UTF8 ("paper"),
   "instock", "[",
   "{",
   "warehouse", BCON_UTF8 ("A"),
   "qty", BCON_INT64 (60),
   "}","{",
   "warehouse", BCON_UTF8 ("B"),
   "qty", BCON_INT64 (40),
   "}",
   "]");

/* MONGOC_UPDATE_NONE means "no special options" */
r = mongoc_collection_replace_one(collection, selector, replacement, NULL, NULL, &error);
bson_destroy (selector);
bson_destroy (replacement);

if (!r) {
   MONGOC_ERROR ("%s\n", error.message);
   goto done;
}

Be sure to also clean up any open resources by calling the following methods, as appropriate:请确保根据需要调用以下方法来清理任何开放资源：

• bson_destroy
• mongoc_bulk_operation_destroy
• mongoc_collection_destroy
• mongoc_cursor_destroy,

var filter = Builders<BsonDocument>.Filter.Eq("item", "paper");
var replacement = new BsonDocument
{
    { "item", "paper" },
    { "instock", new BsonArray
        {
            new BsonDocument { { "warehouse", "A" }, { "qty", 60 } },
            new BsonDocument { { "warehouse", "B" }, { "qty", 40 } } }
        }
};
var result = collection.ReplaceOne(filter, replacement);

result, err := coll.ReplaceOne(
	context.TODO(),
	bson.D{
		{"item", "paper"},
	},
	bson.D{
		{"item", "paper"},
		{"instock", bson.A{
			bson.D{
				{"warehouse", "A"},
				{"qty", 60},
			},
			bson.D{
				{"warehouse", "B"},
				{"qty", 40},
			},
		}},
	},
)

Publisher<UpdateResult> replaceOnePublisher = collection.replaceOne(eq("item", "paper"),
        Document.parse("{ item: 'paper', instock: [ { warehouse: 'A', qty: 60 }, { warehouse: 'B', qty: 40 } ] }"));

collection.replaceOne(eq("item", "paper"),
        Document.parse("{ item: 'paper', instock: [ { warehouse: 'A', qty: 60 }, { warehouse: 'B', qty: 40 } ] }"));

collection.replaceOne(eq("item", "paper"),
    Document.parse("{ item: 'paper', instock: [ { warehouse: 'A', qty: 60 }, { warehouse: 'B', qty: 40 } ] }"));

await db.inventory.replace_one(
    {"item": "paper"},
    {
        "item": "paper",
        "instock": [{"warehouse": "A", "qty": 60}, {"warehouse": "B", "qty": 40}],
    },
)

await db.collection('inventory').replaceOne(
  { item: 'paper' },
  {
    item: 'paper',
    instock: [
      { warehouse: 'A', qty: 60 },
      { warehouse: 'B', qty: 40 }
    ]
  }
);

$updateResult = $db->inventory->replaceOne(
    ['item' => 'paper'],
    [
        'item' => 'paper',
        'instock' => [
            ['warehouse' => 'A', 'qty' => 60],
            ['warehouse' => 'B', 'qty' => 40],
        ],
    ],
);

db.inventory.replace_one(
    {"item": "paper"},
    {
        "item": "paper",
        "instock": [{"warehouse": "A", "qty": 60}, {"warehouse": "B", "qty": 40}],
    },
)

client[:inventory].replace_one({ item: 'paper' },
                               { item: 'paper',
                                 instock: [ { warehouse: 'A', qty: 60 },
                                            { warehouse: 'B', qty: 40 } ] })

collection.replaceOne(equal("item", "paper"),
  Document("""{ item: "paper", instock: [ { warehouse: "A", qty: 60 }, { warehouse: "B", qty: 40 } ] }""")
).execute()

If updateOne(), updateMany(), or replaceOne() includes upsert : true and no documents match the specified filter, then the operation creates a new document and inserts it. 如果updateOne()、updateMany()或replaceOne()包含upsert:true，并且没有文档与指定的筛选器匹配，则该操作将创建一个新文档并插入它。If there are matching documents, then the operation modifies or replaces the matching document or documents.如果有匹配的文档，则操作会修改或替换匹配的文档。

For details on the new document created, see the individual reference pages for the methods.有关创建的新文档的详细信息，请参阅方法的各个参考页。

The upsert option is not available through MongoDB Compass.MongoDB Compass不提供追加销售选项。

If UpdateOne(), UpdateMany(), or ReplaceOne() includes an UpdateOptions argument instance with the IsUpsert option set to true and no documents match the specified filter, then the operation creates a new document and inserts it. If there are matching documents, then the operation modifies or replaces the matching document or documents.如果有匹配的文档，则操作会修改或替换匹配的文档。

For details on the new document created, see the individual reference pages for the methods.有关创建的新文档的详细信息，请参阅方法的各个参考页。

If Collection.UpdateOne includes the Upsert option set to true and no documents match the specified filter, then the operation creates a new document and inserts it. If there are matching documents, then the operation modifies or replaces the matching document or documents.

For details on the new document created, see the individual reference pages for the methods.如果有匹配的文档，则该操作会修改或替换匹配的文档。有关创建的新文档的详细信息，请参阅各个参考页面中的方法。

If the update and replace methods include the UpdateOptions parameter that specifies UpdateOptions.upsert(true) and no documents match the specified filter, then the operation creates a new document and inserts it. If there are matching documents, then the operation modifies or replaces the matching document or documents.如果更新和替换方法包含指定UpdateOptions.upsert(true)的>UpdateOptions参数，并且没有文档与指定的筛选器匹配，则该操作将创建一个新文档并插入它。如果有匹配的文档，则该操作用于修改或替换匹配的一个或多个文档。

For details on the new document created, see the individual reference pages for the methods.有关创建的新文档的详细信息，请参阅方法的各个参考页。

If the update and replace methods include the com.mongodb.client.model.UpdateOptions parameter that specifies com.mongodb.client.model.UpdateOptions.upsert(true) and no documents match the specified filter, then the operation creates a new document and inserts it. If there are matching documents, then the operation modifies or replaces the matching document or documents.如果更新和替换方法包括指定com.mongodb.client.model.UpdateOptions.upsert(true)的com.mongodb.client.model.UpdateOptions参数，并且没有文档与指定的筛选器匹配，则该操作将创建一个新文档并插入它。如果有匹配的文档，则该操作将修改或替换匹配的文档。

For details on the new document created, see the individual reference pages for the methods.有关创建的新文档的详细信息，请参阅方法的各个参考页。

If the update and replace methods include the com.mongodb.client.model.UpdateOptions parameter that specifies upsert(true), and no documents match the specified filter, then the operation creates a new document and inserts it. 如果更新和替换方法包含指定upsert(true)的com.mongodb.client.model.UpdateOptions参数，并且没有文档与指定的筛选器匹配，则该操作将创建一个新文档并插入它。If there are matching documents, then the operation modifies or replaces the matching document or documents.如果有匹配的文档，则操作会修改或替换匹配的文档。

For details on the new document created, see the individual reference pages for the methods.有关创建的新文档的详细信息，请参阅方法的各个参考页。

If update_one, update_many, or replace_one includes upsert : true and no documents match the specified filter, then the operation creates a new document and inserts it. If there are matching documents, then the operation modifies or replaces the matching document or documents.如果update_one、update_many或replace_one包含upsert:true，并且没有文档与指定的筛选器匹配，则操作将创建一个新文档并插入它。如果有匹配的文档，则操作会修改或替换匹配的文档。

For details on the new document created, see the individual reference pages for the methods.有关创建的新文档的详细信息，请参阅方法的各个参考页。

If updateOne(), updateMany(), or replaceOne() include upsert : true in the options parameter document and no documents match the specified filter, then the operation creates a new document and inserts it. 如果updateOne()、updateMany()或replaceOne()在options参数文档中包含upsert:true，并且没有文档与指定的筛选器匹配，则该操作将创建一个新文档并插入它。If there are matching documents, then the operation modifies or replaces the matching document or documents.如果有匹配的文档，则操作会修改或替换匹配的文档。

For details on the new document created, see the individual reference pages for the methods.有关创建的新文档的详细信息，请参阅方法的各个参考页。

If updateOne(), updateMany(), or replaceOne() includes upsert => true and no documents match the specified filter, then the operation creates a new document and inserts it. 如果updateOne()、updateMany()或replaceOne()包含upstart=>true，并且没有文档与指定的筛选器匹配，则该操作将创建一个新文档并插入它。If there are matching documents, then the operation modifies or replaces the matching document or documents.如果有匹配的文档，则操作会修改或替换匹配的文档。

For details on the new document created, see the individual reference pages for the methods.有关创建的新文档的详细信息，请参阅方法的各个参考页。

If update_one, update_many, or replace_one includes upsert : true and no documents match the specified filter, then the operation creates a new document and inserts it. 如果update_one、update_many或replace_one包含upsert:true，并且没有文档与指定的筛选器匹配，则该操作将创建一个新文档并插入它。If there are matching documents, then the operation modifies or replaces the matching document or documents.如果有匹配的文档，则操作会修改或替换匹配的文档。

For details on the new document created, see the individual reference pages for the methods.有关创建的新文档的详细信息，请参阅方法的各个参考页。

If update_one(), update_many(), or replace_one() includes upsert => true and no documents match the specified filter, then the operation creates a new document and inserts it. 如果update_one()、update_many()或replace_one()包含upsert => true，并且没有文档与指定的筛选器匹配，则操作将创建一个新文档并插入它。If there are matching documents, then the operation modifies or replaces the matching document or documents.如果有匹配的文档，则操作会修改或替换匹配的文档。

For details on the new document created, see the individual reference pages for the methods.有关创建的新文档的详细信息，请参阅方法的各个参考页。

If updateOne(), updateMany(), or replaceOne() includes upsert => true and no documents match the specified filter, then the operation creates a new document and inserts it. 如果updateOne()、updateMany()或replaceOne()包含upsert=>true，并且没有文档与指定的筛选器匹配，则该操作将创建一个新文档并插入它。If there are matching documents, then the operation modifies or replaces the matching document or documents.如果有匹配的文档，则操作会修改或替换匹配的文档。

For details on the new document created, see the individual reference pages for the methods.有关创建的新文档的详细信息，请参阅方法的各个参考页。