共用方式為


COUNT - Cosmos DB 中的查詢語言 (在 Azure 和 Fabric 中)

函數 COUNT 會傳回運算式中值的計數。

語法

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
]

備註

  • 此函式受益於對查詢篩選器中的任何屬性使用範圍索引。 如需詳細資訊,請參閱 範圍索引