可以,RETURNING天然支持批量插入并按VALUES顺序返回每行ID;例如INSERT INTO users VALUES (...), (...) RETURNING id会准确返回对应三行的id值。

RETURNING 能否一次返回批量插入的所有 ID
可以,RETURNING 本身天然支持批量操作——只要 INSERT 是单条语句(哪怕含多行 VALUES),RETURNING 就会为每一行返回对应结果。不需要额外包装或循环。
正确写法:单条 INSERT + RETURNING VALUES 列表
最常见也最高效的方式是把多条记录写进一个 INSERT ... VALUES (...), (...), (...) 语句,再跟 RETURNING id:
INSERT INTO users (name, email)
VALUES
('Alice', 'alice@example.com'),
('Bob', 'bob@example.com'),
('Charlie', 'charlie@example.com')
RETURNING id;
执行后直接返回三行 id 值(按插入顺序)。注意:RETURNING 返回的是实际写入的行,不受 ON CONFLICT 影响(除非显式用 DO UPDATE ... RETURNING)。
PostgreSQL 18.4 官方 Ubuntu 安装包现已发布,这是目前最新的稳定版本。推荐通过官方 APT 仓库安装:先执行 sudo apt update 更新索引,再运行 sudo apt install postgresql-18 即可完成部署。新版本引入了异步 I/O 子系统,在顺序扫描与 VACUUM 场景下性能提升显著,同时支持 UUID v7 原生生成函数与虚拟生成列。
遇到 ON CONFLICT 时 RETURNING 的行为差异
如果表有唯一约束且想“存在则忽略、不存在则插入”,必须用 ON CONFLICT,但默认情况下它不会返回未插入的行 ID:
-
ON CONFLICT DO NOTHING RETURNING id→ 只返回**新插入**的行 ID,冲突行不返回任何值(结果集行数 ≤ 输入行数) -
ON CONFLICT (email) DO UPDATE SET name = EXCLUDED.name RETURNING id→ 冲突行也会触发 RETURNING,返回的是**更新后**的行 ID(即原记录 ID) - 若需区分“新增”和“更新”,可在 RETURNING 中加计算字段,例如
RETURNING id, (xmax = 0) AS is_inserted(依赖系统列,生产环境慎用)
大批次插入时的性能与限制提醒
PostgreSQL 对单条语句的参数数量有限制(通常由 max_query_size 和内存决定),VALUES 列表不宜超过几千行:
- 500 行以内:直接拼 VALUES 安全高效
- 500–10000 行:建议分批,每批 500–1000 行,用事务包裹
- 超大批量(如 >10 万行):改用
COPY导入,再用INSERT ... SELECT ... RETURNING配合临时表,否则可能触发 OOM 或解析超时 - 所有方式下,
RETURNING返回的结果集大小等于实际变更行数,应用层必须能接收并处理可变长度结果
别忘了:如果表 ID 是 SERIAL 或 GENERATED ALWAYS AS IDENTITY,RETURNING id 拿到的就是刚分配的值;但如果是手动指定 ID 插入,RETURNING 返回的就是你写的那个值——这点容易在调试时误判主键来源。

















