COUNT - Langage de requête dans Cosmos DB (dans Azure et Fabric)

La COUNT fonction retourne le nombre de valeurs dans l’expression.

Syntaxe

COUNT(<scalar_expr>)

Arguments

Types de retour

Retourne une valeur scalaire numérique.

Examples

Cette section contient des exemples d’utilisation de cette construction de langage de requête.

Considérez cet exemple de jeu de documents dans la Products collection pour ces exemples.

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

Compter à l’aide d’une valeur scalaire et d’une expression

Dans cet exemple, COUNT est utilisé avec une scalaire et une expression. Les deux retours 1.

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

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

Compter les occurrences d’un champ

Dans cet exemple, la fonction compte le nombre de fois où le name champ se produit dans les données filtrées.

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

[
  10
]

Compter tous les éléments

Dans cet exemple, la fonction est utilisée pour compter chaque élément dans un conteneur qui correspond au filtre.

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

[
  10
]

Remarques

• Cette fonction tire parti de l’utilisation d’un index de plage pour toutes les propriétés du filtre de la requête. Pour plus d’informations, consultez les index de plage.