COUNT — Język zapytań w usłudze Cosmos DB (na platformie Azure i w sieci szkieletowej)

Funkcja COUNT zwraca liczbę wartości w wyrażeniu.

Składnia

COUNT(<scalar_expr>)

Arguments

	Description
scalar_expr	Wyrażenie skalarne do zliczenia.

Typy zwracane

Zwraca wartość skalarną liczbową.

Przykłady

Ta sekcja zawiera przykłady użycia tej konstrukcji języka zapytań.

Rozważmy ten przykładowy zestaw dokumentów w Products kolekcji dla tych przykładów.

[
  {
    "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"
  }
]

Zlicz przy użyciu wartości skalarnej i wyrażenia

W tym przykładzie funkcja COUNT jest używana z wyrażeniem skalarnym i wyrażeniem. Oba elementy zwracają wartość 1.

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

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

Zlicz wystąpienia pola

W tym przykładzie funkcja zlicza liczbę wystąpień name pola w filtrowanych danych.

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

[
  10
]

Zlicz wszystkie elementy

W tym przykładzie funkcja służy do zliczania każdego elementu w kontenerze, który jest zgodny z filtrem.

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

[
  10
]

Uwagi

• Ta funkcja korzysta z użycia indeksu zakresu dla wszystkich właściwości filtru zapytania. Aby uzyskać więcej informacji, zobacz indeksy zakresu.