MongoDB insertOne() 方法 – db.Collection.insertOne()
在 MongoDB 中, insertOne()方法将文档插入到集合中。此方法一次仅插入一个文档。
- 使用此方法,您还可以通过插入文档来创建集合。
- 您可以插入带有或不带有 _id 字段的文档。如果您在集合中插入一个没有 _id 字段的文档,那么 MongoDB 将自动添加一个 _id 字段并为其分配一个唯一的 ObjectId。并且如果插入带有_id 字段的文档,那么_id 字段的值必须是唯一的,以避免出现重复键错误。
- 此方法还可以抛出 writeError或writeConcernError 异常。
- 此方法也可用于多文档事务中。
句法:
db.Collection_name.insertOne(
{
writeConcern:
})
参数:
- 第一个参数是文档。文档是由文件和值对创建的结构,类似于 JSON 对象。
- 第二个参数是可选的。
可选参数:
writeConcern:仅在您不想使用默认写关注时使用。该参数的类型是文档。
返回:
此方法返回:
- 如果启用了写关注,则布尔值确认为 true,如果禁用了写关注,则确认为 false。
- 具有插入文档的 _id 值的 insertId 字段。
例子:
在以下示例中,我们正在使用:
Database: gfg
Collection: student
Document: No document but, we want to insert in the form of the student name and student marks.
- 插入单个文档而不指定 _id 字段
在这里,我们将在学生集合中插入名称为 Akshay 且分数为 500 的文档。
db.student.insertOne({Name: "Akshay", Marks: 500})
- 插入带有 _id 字段的单个文档
在这里,我们在学生集合中插入一个文档,其唯一 ID 为 Stu102,名称为 Vishal,分数为 230
db.student.insertOne({_id: "Stu102", Name: "Vishal", Marks: 230})