PostgreSQL中GROUP BY tablename.*的用法及相关报错疑问

问题现象 #

在PostgreSQL中执行分组查询时，会出现以下矛盾情况：

• 使用GROUP BY users2.*时，SELECT users2.name触发报错：ERROR: column "users2.name" must appear in the GROUP BY clause or be used in an aggregate function
• 但SELECT常量（如SELECT 1）或显式指定GROUP BY users2.user_id, users2.name时，查询可正常执行

对应的SQL示例：

Create table If Not Exists Users2 (user_id int, name varchar(30));
Truncate table Users2;
insert into Users2 (user_id, name) values ('1', 'Daniel');
insert into Users2 (user_id, name) values ('2', 'Monica');
insert into Users2 (user_id, name) values ('3', 'Maria');
insert into Users2 (user_id, name) values ('4', 'James');

-- 报错查询
select users2.name
from users2
group by users2.*;

-- 正常执行的查询
select 1
from users2
group by users2.*;

select users2."name"
from users2
group by users2.user_id,users2."name";

原因解析 #

这是PostgreSQL对GROUP BY tablename.*的解析逻辑导致的，并非bug：

• GROUP BY tablename.*会被展开为表中所有列的列表，但PostgreSQL的查询校验器不会自动将SELECT子句中的单独列引用，与GROUP BY中展开的列关联。校验规则要求SELECT中的非聚合列必须显式出现在GROUP BY子句中，而tablename.*的展开形式不被视为该列的显式声明。
• 当SELECT常量时，由于常量不依赖分组后的任何列，无需满足GROUP BY的列校验规则，因此可正常执行。
• 显式列出user_id和name时，SELECT中的name明确在GROUP BY列表内，符合校验规则，因此正常执行。

额外补充：如果表存在主键（比如将user_id设为主键），那么GROUP BY user_id即可直接SELECT name——PostgreSQL支持“主键覆盖”规则，主键能唯一确定其他列的值，此时无需将其他列加入GROUP BY。

解决方案 #

针对这类问题，有两种常用处理方式：

1. 显式列出GROUP BY的所有列：将GROUP BY users2.*替换为GROUP BY users2.user_id, users2.name，确保SELECT中的非聚合列都在GROUP BY列表中。
2. 利用主键/唯一约束：如果表有主键或唯一约束列，直接GROUP BY该列即可，无需列出其他列（前提是该列能唯一确定其他列的值）。

内容的提问来源于stack exchange，提问作者Manohar Bhat