讲师中心 微信公众号
AI工具推荐 视频效率加速

如何在PostgreSQL中批量插入数据时跳过违反唯一约束的行?

浅芳吖_7495

浅芳吖_7495

发布时间:2026-08-01 15:39:21

|

792人浏览过

|

来源于php中文网

原创

能,INSERT ... ON CONFLICT DO NOTHING 可跳过冲突行,需显式指定冲突列(如 ON CONFLICT (email))或约束名,否则报错;它原子性处理冲突,避免事务中断,不返回跳过行数。

如何在postgresql中批量插入数据时跳过违反唯一约束的行?

INSERT ... ON CONFLICT DO NOTHING 能跳过冲突行吗?

能,这是 PostgreSQL 9.5+ 最直接、最安全的方案。它不是“忽略错误后继续”,而是主动把冲突当作正常流程处理,避免事务中断。

常见错误是误用 ON CONFLICT 但没指定冲突目标(比如漏写 ON CONFLICT (column_name)),结果触发 ERROR: there is no unique or exclusion constraint matching the ON CONFLICT specification。

  • 必须明确写出冲突列或约束名:用 ON CONFLICT (email)(列名)或 ON CONFLICT ON CONSTRAINT users_email_key(约束名)
  • 如果表有多个唯一约束(如 email 和 phone),只声明其中一个,其他冲突仍会报错
  • DO NOTHING 不会返回被跳过的行数,想统计需额外用 RETURNING 配合临时表或 CTE

批量插入时用 VALUES 还是 FROM 子查询?

优先用 VALUES 列表,语义清晰、性能好;FROM 子查询适合数据来自其他表或需复杂过滤的场景。

注意:当插入大量行(比如上万)时,单条含几千 VALUES 的语句可能触发内存或协议限制,PostgreSQL 默认 max_locks_per_transaction 或网络缓冲可能成为瓶颈。

PostgreSQL 18.4 ubuntu
PostgreSQL 18.4 ubuntu

PostgreSQL 18.4 官方 Ubuntu 安装包现已发布,这是目前最新的稳定版本。推荐通过官方 APT 仓库安装:先执行 sudo apt update 更新索引,再运行 sudo apt install postgresql-18 即可完成部署。新版本引入了异步 I/O 子系统,在顺序扫描与 VACUUM 场景下性能提升显著,同时支持 UUID v7 原生生成函数与虚拟生成列。

下载
  • 稳妥做法是分批插入,每批 100–1000 行,用循环或客户端逻辑控制
  • 不要在 VALUES 里混用不同数据类型(如 '1' 和 1),否则可能触发隐式转换失败
  • 若从 CSV 导入,COPY ... ON CONFLICT 不支持,得先导入临时表,再用 INSERT ... SELECT ... ON CONFLICT

为什么不能用 INSERT IGNORE 或 REPLACE INTO?

PostgreSQL 没有 INSERT IGNORE(MySQL)或 REPLACE INTO(SQLite/MySQL)语法。强行模仿——比如先 DELETE 再 INSERT——会破坏原子性,且在高并发下极易出错。

典型翻车场景:两个事务同时发现某行不存在,都执行 INSERT,结果一个成功一个因唯一冲突失败,但若你用 DELETE + INSERT 代替,可能删掉对方刚插入的行。

  • ON CONFLICT DO UPDATE 是替代 REPLACE 的正确方式,但要注意 EXCLUDED 别名的使用(如 SET updated_at = EXCLUDED.updated_at)
  • 试图用 WHERE NOT EXISTS 包裹 INSERT 也无效:在并发下,NOT EXISTS 检查和 INSERT 不是一次原子操作
  • 触发器里做去重?不可靠。触发器无法阻止唯一索引报错,且增加开销

ON CONFLICT 在 UPSERT 场景下容易被忽略的细节

真正难的不是语法,而是理解“冲突判定时机”和“约束覆盖范围”。例如,唯一索引允许 NULL,但 NULL != NULL,所以多行 NULL 值不会触发冲突——这常被当成 bug,其实是 SQL 标准行为。

  • 复合唯一约束(如 UNIQUE (tenant_id, code))下,只有两列值完全相同时才冲突;单独一列重复不触发
  • 部分索引(CREATE UNIQUE INDEX ... WHERE status = 'active')也会被 ON CONFLICT 识别,但必须确保插入数据满足 WHERE 条件才会检查该索引
  • 如果用了 DEFERRABLE 唯一约束,ON CONFLICT 默认不生效,得配合 SET CONSTRAINTS ... DEFERRED 才行,极少需要

热门AI工具

更多
墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

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

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

213

2023.10.10

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

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

4149

2023.11.02

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

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

607

2023.11.16

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的相关内容,可以阅读本专题下面的文章。

1356

2023.11.20

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

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

440

2026.02.12

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

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

130

2026.05.08

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

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

881

2026.05.08

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

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

224

2026.05.08

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

80

2026.09.23

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL vs MySQL
PostgreSQL vs MySQL

共1课时 | 176人学习

PostgreSQL 教程
PostgreSQL 教程

共48课时 | 20.1万人学习

PostgreSQL 手册
PostgreSQL 手册

共0课时 | 1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn