“文档” 菜单
文档首页
/ / /
Go 驱动程序
/ / /

删除文档

在此页面上

  • 概述
  • 样本数据
  • 删除操作
  • 参数
  • 返回值
  • 更多信息
  • API 文档

在本指南中,您可以了解如何使用删除操作从 MongoDB 集合中删除文档。

本指南中的示例将以下 Book 结构作为 books 集合中的文档的模型:

type Book struct {
Title string
Author string
Length int32
}

要运行本指南中的示例,请使用以下代码段将样本数据加载到 db.books 集合中:

coll := client.Database("db").Collection("books")
docs := []interface{}{
Book{Title: "Atonement", Author: "Ian McEwan", Length: 351},
Book{Title: "My Brilliant Friend", Author: "Elena Ferrante", Length: 331},
Book{Title: "Lucy", Author: "Jamaica Kincaid", Length: 103},
Book{Title: "Outline", Author: "Rachel Cusk", Length: 258},
}
result, err := coll.InsertMany(context.TODO(), docs)

每个文档都包含书籍说明,其中包含与每个文档中的 title(名称)、author(作者)和 length(长度)字段对应的名称、作者和页面长度。

提示

不存在的数据库和集合

如果执行写操作时不存在必要的数据库和集合,服务器会隐式创建这些数据库和集合。

使用删除操作从 MongoDB 中删除数据。删除操作由以下方法组成:

  • DeleteOne(),会删除与筛选器匹配的第一个文档

  • DeleteMany(),删除所有符合筛选条件的文档

提示

如果运行 DeleteMany() 方法时有一个文档与您的筛选器匹配,则相当于运行 DeleteOne() 方法。

DeleteOne()DeleteMany() 方法需要您传递 Context 类型和 non-nil 查询筛选器,以指定要匹配的文档。

它们都可以选择性地采用 DeleteOptions 类型作为第三个参数,该参数表示可用于配置删除操作的选项。如果不指定 DeleteOptions,驱动程序将使用各选项的默认值。

DeleteOptions 类型允许您使用以下方法配置选项:

方法
说明
SetHint()
用来扫描要删除的文档的索引。
默认: nil
SetCollation()
对结果进行排序时要使用的语言排序规则类型。
默认: nil

DeleteOne()DeleteMany() 方法返回 DeleteResult 类型。该类型包含 DeletedCount 属性,其中说明了已删除文档的数量。如果筛选器中没有匹配项,则不会删除任何文档,DeletedCount0

以下示例使用 DeleteMany() 方法执行以下操作:

  • 匹配并删除 length(长度)大于 300 的文档

  • 指示此方法使用 _id 作为索引

filter := bson.D{{"length", bson.D{{"$gt", 300}}}}
opts := options.Delete().SetHint(bson.D{{"_id", 1}})
result, err := coll.DeleteMany(context.TODO(), filter, opts)
if err != nil {
panic(err)
}
fmt.Printf("Number of documents deleted: %d\n", result.DeletedCount)

提示

如果上述示例中使用的是 DeleteOne() 方法而不是 DeleteMany(),驱动程序将删除两个匹配文档中的第一个。

有关删除操作的可运行示例,请参阅以下用法示例:

  • 删除文档

  • 删除多个文档

要了解有关执行上述操作的更多信息,请参阅以下指南:

要了解驱动程序如何使用上下文,请参阅上下文

要详细了解如何指定提示,请参阅索引

要详细了解排序规则,请参阅排序规则

要进一步了解本指南所讨论的任何方法或类型,请参阅以下 API 文档:

  • DeleteOne()

  • DeleteMany()

  • DeleteOptions

  • DeleteResult

← 插入文档