AVG() GROUP BY ...

All functions > GROUP BY > AVG() GROUP BY ...

Returns the average of the values in the group.

Syntax

AVG(expr)
 [ FILTER (WHERE condition) ]
  [ GROUP BY feature [, feature ...] ]

Notes

  • Calculates the arithmetic mean (sum divided by count)
  • NULL values are excluded from the calculation
  • Returns NULL if all values are NULL or group is empty
  • Result type matches input type
  • Can be used with WHERE clause to filter before aggregation
  • Can be used with GROUP BY clause for grouped aggregation

Examples

FeatureQL
SELECT
    f1 := ZIP(ARRAY[1, 2, 3, 4] AS value).TRANSFORM(SELECT AVG(value)).UNWRAP_ONE(), -- Average of values
    f2 := ZIP(ARRAY[1, NULL::BIGINT, 3, NULL::BIGINT] AS value).TRANSFORM(SELECT AVG(value)).UNWRAP_ONE() -- Average of values excluding NULLs
;
Result
f1 VARCHARf2 VARCHAR
2.52.0

Last update at: 2026/05/26 17:22:09