SQL COMMAND · 事务控制
SET CONSTRAINTS
为当前事务设置约束检查时机
set constraint check timing for the current transaction
SET事务控制引入 7.1现存至 20 devel1 次语法变更
- 动词
SET- 对象
CONSTRAINTS- 分组
- 事务控制
- 引入版本
- 7.1
- 状态
- 现存
- 语法变更次数
- 1
- 手册小节数
- 3
版本轨迹
相对 PostgreSQL 17 无变化。
语法铁道图 PostgreSQL 18
沿轨道从左向右阅读,分岔表示选择,绕行表示可选,回环表示重复。方框为参数,点击带下划线的参数可展开子规则。
语法概要
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 会立即检查不可延迟的唯一约束,而不是像标准所暗示的那样在语句结束时检查。
语法演化
相邻大版本之间的差异,新的在前。版本号链接到对应快照。
PostgreSQL 10← 9.6正文更新
正文更新PostgreSQL 9.4← 9.3正文更新
正文更新PostgreSQL 9.0← 8.4正文更新
正文更新PostgreSQL 8.3← 8.2正文更新
正文更新PostgreSQL 8.2← 8.1正文更新
正文更新PostgreSQL 8.0← 7.4正文更新
正文更新PostgreSQL 7.4← 7.3语法变化
+ SET CONSTRAINTS { ALL | name [, ...] } { DEFERRED | IMMEDIATE }− SET CONSTRAINTS { ALL | constraint [, ...] } { DEFERRED | IMMEDIATE }正文更新PostgreSQL 7.3← 7.2正文更新
正文更新PostgreSQL 7.2← 7.1正文更新
正文更新PostgreSQL 7.1← 7.0新增此命令
同组命令
| 命令 | 动词 | 对象 | 版本变动 | 最近变更 |
|---|---|---|---|---|
ABORT | ABORT | — | 123 次 | |
| 中止当前事务 | 现存 | |||
BEGIN | BEGIN | — | 9.13 次 | |
| 开始一个事务块 | 现存 | |||
COMMIT | COMMIT | — | 121 次 | |
| 提交当前事务 | 现存 | |||
END | END | — | 121 次 | |
| 提交当前事务 | 现存 | |||
ROLLBACK | ROLLBACK | — | 122 次 | |
| 中止当前事务 | 现存 | |||
SAVEPOINT | SAVEPOINT | — | — | |
| 在当前事务中定义一个新的保存点 | 现存 | |||
WAIT | WAIT | — | — | |
| 等待 WAL 达到目标 LSN | 现存 | |||
SET CONSTRAINTS | SET | CONSTRAINTS | 7.41 次 | |
| 为当前事务设置约束检查时机 | 现存 | |||
COMMIT PREPARED | COMMIT | PREPARED | — | |
| 提交一个先前为两阶段提交而预备的事务 | 现存 | |||
ROLLBACK PREPARED | ROLLBACK | PREPARED | — | |
| 回滚一个先前为两阶段提交而预备的事务 | 现存 | |||
RELEASE SAVEPOINT | RELEASE | SAVEPOINT | — | |
| 释放一个先前定义的保存点 | 现存 | |||
ROLLBACK TO SAVEPOINT | ROLLBACK | TO SAVEPOINT | — | |
| 回滚到一个保存点 | 现存 | |||
PREPARE TRANSACTION | PREPARE | TRANSACTION | — | |
| 为两阶段提交准备当前事务 | 现存 | |||
SET TRANSACTION | SET | TRANSACTION | 9.25 次 | |
| 设置当前事务的特性 | 现存 | |||
START TRANSACTION | START | TRANSACTION | 9.14 次 | |
| 开始一个事务块 | 现存 | |||
BEGIN WORK | BEGIN | WORK | — | |
| 开始一个事务 | 于 6.5 移除 | |||