插入文档

Overview

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

插入操作将一个或多个文档插入MongoDB集合。 您可以使用以下方法执行插入操作：

• insert_one 插入单个文档

• insert_many 插入一个或多个文档

database = client.use('sample_restaurants')
collection = database[:restaurants]

_id 字段

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

MongoDB 允许您通过两种方式管理该字段：

• 自行为每个文档设置_id字段，确保每个值都是唯一的。

• 让驱动程序自动为每个文档_id字段生成唯一的 BSON::ObjectId 值。

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

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

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

插入一个文档

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

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

document = { name: 'Neighborhood Bar & Grill', borough: 'Queens' }
collection.insert_one(document)

插入多个文档

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

以下示例将两个文档插入restaurants集合：

documents = [
  { name: 'Metropolitan Cafe', borough: 'Queens' },
  { name: 'Yankee Bistro', borough: 'Bronx' }
]
collection.insert_many(documents)

修改插入行为

您可以将 Hash对象作为参数传递给 insert_one 方法，以设立配置插入操作的选项。如果不指定任何选项，驱动程序将使用默认设置执行插入操作。

下表描述了可设立配置 insert_one 操作的选项：

您可以通过将 Hash 作为参数传递给方法调用，对 insert_many 方法设立上述设置。您还可以使用 ordered 选项指定驱动程序将文档插入 MongoDB 的顺序。

documents = [
  { name: 'Cloudy Day', borough: 'Brooklyn' },
  { name: 'Squall or Shine', borough: 'Staten Island' }
  { name: 'Rose Field', borough: 'Queens' }
]
options = { bypass_document_validation: true }
collection.insert_many(documents, options)

API 文档

要进一步了解本指南所讨论的任何方法，请参阅以下 API 文档：

• insert_one

• insert_many