Link Search Menu Expand Document Documentation Menu
文档

计数

1.0 版引入

count API 可让您快速访问与查询匹配的文档数量。您还可以使用它来检查索引、数据流或集群的文档计数。

端点

GET <target>/_count/<id>
POST <target>/_count/<id>

查询参数

所有参数都是可选的。

参数 类型 描述
allow_no_indices 布尔型 如果为 false，则如果任何通配符表达式或索引别名指向任何已关闭或缺失的索引，请求将返回错误。默认值为 false。
分析器 字符串 用于查询字符串的分析器。
analyze_wildcard 布尔型 指定是否分析通配符和前缀查询。默认值为 false。
default_operator 字符串 指示字符串查询的默认运算符应为 AND 还是 OR。默认值为 OR。
df 字符串 如果查询字符串中未提供字段前缀，则使用的默认字段。
expand_wildcards 字符串 指定通配符表达式可以匹配的索引类型。支持逗号分隔值。有效值为 all（匹配任何索引）、open（匹配打开的非隐藏索引）、closed（匹配关闭的非隐藏索引）、hidden（匹配隐藏索引）和 none（拒绝通配符表达式）。默认值为 open。
ignore_unavailable 布尔型 指定是否在响应中包含缺失或已关闭的索引。默认值为 false。
lenient 布尔型 指定 OpenSearch 是否应接受查询存在格式错误（例如，查询文本字段时使用整数）的请求。默认值为 false。
min_score 浮点型 结果中仅包含 _score 值最小的文档。
路由 字符串 用于将操作路由到特定分片的值。
preference 字符串 指定 OpenSearch 应在哪个分片或节点上执行计数操作。
terminate_after 整数 OpenSearch 在终止请求前应处理的最大匹配文档数（命中数）。

示例请求

查看与查询匹配的文档数量

GET opensearch_dashboards_sample_data_logs/_count
{
  "query": {
    "term": {
      "response": "200"
    }
  }
}

以下对搜索 API 的调用会产生相同的结果

GET opensearch_dashboards_sample_data_logs/_search
{
  "query": {
    "term": {
      "response": "200"
    }
  },
  "size": 0,
  "track_total_hits": true
}

查看索引中的文档数量

GET opensearch_dashboards_sample_data_logs/_count

要检查 数据流 中的文档数量，请将索引名称替换为数据流名称。

查看集群中的文档数量

GET _count

或者，您可以使用 cat 索引 和 cat 计数 API 来查看每个索引或数据流的文档数量。

示例响应

{
  "count" : 14074,
  "_shards" : {
    "total" : 1,
    "successful" : 1,
    "skipped" : 0,
    "failed" : 0
  }
}
剩余 350 字符

有问题？。

想贡献吗？或。