Partage via


COUNT (requête NoSQL)

S’APPLIQUE À : NoSQL

Renvoie le nombre de valeurs de l’expression.

Syntaxe

COUNT(<scalar_expr>)  

Arguments

Description
scalar_expr Expression scalaire.

Types de retour

Retourne une valeur scalaire numérique.

Exemples

Ce premier exemple transmet une valeur scalaire ou une expression numérique à la fonction COUNT. L’expression est évaluée d’abord en scalaire, ce qui donne la même valeur au résultat des deux utilisations de la fonction.

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

Cet exemple suivant suppose qu’il existe un conteneur avec deux éléments avec un champ /name. Il existe un élément unique sans le même champ.

[
  {
    "name": "Horric socks",
    "category": "socks"
  },
  {
    "name": "Shinity socks",
    "category": "socks"
  },
  {
    "category": "socks"
  }
]

Dans cet exemple, la fonction compte le nombre de fois où le champ scalaire spécifié est présent dans les données filtrées. Ici, la fonction recherche le nombre de fois où le champ /name est présent, soit deux fois sur trois.

SELECT VALUE
    COUNT(p.name)
FROM
    products p
WHERE
    p.category = "socks"
[
  2
]

Dans cet exemple final, la fonction est utilisée pour compter chaque élément d’un colocalisateur.

SELECT VALUE
    COUNT(1)
FROM
    items

Notes

  • Cette fonction tire parti d’un index de plage pour toutes les propriétés du filtre de la requête.