SUM - Cosmos DB 中的查詢語言 （在 Azure 和 Fabric 中）

此 SUM 函數會計算運算式中值的總和。

語法

SUM(<numeric_expr>)

Arguments

	Description
numeric_expr	要加總的數值運算式。

傳回類型

傳回數值純量值。

範例

本節包含如何使用此查詢語言建構的範例。

請考慮這些範例集合中的 Products 此範例文件集。

[
  {
    "name": "Sathem Backpack",
    "quantity": 0,
    "detailCategory": "gear-hike-backpacks"
  },
  {
    "name": "Ventrin Backpack",
    "quantity": 230,
    "detailCategory": "gear-hike-backpacks"
  },
  {
    "name": "Martox Backpack",
    "quantity": 14,
    "detailCategory": "gear-hike-backpacks"
  },
  {
    "name": "Rangeo Backpack",
    "quantity": 232,
    "detailCategory": "gear-hike-backpacks"
  },
  {
    "name": "Moonroq Backpack",
    "quantity": 141,
    "detailCategory": "gear-hike-backpacks"
  }
]

單一屬性的總和值

在此範例中，函 SUM 式可用來將屬性的 quantity 值加總成單一彙總值。

SELECT VALUE
  SUM(p.quantity)
FROM
  products p
WHERE
  p.detailCategory = "gear-hike-backpacks"

[
  617
]

備註

• 此功能受益於範圍索引的使用。 如需詳細資訊，請參閱 範圍索引。
• 如果中 SUM 的任何引數是字串、布林值或 Null，則整個彙總系統函數會傳回 undefined。
• 如果任何個別引數具有 undefined 值，則該值不會包含在計算中 SUM 。