AVG - Cosmos DB 中的查询语言(在 Azure 和 Fabric 中)

AVG 函数计算表达式中值的平均值。

Syntax

AVG(<numeric_expr>)

Arguments

Description
numeric_expr 用于计算平均值的数值表达式。

返回类型

返回数值标量值。

例子

本部分包含有关如何使用此查询语言构造的示例。

对于这些示例,请考虑集合中的 Products 一组文档示例。

[
  {
    "name": "Diannis Watch",
    "price": 98,
    "detailCategory": "apparel-accessories-watches"
  },
  {
    "name": "Confira Watch",
    "price": 105,
    "detailCategory": "apparel-accessories-watches"
  }
]

单个属性的平均值

在此示例中,该 AVG 函数用于将属性的值 price 平均为单个聚合值。

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

注解

  • 此函数受益于范围索引的使用。 有关详细信息,请参阅 范围索引
  • 如果任何 AVG 参数是字符串、布尔或 null,则整个聚合系统函数返回 undefined
  • 如果任何参数具有值 undefined ,则计算中不包含 AVG 该特定值。