COUNT - Lenguaje de consulta en Cosmos DB (en Azure y Fabric)

La COUNT función devuelve el recuento de los valores de la expresión.

Syntax

COUNT(<scalar_expr>)

Arguments

	Description
scalar_expr	Expresión escalar que se va a contar.

Tipos de retorno

Devuelve un valor escalar numérico.

Examples

Esta sección contiene ejemplos de cómo usar esta construcción del lenguaje de consulta.

Considere este conjunto de documentos de ejemplo dentro de la Products colección para estos ejemplos.

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

Recuento con un valor escalar y una expresión

En este ejemplo, COUNT se usa con un escalar y una expresión. Ambos devuelven 1.

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

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

Recuento de repeticiones de un campo

En este ejemplo, la función cuenta el número de veces que se produce el name campo en los datos filtrados.

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

[
  10
]

Recuento de todos los elementos

En este ejemplo, la función se usa para contar todos los elementos de un contenedor que coincida con el filtro.

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

[
  10
]

Observaciones

• Esta función se beneficia del uso de un índice de intervalo para las propiedades del filtro de la consulta. Para obtener más información, vea Índices de intervalo.