↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

支持中的版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发中的版本: 19 / 20devel
已结束支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1
历史版本。 PostgreSQL 11 已结束支持。 2023-11-09. 请参阅 当前版本手册.

SET CONSTRAINTS

SET CONSTRAINTS — 为当前事务设置约束检查时机

大纲

SET CONSTRAINTS { ALL | name [, ...] } { DEFERRED | IMMEDIATE }

描述

SET CONSTRAINTS 设置当前事务中约束检查的行为。IMMEDIATE 约束会在每条语句结束时检查。DEFERRED 约束要等到事务提交时才检查。每个约束都有各自的 IMMEDIATE 或 DEFERRED 模式。

创建约束时,它会被赋予以下三种特性之一:DEFERRABLE INITIALLY DEFERRED、DEFERRABLE INITIALLY IMMEDIATE 或者 NOT DEFERRABLE。第三类始终是 IMMEDIATE,不会受到 SET CONSTRAINTS 命令的影响。前两类在每个事务开始时都处于其指定的模式,但其行为可以在事务中通过 SET CONSTRAINTS 修改。

带约束名称列表的 SET CONSTRAINTS 只会修改这些约束的模式(它们都必须是可延迟的)。每个约束名称都可以带模式限定。如果未指定模式名称,就会使用当前模式搜索路径查找第一个匹配的名称。SET CONSTRAINTS ALL 会修改所有可延迟约束的模式。

当 SET CONSTRAINTS 将某个约束的模式从 DEFERRED 改为 IMMEDIATE 时,新模式具有追溯效力:任何原本会在事务结束时才检查的未决数据修改,都会改为在执行 SET CONSTRAINTS 命令期间检查。如果违反了任何此类约束,SET CONSTRAINTS 就会失败(并且不会改变该约束的模式)。因此,可以利用 SET CONSTRAINTS 强制在事务中的特定点执行约束检查。

当前,只有 UNIQUE、PRIMARY KEY、REFERENCES(外键)以及 EXCLUDE 约束受到这个设置的影响。NOT NULL 和 CHECK 约束总是在一行被插入或修改时立即检查(不是在语句结束时)。未声明为 DEFERRABLE 的唯一约束和排他约束也会立即检查。

被声明为“约束触发器”的触发器,其引发也受此设置控制 — 它们会在相关约束应当被检查的同时引发。

注解

因为 PostgreSQL 并不要求约束名称在同一模式内唯一(只要求在每个表内唯一),所以指定的约束名称有可能匹配到多个约束。在这种情况下,SET CONSTRAINTS 会作用于所有匹配项。对于未带模式限定的名称,一旦在搜索路径中的某个模式里找到一个或多个匹配项,就不会再搜索路径中更靠后的模式。

这个命令只会改变当前事务中约束的行为。在事务块之外发出该命令会产生一条警告,除此之外不会有任何效果。

兼容性

这个命令符合 SQL 标准定义的行为,但有一个限制:在 PostgreSQL 中,它不会应用在 NOT NULL 和 CHECK 约束上。此外,PostgreSQL 会立即检查不可延迟的唯一约束,而不是像标准所暗示的那样在语句结束时检查。

报告文档问题

阅读 上游文档. 反馈更正前请先核对 当前版本手册.