Delete Documents

在此页面上

Overview

样本数据
删除操作
删除一个文档
删除多个文档
自定义删除操作
API 文档

Overview

在本指南中，您可以学习；了解如何使用C驾驶员通过执行删除操作从MongoDB集合中删除文档。

删除操作可从MongoDB集合中删除一个或多个文档。您可以使用 mongoc_collection_delete_one() 或 mongoc_collection_delete_many() 函数执行删除操作。

样本数据

本指南中的示例使用 Atlas示例数据集的sample_restaurants数据库中的restaurants集合。要学习；了解如何创建免费的MongoDB Atlas 群集并加载示例数据集，请参阅Atlas入门指南。

删除操作

您可以使用以下函数执行删除操作：

mongoc_collection_delete_one()，这会删除与 Atlas Search条件匹配的第一个文档
mongoc_collection_delete_many()，这会删除与 Atlas Search条件匹配的所有文档

每个删除函数接受以下参数：

集合：指定要修改的集合。
查询过滤文档：指定要删除的集合文档。有关查询筛选器的更多信息，请参阅MongoDB Server手册中的查询筛选器文档部分。
结果位置：指定指向将包含操作结果的可覆盖存储的指针，或NULL 。
错误位置：指定错误值或NULL 的位置。

删除一个文档

以下示例使用 mongoc_collection_delete_one() 函数删除restaurants集合中 name 值为 "Ready Penny Inn" 的文档：

bson_t *filter = BCON_NEW ("name", BCON_UTF8 ("Ready Penny Inn"));
bson_error_t error;
if (!mongoc_collection_delete_one (collection, filter, NULL, NULL, &error)) {
    printf ("Delete error: %s\n", error.message);
}
bson_destroy (filter);

删除多个文档

以下示例使用 mongoc_collection_delete_many() 函数删除restaurants集合中 borough 值为 "Brooklyn" 的所有文档：

bson_t *filter = BCON_NEW ("borough", BCON_UTF8 ("Brooklyn"));
bson_error_t error;
if (!mongoc_collection_delete_many (collection, filter, NULL, NULL, &error)) {
    printf ("Delete error: %s\n", error.message);
}
bson_destroy (filter);

自定义删除操作

您可以通过传递指定选项值的BSON文档来修改 mongoc_collection_delete_one() 和 mongoc_collection_delete_many() 函数的行为。下表描述了您可以在文档中设立的一些选项：

字段	说明
`collation`	Specifies the kind of language collation to use when comparing text. For more information, see Collation in the MongoDB Server manual. Type: `bson_t`
`writeConcern`	Sets the write concern for the operation. Defaults to the write concern of the namespace. Type: `mongoc_write_concern_t`
`let`	Specifies a document with a list of values to improve operation readability. Values must be constant or closed expressions that don't reference document fields. For more information, see the let statement in the MongoDB Server manual. Type: `bson_t`
`comment`	A comment to attach to the operation. For more information, see the insert command fields guide in the MongoDB Server manual. Type: `bson_value_t`

以下示例调用 mongoc_collection_delete_many() 函数来删除restaurants集合中 name 值包含字符串 "Mongo" 的所有文档。它还设置 comment 选项，为操作添加注释：

bson_t *filter = BCON_NEW ("name", "{", "$regex", BCON_UTF8 ("Mongo"), "}");
bson_error_t error;
bson_t opts;
bson_init(&opts);
BCON_APPEND (&opts, "comment", BCON_UTF8 ("Deleting Mongo restaurants"));
if (!mongoc_collection_delete_many (collection, filter, &opts, NULL, &error)) {
    printf ("Delete error: %s\n", error.message);
}
bson_destroy (filter);
bson_destroy (&opts);

提示

如果在上示例中使用 mongoc_collection_delete_one() 函数而不是 mongoc_collection_delete_many()，则驾驶员仅删除 name 值包含 "Mongo" 的第一个文档。

API 文档

要学习；了解有关本指南中讨论的任何函数的更多信息，请参阅以下API文档：

后退

Update Documents

来年

批量写入操作