Partager via


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

La AVG fonction calcule la moyenne des valeurs dans l’expression.

Syntaxe

AVG(<numeric_expr>)

Arguments

Descriptif
numeric_expr Expression numérique à partir de qui calcule la moyenne.

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": "Diannis Watch",
    "price": 98,
    "detailCategory": "apparel-accessories-watches"
  },
  {
    "name": "Confira Watch",
    "price": 105,
    "detailCategory": "apparel-accessories-watches"
  }
]

Valeur moyenne d’une propriété unique

Dans cet exemple, la AVG fonction est utilisée pour moyenner les valeurs de la price propriété en une seule valeur agrégée.

SELECT
  AVG(p.price) AS averagePrice
FROM
  products p
WHERE
  p.detailCategory = "apparel-accessories-watches"
[
  {
    "averagePrice": 101.5
  }
]

Remarques

  • Cette fonction tire parti de l’utilisation d’un index de plage. Pour plus d’informations, consultez les index de plage.
  • Si des arguments sont AVG des arguments de chaîne, booléen ou null ; la fonction système d’agrégation entière retourne undefined.
  • Si un argument a une undefined valeur, cette valeur spécifique n’est pas incluse dans le AVG calcul.