COUNT — язык запросов в Cosmos DB (в Azure и Fabric)

Функция 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
]

Замечания

• Эта функция использует индекс диапазона для любых свойств в фильтре запроса. Дополнительные сведения см. в разделе индексов диапазона.