插入文档

概述

在本指南中，您可以学习如何通过执行插入操作来使用 PyMongo 将文档添加到 MongoDB 集合。

插入操作将一个或多个文档插入到 MongoDB 集合中。您可以通过使用insert_one() 或 insert_many() 方法来执行插入操作。

_id字段

在MongoDB集合中，每个文档都必须包含一个具有唯一字段值的_id字段。

MongoDB允许您以两种方式管理此字段

• 您可以自己设置每个文档的此字段，确保每个_id字段值都是唯一的。

• 您可以允许驱动程序为每个文档自动生成唯一的ObjectId值。如果您不为文档手动设置_id值，驱动程序将使用ObjectId填充字段。

除非您可以保证唯一性，否则我们建议让驱动程序自动生成_id值。

要了解更多关于_id字段的信息，请参阅MongoDB服务器手册中的唯一索引指南。

要了解更多关于文档结构和规则的信息，请参阅MongoDB服务器手册中的文档指南。

插入单个文档

要将单个文档添加到MongoDB集合中，请调用insert_one()方法，并传递您要添加的文档。

以下示例将文档插入到restaurants集合中

sample_restaurants.restaurants.insert_one({"name" : "Mongo's Burgers"})

插入多个文档

要将多个文档添加到MongoDB集合中，请调用insert_many()方法，并传递您要添加的文档列表。

以下示例将文档列表插入到restaurants集合中

document_list = [
   { "name" : "Mongo's Burgers" },
   { "name" : "Mongo's Pizza" }
]
sample_restaurants.restaurants.insert_many(document_list)

修改插入行为

insert_one()方法可选地接受其他参数，代表您可以用来配置插入操作的可选参数。如果您不指定任何其他参数，驱动程序不会自定义插入。

InsertMany()方法接受前面提到的可选参数，以及可选的ordered属性。

document_list = [
    { "name" : "Mongo's Burgers" },
    { "name" : "Mongo's Pizza" },
    { "name" : "Mongo's Tacos" }
 ]
 sample_restaurants.restaurants.insert_many(document_list, bypass_document_validation = True)

更多信息

有关使用PyMongo插入文档的可运行代码示例，请参阅将数据写入MongoDB。