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

该 SUM 函数计算表达式中值的总和。

Syntax

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 该值。