다음을 통해 공유

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

  • 적용 대상: ✅ Azure Cosmos DB for NoSQL, ✅ Cosmos DB in Microsoft Fabric

함수는 AVG 식에 있는 값의 평균을 계산합니다.

구문

AVG(<numeric_expr>)

Arguments

Description
numeric_expr 평균을 계산할 숫자 식입니다.

반환 형식

숫자 스칼라 값을 반환합니다.

예시

이 섹션에는 이 쿼리 언어 구문을 사용하는 방법에 대한 예제가 포함되어 있습니다.

이러한 예제를 보려면 컬렉션 내 Products 의 이 샘플 문서 집합을 고려해 보세요.

[
  {
    "name": "Diannis Watch",
    "price": 98,
    "detailCategory": "apparel-accessories-watches"
  },
  {
    "name": "Confira Watch",
    "price": 105,
    "detailCategory": "apparel-accessories-watches"
  }
]

단일 속성의 평균 값

이 예제 AVG 에서 함수는 속성 값을 price 단일 집계 값으로 평균하는 데 사용됩니다.

SELECT
  AVG(p.price) AS averagePrice
FROM
  products p
WHERE
  p.detailCategory = "apparel-accessories-watches"

[
  {
    "averagePrice": 101.5
  }
]

비고

  • 이 함수는 범위 인덱스 사용의 이점을 활용합니다. 자세한 내용은 범위 인덱스를 참조하세요.
  • 인수가 AVG 문자열, 부울 또는 null이면 전체 집계 시스템 함수가 반환됩니다 undefined.
  • 인수에 값이 있는 undefined 경우 해당 특정 값은 계산에 AVG 포함되지 않습니다.
  • Last updated on