通过

COUNT - Cosmos DB 中的查询语言（在 Azure 和 Fabric 中）

  • 适用于: ✅ Azure Cosmos DB for NoSQL, ✅ Cosmos DB in Microsoft Fabric

该 COUNT 函数返回表达式中值的计数。

Syntax

COUNT(<scalar_expr>)

Arguments

Description
scalar_expr 要计数的标量表达式。

返回类型

返回数值标量值。

例子

本部分包含有关如何使用此查询语言构造的示例。

对于这些示例，请考虑集合中的 Products 一组文档示例。

[
  {
    "name": "Kameni Adult Bike Helmet",
    "detailCategory": "gear-cycle-helmets"
  },
  {
    "name": "Rockmak Full Face Helmet",
    "detailCategory": "gear-cycle-helmets"
  },
  {
    "name": "Barea Skateboard Helmet",
    "detailCategory": "gear-cycle-helmets"
  },
  {
    "name": "Cranix Full Face Helmet",
    "detailCategory": "gear-cycle-helmets"
  },
  {
    "name": "Furano Adult Bike Helmet",
    "detailCategory": "gear-cycle-helmets"
  },
  {
    "name": "Prigla Adult Bike Helmet",
    "detailCategory": "gear-cycle-helmets"
  },
  {
    "name": "Menitos Skateboard Helmet",
    "detailCategory": "gear-cycle-helmets"
  },
  {
    "name": "Knimer Adult Bike Helmet",
    "detailCategory": "gear-cycle-helmets"
  },
  {
    "name": "Cranix Bike Helmet",
    "detailCategory": "gear-cycle-helmets"
  },
  {
    "name": "Jeropa Adult Bike Helmet",
    "detailCategory": "gear-cycle-helmets"
  }
]

使用标量值和表达式进行计数

在此示例中，COUNT 与标量和表达式一起使用。 两者都返回 1。

SELECT VALUE {
  countScalar: COUNT(1),
  countExpression: COUNT(2 + 3)
}

[
  {
    "countScalar": 1,
    "countExpression": 1
  }
]

统计字段的出现次数

在此示例中，函数对字段在筛选数据中发生的次数 name 进行计数。

SELECT VALUE
  COUNT(p.name)
FROM
  products p
WHERE
  p.detailCategory = "gear-cycle-helmets"

[
  10
]

对所有项进行计数

在此示例中，该函数用于对与筛选器匹配的容器中的每个项进行计数。

SELECT VALUE
  COUNT(1)
FROM
  products p
WHERE
  p.detailCategory = "gear-cycle-helmets"

[
  10
]

注解

  • 此函数受益于对查询筛选器中的任何属性使用范围索引。 有关详细信息，请参阅 范围索引。
  • Last updated on