SUM (NoSQL クエリ)

適用対象: NoSQL

式の値の合計を返します。

構文

SUM(<numeric_expr>)  

引数

説明
numeric_expr 任意の数式を指定します。

戻り値の型

数値式を返します。

この例では、1 つの quantity フィールドを含む複数の項目を含むコンテナーについて考えます。

[
  {
    "name": "Cosmoxy pack",
    "quantity": 35,
    "category": "hiking-bags"
  },
  {
    "name": "Heliont pack",
    "category": "hiking-bags"
  },
  {
    "name": "Immery bag",
    "quantity": 15,
    "category": "hiking-bags"
  }
]

SUM 関数は 、quantity フィールドが存在する場合にフィールドの値を 1 つの集計値に合計するために使用されます。

SELECT VALUE
    SUM(p.quantity)
FROM 
    products p
WHERE
    p.category = "hiking-bags"
[
  50
]

解説

  • この関数では範囲インデックスが役に立ちます。
  • SUM のいずれかの引数が文字列、ブール値、または null 値の場合、集計システム関数全体では undefined が返されます。
  • 個々の引数に undefined の値が含まれる場合、その値は SUM の計算には含まれません。