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 .