如何在PostgreSQL中批量插入并返回主键ID_利用INSERT INTO RETURNING语句

夜敏小哥_7504

夜敏小哥_7504

2026-05-06

845人浏览

原创

能,而且是唯一推荐的原子方式。RETURNING子句在INSERT执行时同步返回指定列(如id),确保原子性、避免竞态,支持批量插入按VALUES顺序返回每行主键,兼容触发器修改后的最终值。

如何在postgresql中批量插入并返回主键id_利用insert into returning语句

RETURNING 子句能直接拿到刚插入的主键 ID 吗?

能,而且是唯一推荐的原子方式。只要表有主键(或至少有 serial/generated always as identity 列),INSERT ... RETURNING id 就会按插入顺序返回每行对应的主键值,无需额外查询或事务控制。

注意:不能用 LASTVAL() 或 CURRVAL() 替代——它们只返回单个值,且在批量插入时无法对齐行顺序;并发写入下还可能被其他会话干扰。

批量插入多行并返回全部 ID 的标准写法

用 VALUES 列出所有行,RETURNING 指定要返回的列(通常是主键):

INSERT INTO users (name, email) 
VALUES 
  ('Alice', 'alice@example.com'),
  ('Bob', 'bob@example.com'),
  ('Charlie', 'charlie@example.com')
RETURNING id, name;

执行后立即返回三行结果,每行包含对应插入记录的 id 和 name,顺序与 VALUES 中一致。

  • 必须显式列出字段名(如 users (name, email)),不能省略
  • RETURNING 可返回任意表达式,比如 RETURNING id, created_at AT TIME ZONE 'UTC'
  • 如果主键是 UUID 类型且由 gen_random_uuid() 生成,同样适用

和 ON CONFLICT 结合时 RETURNING 还生效吗?

生效,但只返回**实际插入或更新的行**。例如:

INSERT INTO users (id, name, email) 
VALUES (1, 'Alice', 'alice@new.com'), (2, 'Bob', 'bob@example.com')
ON CONFLICT (id) DO UPDATE SET name = EXCLUDED.name, email = EXCLUDED.email
RETURNING id, name, xmax = 0 AS is_inserted;

这里 xmax = 0 是个小技巧:若 xmax 为 0 表示该行是新插入的,否则是更新的。你可以用它区分操作类型。

  • ON CONFLICT ... DO NOTHING 时,RETURNING 只返回成功插入的行,冲突跳过的不出现
  • DO UPDATE 时,所有命中的行都会出现在结果中(无论是否真正修改了数据)
  • 不能在 DO UPDATE 的 SET 子句里引用 RETURNING 中的别名

用程序批量插入时要注意的边界情况

多数客户端驱动(如 Python 的 psycopg2、Go 的 pgx)都支持直接获取 RETURNING 结果集,但有几个关键点容易漏掉:

  • 参数化查询必须用 %s(psycopg2)或 $1, $2(pgx)占位符,不能拼字符串——否则 SQL 注入且 RETURNING 无法绑定
  • 一次插入行数不宜超过几千,PostgreSQL 单语句解析开销随行数非线性增长;超 5000 行建议分批
  • 如果主键是自增但用了 INSERT ... SELECT 方式(比如从另一张表导入),RETURNING 依然有效,但需确保 SELECT 的列顺序与目标表字段严格匹配

最常被忽略的是:当插入触发器(BEFORE INSERT)修改了 NEW.id,RETURNING id 返回的是触发器处理后的值——这本来是正确行为,但若没意识到触发器存在,会误以为 ID 被“偷偷改了”。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
postgresql常用命令
postgresql常用命令

postgresql常用命令psql、createdb、dropdb、createuser、dropuser、\l、\c、\dt、\d table_name、\du、\i file_name、\e和\q等。本专题为大家提供postgresql相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.10

233

5

常用的数据库软件
常用的数据库软件

常用的数据库软件有MySQL、Oracle、SQL Server、PostgreSQL、MongoDB、Redis、Cassandra、Hadoop、Spark和Amazon DynamoDB。更多关于数据库软件的内容详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.02

4909

19

postgresql常用命令有哪些
postgresql常用命令有哪些

postgresql常用命令psql、createdb、dropdb、createuser、dropuser、\l、\c、\dt、\d table_name、\du、\i file_name、\e和\q等。更详细的postgresql常用命令,大家可以访问下面的文章。

2023.11.16

647

3

postgresql常用命令介绍
postgresql常用命令介绍

postgresql常用命令有\l、\d、\d5、\di、\ds、\dv、\df、\dn、\db、\dg、\dp、\c、\pset、show search_path、ALTER TABLE、INSERT INTO、UPDATE、DELETE FROM、SELECT等。想了解更多postgresql的相关内容,可以阅读本专题下面的文章。

2023.11.20

1396

6

PostgreSQL性能优化与索引调优实战
PostgreSQL性能优化与索引调优实战

本专题面向后端开发与数据库工程师,深入讲解 PostgreSQL 查询优化原理与索引机制。内容包括执行计划分析、常见索引类型对比、慢查询优化策略、事务隔离级别以及高并发场景下的性能调优技巧。通过实战案例解析,帮助开发者提升数据库响应速度与系统稳定性。

2026.02.12

500

19

PostgreSQL 性能优化与查询执行计划实战
PostgreSQL 性能优化与查询执行计划实战

本专题深入解析PostgreSQL性能优化核心,聚焦查询执行计划的实战应用。通过EXPLAIN命令精准定位瓶颈,结合索引策略、SQL改写与参数调优,系统提升查询效率。从执行计划解读到性能调优全流程,助你掌握数据库性能诊断与优化实战能力。

2026.05.08

170

10

PostgreSQL 在 Next.js / Go 全栈架构中的工程化实践
PostgreSQL 在 Next.js / Go 全栈架构中的工程化实践

本文详解如何利用Next.js(搭配Drizzle ORM)与Go后端构建高性能应用,充分发挥PG在JSONB非结构化存储与pgvector向量检索上的优势。从数据建模到Docker容器化部署,打造支持AI时代的“One Database”工程化解决方案。

2026.05.08

901

10

PostgreSQL高级特性、内核机制与现代数据架构
PostgreSQL高级特性、内核机制与现代数据架构

本专题从MVCC并发控制与WAL日志等内核机制出发,详解JSONB、PostGIS及pgvector等高级特性。探讨如何利用单一引擎支撑关系型、向量及图数据等现代数据架构需求,助您掌握构建高并发、智能化应用的核心技术。

2026.05.08

244

10

数据库三范式
数据库三范式

数据库三范式是一种设计规范,用于规范化关系型数据库中的数据结构,它通过消除冗余数据、提高数据库性能和数据一致性,提供了一种有效的数据库设计方法。本专题提供数据库三范式相关的文章、下载和课程。

2023.06.29

3125

3

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习