/ /

/ /

`$searchMeta`

$searchMeta

$searchMeta阶段返回不同类型的元数据结果文档。

注意

如要对分片集合运行 $searchMeta 查询，您的集群必须运行 MongoDB v6.0 或更高版本。

语法

$searchMeta 管道阶段采用以下原型形式：

{
  $searchMeta: {
    "index": "<index-name>",
    "<collector-name>"|"<operator-name>": {
      <collector-specification>|<operator-specification>
    },
    "count": {
      <count-options>
    },
    "returnScope": {
      "path": "<embedded-documents-field-to-retrieve>"
    }
    "returnStoredSource": true | false
  }
}

字段

$searchMeta 阶段采用包含以下字段的文档：

字段	类型	必要性	说明
`<collector-name>`	对象	可选的	用于查询的收集器的名称。您可以提供一个包含收集器特定选项的文档作为该字段的值。值必须为 `facet` 才能检索所定义分面（Facet）名称到该分面（Facet）的存储桶大量的映射。要学习；了解更多信息，请参阅 `facet`（MongoDB搜索操作符）。您必须指定此项或 `<operator-name>`。
`count`	对象	Optional	指定用于检索结果计数的计数选项的文档。要学习；了解更多信息，请参阅对MongoDB搜索结果进行计数。
`index`	字符串	Optional	要使用的MongoDB Search索引的名称。如果省略，则默认为 `default`。如果索引名称拼写错误或者指定的索引在集群上尚不存在，则MongoDB Search 不会返回结果。
`<operator-name>`	对象	可选的	用于搜索的操作符名称。您可以提供一个包含操作符特定选项的文档作为该字段的值。您必须指定此项或 `<collector-name>`。 `$searchMeta`仅返回默认的`count` 元数据。
`returnScope`	对象	Optional	将查询上下文设置为指定的嵌入式文档字段的对象。如果您的集群 MongoDB 版本低于 8.2，您还必须指定 `returnStoredSource` 并将其设置为 `true`。
`returnStoredSource`	布尔	可选的	标志，指定是对后端数据库执行完整文档查找，还是直接从 MongoDB Search 仅返回存储的源字段。如果省略，则默认值为 `false`。如果您指定 `returnScope` 且您的集群 MongoDB 版本低于 8.2，则必须为 `true`。要了解详情，请参阅返回已存储源字段。

行为

$searchMeta 阶段必须是任何管道中的第一阶段。

元数据结果类型

$searchMeta 阶段返回的元数据结果文档的结构因结果类型而异。MongoDB Search 支持以下结果类型：

类型	Result Structure（结果结构）
`count`	结果中包含的计数结果指示结果中返回的计数是搜索结果的总数还是下限。要了解详情，请参阅计数结果。
`facet`	分面查询的结果是所定义的分面名称到该分面的存储桶数组的映射。要了解详情，请参阅分面结果。

例子

假设 sample_mflix.movies 集合上有如下索引。

{
  "mappings": {
    "dynamic": false,
    "fields": {
      "year": {
        "type": "number"
      }
    }
  }
}

以下查询使用 $searchMeta 阶段搜索 1998 年上映的电影数量。

db.movies.aggregate([
  {
    "$searchMeta": {
      "range": {
        "path": "year",
        "gte": 1998,
        "lt": 1999
      },
      "count": {
        "type": "total"
      }
    }
  }
])

[ { count: { total: Long("552") } } ]

故障排除

如果您在使用MongoDB Search $search 查询时遇到问题，请参阅查询故障排除。

后退

文档：$search

来年

操作符和收集器