다음을 통해 공유

SUM - Cosmos DB의 쿼리 언어(Azure 및 패브릭)

  • 적용 대상: ✅ Azure Cosmos DB for NoSQL, ✅ Cosmos DB in Microsoft 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 포함되지 않습니다.
  • Last updated on