Docs 菜单
Docs 主页
/
语言
/
Kotlin
/
Kotlin Sync 驱动程序
/
从 MongoDB 读取数据

指定要返回的字段

在此页面上

  • Overview
  • 样本数据
  • 投影类型
  • 指定要包含的字段
  • 排除 _id字段
  • 更多信息
  • API 文档

Overview

在本指南中，您可以了解如何使用投影指定从读取操作中返回哪些字段。 投影是指定 MongoDB 从查询中返回哪些字段的文档。

样本数据

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

此集合中的文档由以下Kotlin数据类建模：

data class Restaurant(
    @BsonId
    val id: ObjectId? = null,
    val name: String,
    val borough: String,
    val cuisine: String
)

投影类型

您可以使用投影来指定要在返回文档中包含哪些字段，或指定要排除哪些字段。

在指定要包含在投影中的某些字段时，会隐式排除所有其他字段（默认包含的_id字段除外）。 除非要排除_id字段，否则不能在单个投影中组合包含和排除语句。

要从返回的文档删除_id字段，您必须明确将其排除。

指定要包含的字段

使用以下语法指定要包含在结果中的字段：

val projection = Projection.fields(
    Projections.include(<fieldName1>, <fieldName2>, ...)
)

以下示例使用find()方法查找name字段值为"Emerald Pub"的所有餐厅。 然后，它使用投影仅返回所返回文档的name 、 cuisine和borough字段。

val projection = Projections.fields(
    Projections.include(
        Restaurant::name.name,
        Restaurant::cuisine.name,
        Restaurant::borough.name
    )
)
val results = collection
    .find(eq(Restaurant::name.name, "Emerald Pub"))
    .projection(projection)
results.forEach { result ->
    println(result)
}
Restaurant(id=5eb3d668b31de5d588f429e2, name=Emerald Pub, borough=Manhattan, cuisine=American)
Restaurant(id=5eb3d668b31de5d588f432dd, name=Emerald Pub, borough=Queens, cuisine=American)

排除_id 字段

在指定要包含的字段时，您还可以从返回的文档中排除_id字段。

以下示例运行与上一示例相同的查询，但从投影中排除_id字段：

val projection = Projections.fields(
    Projections.excludeId(),
    Projections.include(
        Restaurant::name.name,
        Restaurant::cuisine.name,
        Restaurant::borough.name
    )
)
val results = collection
    .find(eq(Restaurant::name.name, "Emerald Pub"))
    .projection(projection)
results.forEach { result ->
    println(result)
}
Restaurant(id=null, name=Emerald Pub, borough=Manhattan, cuisine=American)
Restaurant(id=null, name=Emerald Pub, borough=Queens, cuisine=American)

更多信息

要了解有关投影的更多信息，请参阅 MongoDB Server 手册中的项目字段指南。

API 文档

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

  • find()

  • 投影()

后退

Retrieve Data

来年

指定要返回的文档