Docs 菜单
Docs 主页
/ / /
Go 驱动程序
/ / /

Retrieve Distinct Values

在此页面上

  • Overview
  • 样本数据
  • distinct
  • 修改行为
  • 更多信息
  • API 文档

在本指南中,您可以了解如何在单个集合中检索指定字段的不同值。

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

type Course struct {
Title string
Department string
Enrollment int32
}

要运行该示例,请使用以下代码段将示例数据加载到db.courses集合中:

coll := client.Database("db").Collection("courses")
docs := []interface{}{
Course{Title: "World Fiction", Department: "English", Enrollment: 35},
Course{Title: "Abstract Algebra", Department: "Mathematics", Enrollment: 60},
Course{Title: "Modern Poetry", Department: "English", Enrollment: 12},
Course{Title: "Plate Tectonics", Department: "Earth Science", Enrollment: 30},
}
result, err := coll.InsertMany(context.TODO(), docs)

提示

不存在的数据库和集合

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

每个文档都包含大学课程的说明,其中包括课程标题、部门和注册人数。 这些项目对应于每个文档中的titledepartmentenrollment字段。

要在单个collection中检索指定字段的不同值,请将以下参数传递给Distinct()方法:

  • 您希望为其指定非重复值的字段名称

  • non-nil查询筛选器,指定要匹配的文档

提示

如果指定空查询筛选器,则Distinct()方法会在collection中的所有文档中搜索不同值。

您可以通过传入 DistinctOptions 来修改 Distinct() 方法的行为。如果不指定 DistinctOptions,则驱动程序将使用每个选项的默认值。

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

方法
说明
SetCollation()
The type of language collation to use when sorting results.
Default: nil
SetMaxTime()
The maximum amount of time that the query can run on the server.
Default: nil

以下示例匹配enrollment字段值小于50的文档,并使用Distinct()方法打印department字段的不同值:

results, err := coll.Distinct(context.TODO(), "department", bson.D{{"enrollment", bson.D{{"$lt", 50}}}})
if err != nil {
panic(err)
}
for _, result := range results {
fmt.Println(result)
}
Earth Science
English

有关检索非重复值的可运行示例,请参阅检索字段的非重复值。

要了解如何构建查询筛选器,请参阅指定查询。

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

  • Distinct()

  • DistinctOptions

后退

数据游标