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

함수는 COUNT 식의 값 수를 반환합니다.

구문

COUNT(<scalar_expr>)

Arguments

	Description
scalar_expr	계산할 스칼라 식입니다.

반환 형식

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

예시

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

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

[
  {
    "name": "Kameni Adult Bike Helmet",
    "detailCategory": "gear-cycle-helmets"
  },
  {
    "name": "Rockmak Full Face Helmet",
    "detailCategory": "gear-cycle-helmets"
  },
  {
    "name": "Barea Skateboard Helmet",
    "detailCategory": "gear-cycle-helmets"
  },
  {
    "name": "Cranix Full Face Helmet",
    "detailCategory": "gear-cycle-helmets"
  },
  {
    "name": "Furano Adult Bike Helmet",
    "detailCategory": "gear-cycle-helmets"
  },
  {
    "name": "Prigla Adult Bike Helmet",
    "detailCategory": "gear-cycle-helmets"
  },
  {
    "name": "Menitos Skateboard Helmet",
    "detailCategory": "gear-cycle-helmets"
  },
  {
    "name": "Knimer Adult Bike Helmet",
    "detailCategory": "gear-cycle-helmets"
  },
  {
    "name": "Cranix Bike Helmet",
    "detailCategory": "gear-cycle-helmets"
  },
  {
    "name": "Jeropa Adult Bike Helmet",
    "detailCategory": "gear-cycle-helmets"
  }
]

스칼라 값 및 식을 사용하여 개수 계산

이 예제에서 COUNT는 스칼라 및 식과 함께 사용됩니다. 둘 다 반환합니다 1.

SELECT VALUE {
  countScalar: COUNT(1),
  countExpression: COUNT(2 + 3)
}

[
  {
    "countScalar": 1,
    "countExpression": 1
  }
]

필드의 발생 횟수 계산

이 예제에서 함수는 필터링된 데이터에서 필드가 name 발생하는 횟수를 계산합니다.

SELECT VALUE
  COUNT(p.name)
FROM
  products p
WHERE
  p.detailCategory = "gear-cycle-helmets"

[
  10
]

모든 항목 개수 계산

이 예제에서 함수는 필터와 일치하는 컨테이너 내의 모든 항목을 계산하는 데 사용됩니다.

SELECT VALUE
  COUNT(1)
FROM
  products p
WHERE
  p.detailCategory = "gear-cycle-helmets"

[
  10
]

비고

• 이 함수는 쿼리 필터의 모든 속성에 범위 인덱스 사용의 이점을 활용합니다. 자세한 내용은 범위 인덱스를 참조하세요.