COUNT - Linguagem de consulta no Cosmos DB (no Azure e no Fabric)

A COUNT função retorna a contagem dos valores na expressão.

Sintaxe

COUNT(<scalar_expr>)

Arguments

	Description
scalar_expr	Uma expressão escalar para contar.

Tipos de devolução

Devolve um valor escalar numérico.

Examples

Esta seção contém exemplos de como usar essa construção de linguagem de consulta.

Considere este conjunto de exemplos de documentos dentro da Products coleção para esses exemplos.

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

Contar usando um valor escalar e uma expressão

Neste exemplo, COUNT é usado com um escalar e uma expressão. Ambos retornam 1.

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

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

Contar ocorrências de um campo

Neste exemplo, a função conta o número de vezes que o name campo ocorre em dados filtrados.

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

[
  10
]

Contar todos os itens

Neste exemplo, a função é usada para contar todos os itens dentro de um contêiner que correspondem ao filtro.

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

[
  10
]

Observações

• Esta função beneficia da utilização de um índice de intervalo para quaisquer propriedades no filtro da consulta. Para obter mais informações, consulte Índices de intervalo.