次の方法で共有


SUM - Cosmos DB のクエリ言語 (Azure と Fabric)

SUM関数は、式内の値の合計を計算します。

構文

SUM(<numeric_expr>)

論争

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"
  }
]

1 つのプロパティの合計値

この例では、 SUM 関数を使用して、 quantity プロパティの値を 1 つの集計値に合計します。

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

注釈

  • この関数は、範囲インデックスを使用する利点があります。 詳細については、「 範囲インデックス」を参照してください。
  • SUMの引数が文字列、ブール値、または null の場合、集計システム関数全体がundefinedを返します。
  • 個々の引数に undefined 値がある場合、その値は SUM 計算には含まれません。