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計算には含まれません。