插入文档

概述

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

插入操作将一个或多个文档插入到MongoDB集合中。您可以使用以下函数执行插入操作

• mongoc_collection_insert_one()函数用于插入单个文档

• mongoc_collection_insert_many() 函数用于插入一个或多个文档

_id 字段

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

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

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

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

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

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

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

插入一个文档

要将单个文档添加到MongoDB集合中，请调用mongoc_collection_insert_one()函数，并传递以下参数

• 要插入文档的集合

• 要插入的文档

• 用于自定义操作的选项，或NULL

• 指向将包含操作结果的可覆盖存储的指针，或NULL

• 错误值的存储位置，或NULL

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

bson_t *document = BCON_NEW ("name", BCON_UTF8 ("Mongo's Burgers"));
bson_error_t error;
if (!mongoc_collection_insert_one (collection, document, NULL, NULL, &error)) {
    fprintf (stderr, "Insert one operation failed: %s\n", error.message);
}
bson_destroy (document);

插入多个文档

要将多个文档添加到MongoDB集合中，请调用mongoc_collection_insert_many()函数，并传递以下参数

• 要插入文档的集合

• 要插入的文档指针数组

• 要插入的文档数量

• 用于自定义操作的选项，或NULL

• 指向将包含操作结果的可覆盖存储的指针，或NULL

• 错误值的存储位置，或NULL

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

size_t num_docs = 2;
bson_t *docs[num_docs];
docs[0] = BCON_NEW ("name", BCON_UTF8 ("Mongo's Burgers"));
docs[1] = BCON_NEW ("name", BCON_UTF8 ("Mongo's Pizza"));
bson_error_t error;
if (!mongoc_collection_insert_many (collection, (const bson_t **) docs, num_docs, NULL, NULL, &error)) {
    fprintf (stderr, "Insert many operation failed: %s\n", error.message);
}
bson_destroy (docs[0]);
bson_destroy (docs[1]);

修改插入行为

您可以通过传递一个指定选项值的BSON文档来修改 mongoc_collection_insert_one() 和 mongoc_collection_insert_many() 函数的行为。以下表格描述了您可以在文档中设置的某些选项

size_t num_docs = 3;
bson_t *docs[num_docs];
docs[0] = BCON_NEW ("name", BCON_UTF8("Mongo's Burgers"));
docs[1] = BCON_NEW ("name", BCON_UTF8("Mongo's Pizza"));
docs[2] = BCON_NEW ("name", BCON_UTF8("Mongo's Tacos"));
bson_t opts;
bson_init (&opts);
bson_append_bool (&opts, "bypassDocumentValidation", -1, true);
bson_error_t error;
if (!mongoc_collection_insert_many (collection, (const bson_t **) docs, num_docs, &opts, NULL, &error)) {
    fprintf (stderr, "Insert many operation failed: %s\n", error.message);
}
bson_destroy (docs[0]);
bson_destroy (docs[1]);
bson_destroy (docs[2]);
bson_destroy (&opts);

更多信息