一、 使用背景

在用python调用MongoDB操作文档时遇到过很多场景，常规操作是插入，更新，还有按条件替换，存储等。这些场景中用到过insert，update，replace，save。要是不理一下很容易被这几个方法搞糊涂。

二、 insert插入文档

1. 插入单个文档insert_one

当需要插入单个文档的时候用insert_one方法。

参数

insert_one(self, document, bypass_document_validation=False, session=None)

要插入的文档必须是可变映射类型（通常是字典）。如果文档没有 _id 字段，则会自动添加一个。

返回

insert_one() 方法返回 pymongo.results.InsertOneResult对象，该对象包含 inserted_id 属性，它是插入文档的 id 值。

使用实例：

>>> db.test.count_documents({'x': 1})
0
>>> result = db.test.insert_one({'x': 1})
>>> result.inserted_id
ObjectId('54f112defba522406c9cc208')
>>> db.test.find_one({'x': 1})
{u'x': 1, u'_id': ObjectId('54f112defba522406c9cc208')}

2.插入多个文档insert_many

当需要一次性插入多个文档时用insert_many()方法。

参数

insert_many(self, documents, ordered=True, bypass_document_validation=False, session=None)

该方法的第一参数是字典列表。

返回值

insert_many() 方法返回 pymongo.results.InsertManyResult对象，该对象包含 inserted_ids 属性，该属性保存着所有插入文档的 id 值。

使用实例

>>> db.test.count_documents({})
0
>>> result = db.test.insert_many([{'x': i} for i in range(2)])
>>> result.inserted_ids
[ObjectId('54f113fffba522406c9cc20e'), ObjectId('54f113fffba522406c9cc20f')]
>>> db.test.count_documents({})
2

注意：插入的时候可以指定_id。

三、 update更新文档

在MongoDB中可以使用update_one()方法更新文档。

参数和返回

update_one(self, filter, update, upsert=False, multi=False, bypass_document_validation=False,
                   collation=None, array_filters=None, session=None):

• filter: 匹配要更新的文档的查询条件。
• update：要修改的字段。
• upsert（可选,默认为False）：如果为“True”，如果没有文档匹配过滤器，则执行插入。
  如果查找到的匹配数据多于一条，则只会修改第一条。
• multi（可选,默认为False）：如果为“True”，则更新查询到的所有数据。
  update_one()方法只能修匹配到的第一条记录，如果要修改所有匹配到的记录，可以使用 update_many()。

该方法返回pymongo.results.UpdateResult对象。

使用实例

>>> for doc in db.test.find():
...     print(doc)
...
{u'x': 1, u'_id': 0}
{u'x': 1, u'_id': 1}
{u'x': 1, u'_id': 2}
>>> result = db.test.update_one({'x': 1}, {'$inc': {'x': 3}})
>>> result.matched_count
1
>>> result.modified_count
1
>>> for doc in db.test.find():
...     print(doc)
...
{u'x': 4, u'_id': 0}
{u'x': 1, u'_id': 1}
{u'x': 1, u'_id': 2}

四、 save更新文档

MongoDB中还可以使用save来更新文档。

参数

save(self, to_save, manipulate=True, check_keys=True, **kwargs)

此方法已被官方弃用，推荐使用insert_one方法，和replace_one方法。

 **DEPRECATED** - Use :meth:`insert_one` or :meth:`replace_one` instead.

使用时会返回预警信息。

warnings.warn("save is deprecated. Use insert_one or replace_one "
                      "instead", DeprecationWarning, stacklevel=2)

五、 replace替换文档

当需要替换文档的时候可以使用MongoDB的replace方法。

参数

replace_one(self, filter, replacement, upsert=False, bypass_document_validation=False, 
                collation=None, session=None)

• filter：匹配要替换的文档的查询条件。
• replacement：新文件。
• upsert（可选）：如果为“True”，如果没有文档匹配过滤器，则执行插入。

返回

该方法返回pymongo.results.UpdateResult对象。

使用实例

>>> for doc in db.test.find({}):
...     print(doc)
...
{u'x': 1, u'_id': ObjectId('54f4c5befba5220aa4d6dee7')}
>>> result = db.test.replace_one({'x': 1}, {'y': 1})
>>> result.matched_count
1
>>> result.modified_count
1
>>> for doc in db.test.find({}):
...     print(doc)
...
{u'y': 1, u'_id': ObjectId('54f4c5befba5220aa4d6dee7')}


## 如果没有匹配到条件中的文档，使用upsert选项可以执行插入操作

>>> result = db.test.replace_one({'x': 1}, {'x': 1}, True)
>>> result.matched_count
0
>>> result.modified_count
0
>>> result.upserted_id
ObjectId('54f11e5c8891e756a6e1abd4')
>>> db.test.find_one({'x': 1})
{u'x': 1, u'_id': ObjectId('54f11e5c8891e756a6e1abd4')}