AVG — язык запросов в Cosmos DB (в Azure и Fabric)

Функция AVG вычисляет среднее значение значений в выражении.

Синтаксис

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 .