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

La AVG función calcula el promedio de los valores de la expresión.

Syntax

AVG(<numeric_expr>)

Arguments

	Description
numeric_expr	Expresión numérica a partir de la que se va a calcular el promedio.

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

Valor medio de una sola propiedad

En este ejemplo, la AVG función se usa para calcular el promedio de los valores de la price propiedad en un único valor agregado.

SELECT
  AVG(p.price) AS averagePrice
FROM
  products p
WHERE
  p.detailCategory = "apparel-accessories-watches"

[
  {
    "averagePrice": 101.5
  }
]

Observaciones

• Esta función se beneficia del uso de un índice de intervalo. Para obtener más información, vea Índices de intervalo.
• Si alguno de los argumentos de AVG son string, boolean o null; toda la función del sistema de agregación devuelve undefined.
• Si algún argumento tiene un undefined valor, ese valor específico no se incluye en el AVG cálculo.