Add GROUP BY ALL.
authorTom Lane <tgl@sss.pgh.pa.us>
Mon, 29 Sep 2025 20:55:17 +0000 (16:55 -0400)
committerTom Lane <tgl@sss.pgh.pa.us>
Mon, 29 Sep 2025 20:55:17 +0000 (16:55 -0400)
commitef38a4d9756db9ae1d20f40aa39f3cf76059b81a
tree51e9441676f4eb7be5e65f71cc5fe41adc8b06bf
parentb91067c8995235445d76353bcd218ef383fe970d
Add GROUP BY ALL.

GROUP BY ALL is a form of GROUP BY that adds any TargetExpr that does
not contain an aggregate or window function into the groupClause of
the query, making it exactly equivalent to specifying those same
expressions in an explicit GROUP BY list.

This feature is useful for certain kinds of data exploration.  It's
already present in some other DBMSes, and the SQL committee recently
accepted it into the standard, so we can be reasonably confident in
the syntax being stable.  We do have to invent part of the semantics,
as the standard doesn't allow for expressions in GROUP BY, so they
haven't specified what to do with window functions.  We assume that
those should be treated like aggregates, i.e., left out of the
constructed GROUP BY list.

In passing, wordsmith some existing documentation about GROUP BY,
and update some neglected synopsis entries in select_into.sgml.

Author: David Christensen <david@pgguru.net>
Reviewed-by: Tom Lane <tgl@sss.pgh.pa.us>
Discussion: https://postgr.es/m/CAHM0NXjz0kDwtzoe-fnHAqPB1qA8_VJN0XAmCgUZ+iPnvP5LbA@mail.gmail.com
12 files changed:
doc/src/sgml/queries.sgml
doc/src/sgml/ref/select.sgml
doc/src/sgml/ref/select_into.sgml
src/backend/parser/analyze.c
src/backend/parser/gram.y
src/backend/parser/parse_clause.c
src/backend/utils/adt/ruleutils.c
src/include/catalog/catversion.h
src/include/nodes/parsenodes.h
src/include/parser/parse_clause.h
src/test/regress/expected/aggregates.out
src/test/regress/sql/aggregates.sql