↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

百科 / SQL 命令 / 事务控制

SQL COMMAND · 事务控制

SET TRANSACTION

设置当前事务的特性

set the characteristics of the current transaction

SET事务控制引入 7.1现存至 20 devel5 次语法变更

动词
SET
对象
TRANSACTION
引入版本
7.1
状态
现存
语法变更次数
5
手册小节数
4

本站手册 · 18官方文档 ↗

版本轨迹

相对 PostgreSQL 17 无变化。

语法铁道图 PostgreSQL 18

沿轨道从左向右阅读,分岔表示选择,绕行表示可选,回环表示重复。方框为参数,点击带下划线的参数可展开子规则。

SET TRANSACTION transaction_mode ,
SET TRANSACTION · 语法 2
SET TRANSACTION SNAPSHOT snapshot_id
SET TRANSACTION · 语法 3
SET SESSION CHARACTERISTICS AS TRANSACTION transaction_mode ,
transaction_mode
ISOLATION LEVEL SERIALIZABLE REPEATABLE READ READ COMMITTED READ UNCOMMITTED READ WRITE READ ONLY NOT DEFERRABLE

语法概要

SET TRANSACTION transaction_mode [, ...]
SET TRANSACTION SNAPSHOT snapshot_id
SET SESSION CHARACTERISTICS AS TRANSACTION transaction_mode [, ...]

其中 transaction_mode 是下列之一:

ISOLATION LEVEL { SERIALIZABLE | REPEATABLE READ | READ COMMITTED | READ UNCOMMITTED }
READ WRITE | READ ONLY
[ NOT ] DEFERRABLE

PostgreSQL 18 手册 · 查看完整参考页

描述

SET TRANSACTION 命令设置当前事务的特性。它对任何后续事务都没有影响。SET SESSION CHARACTERISTICS 设置一个会话中后续事务的默认事务特性。对于单个事务,这些默认值可以用 SET TRANSACTION 覆盖。

可用的事务特性是事务隔离级别、事务访问模式(读/写或只读)以及可延迟模式。此外,还可以选择一个快照,不过它只能用于当前事务,不能作为会话默认值。

一个事务的隔离级别决定当其他事务并发运行时该事务能看见什么数据:

READ COMMITTED

一条语句只能看到在它开始之前已提交的行。这是默认值。

REPEATABLE READ

当前事务中的所有语句都只能看到在该事务中执行第一条查询或数据修改语句之前已提交的行。

SERIALIZABLE

当前事务中的所有语句都只能看到在该事务中执行第一条查询或数据修改语句之前已提交的行。如果并发的可串行化事务之间出现某种读写模式,而这种情况不可能在这些事务的任何串行(一次执行一个)执行中发生,那么其中一个事务将以 serialization_failure 错误回滚。

SQL 标准还定义了一个额外的级别:READ UNCOMMITTED。在 PostgreSQL 中,READ UNCOMMITTED 被视为 READ COMMITTED。

在事务执行第一条查询或数据修改语句(SELECT,INSERT,DELETE,UPDATE,MERGE,FETCH,或 COPY)之后,事务隔离级别就不能再更改。有关事务隔离和并发控制的更多信息,请参见第 13 章。

事务访问模式决定事务是读/写还是只读。读/写是默认值。当事务为只读时,下列 SQL 命令会被禁止:INSERT、UPDATE、DELETE、MERGE 以及 COPY FROM,前提是它们要写入的表不是临时表;所有 CREATE、ALTER 和 DROP 命令;COMMENT、GRANT、REVOKE、TRUNCATE;以及 EXPLAIN ANALYZE 和 EXECUTE,前提是它们要执行的命令属于上述列表。这是一个较高层面的只读概念,并不会阻止所有写入磁盘的行为。

只有当事务同时是 SERIALIZABLE 和 READ ONLY 时,DEFERRABLE 事务属性才会生效。当为一个事务同时选择这三个属性时,该事务在首次获取其快照时可能会阻塞;在此之后,它便可以运行,而无需承担普通 SERIALIZABLE 事务的常规开销,也不会有促成串行化失败或因串行化失败而被取消的风险。这种模式非常适合长时间运行的报表或备份。

SET TRANSACTION SNAPSHOT 命令允许一个新事务使用与现有事务相同的快照运行。已有事务必须用 pg_export_snapshot 函数导出其快照(参见第 9.28.5 节)。该函数会返回一个快照标识符,必须将其提供给 SET TRANSACTION SNAPSHOT 以指定要导入的快照。该标识符在此命令中必须写成字符串字面量,例如 '00000003-0000001B-1'。SET TRANSACTION SNAPSHOT 只能在事务开始时执行,也就是在事务的第一条查询或数据修改语句(SELECT、INSERT、DELETE、UPDATE、MERGE、FETCH 或 COPY)之前。此外,事务还必须已经设置为 SERIALIZABLE 或 REPEATABLE READ 隔离级别(否则,快照会被立即丢弃,因为 READ COMMITTED 模式会为每条命令获取一个新快照)。如果导入事务使用 SERIALIZABLE 隔离级别,则导出快照的事务也必须使用该隔离级别。此外,非只读的可串行化事务不能从只读事务导入快照。

注解

如果执行 SET TRANSACTION 之前没有 START TRANSACTION 或者 BEGIN,它会发出一条警告,除此之外没有任何效果。

可以不使用 SET TRANSACTION,而是在 BEGIN 或 START TRANSACTION 中指定所需的 transaction_modes。但是,对于 SET TRANSACTION SNAPSHOT,这种方式不可用。

会话默认的事务模式也可以通过配置参数 default_transaction_isolation、default_transaction_read_only 和 default_transaction_deferrable 来设置或检查(实际上,SET SESSION CHARACTERISTICS 只是用 SET 设置这些变量的一种更冗长的等价写法)。这意味着可以通过配置文件、ALTER DATABASE 等方式设置默认值。详见第 19 章。

当前事务的模式也可以类似地通过配置参数 transaction_isolation、transaction_read_only 和 transaction_deferrable 来设置或检查。设置其中任一参数的作用都与对应的 SET TRANSACTION 选项相同,并且在可设置时机方面有相同的限制。但是,这些参数不能在配置文件中设置,也不能通过实时执行的 SQL 之外的任何来源来设置。

示例

要以与某个现有事务相同的快照开始一个新事务,先从该现有事务导出快照。这样会返回快照标识符,例如:

BEGIN TRANSACTION ISOLATION LEVEL REPEATABLE READ;
SELECT pg_export_snapshot();
 pg_export_snapshot
---------------------
 00000003-0000001B-1
(1 row)

然后在新开启事务的开始处,通过 SET TRANSACTION SNAPSHOT 命令给出该快照标识符:

BEGIN TRANSACTION ISOLATION LEVEL REPEATABLE READ;
SET TRANSACTION SNAPSHOT '00000003-0000001B-1';

兼容性

这些命令由 SQL 标准定义,但 DEFERRABLE 事务模式和 SET TRANSACTION SNAPSHOT 这种形式除外,它们是 PostgreSQL 扩展。

SERIALIZABLE 是标准中的默认事务隔离级别。在 PostgreSQL 中,默认值通常是 READ COMMITTED,但你可以按上述方式修改。

在 SQL 标准中,还可以用这些命令设置另一项事务特性:诊断区域的大小。这个概念特定于嵌入式 SQL,因此没有在 PostgreSQL 服务器中实现。

SQL 标准要求在连续的 transaction_modes 之间有逗号,但出于历史原因,PostgreSQL 允许省略逗号。

语法演化

相邻大版本之间的差异,新的在前。版本号链接到对应快照。

  1. PostgreSQL 19← 18正文更新

    正文更新
  2. PostgreSQL 17← 16正文更新

    正文更新
  3. PostgreSQL 15← 14正文更新

    正文更新
  4. PostgreSQL 14← 13正文更新

    正文更新
  5. PostgreSQL 13← 12正文更新

    正文更新
  6. PostgreSQL 10← 9.6正文更新

    正文更新
  7. PostgreSQL 9.6← 9.5正文更新

    正文更新
  8. PostgreSQL 9.4← 9.3正文更新

    正文更新
  9. PostgreSQL 9.2← 9.1语法变化

    + SET TRANSACTION SNAPSHOT snapshot_id正文更新
  10. PostgreSQL 9.1← 9.0语法变化

    + [ NOT ] DEFERRABLE正文更新
  11. PostgreSQL 9.0← 8.4语法变化

    − where transaction_mode is one of:
  12. PostgreSQL 8.3← 8.2正文更新

    正文更新
  13. PostgreSQL 8.1← 8.0正文更新

    正文更新
  14. PostgreSQL 8.0← 7.4语法变化

    + SET TRANSACTION transaction_mode [, ...]+ SET SESSION CHARACTERISTICS AS TRANSACTION transaction_mode [, ...]+ where transaction_mode is one of:+ ISOLATION LEVEL { SERIALIZABLE | REPEATABLE READ | READ COMMITTED | READ UNCOMMITTED }− [ ISOLATION LEVEL { READ COMMITTED | SERIALIZABLE } ] [ READ WRITE | READ ONLY ]− [ ISOLATION LEVEL { READ COMMITTED | SERIALIZABLE } ] [ READ WRITE | READ ONLY ]正文更新
  15. PostgreSQL 7.4← 7.3语法变化

    + [ ISOLATION LEVEL { READ COMMITTED | SERIALIZABLE } ] [ READ WRITE | READ ONLY ]+ [ ISOLATION LEVEL { READ COMMITTED | SERIALIZABLE } ] [ READ WRITE | READ ONLY ]正文更新
  16. PostgreSQL 7.3← 7.2正文更新

    正文更新
  17. PostgreSQL 7.2← 7.1正文更新

    正文更新
  18. PostgreSQL 7.1← 7.0新增此命令

同组命令

命令动词对象版本变动最近变更
TRANSACTIONS事务控制16 条↑
ABORTABORT— 123 次
中止当前事务现存
BEGINBEGIN— 9.13 次
开始一个事务块现存
COMMITCOMMIT— 121 次
提交当前事务现存
ENDEND— 121 次
提交当前事务现存
ROLLBACKROLLBACK— 122 次
中止当前事务现存
SAVEPOINTSAVEPOINT— —
在当前事务中定义一个新的保存点现存
WAITWAIT— —
等待 WAL 达到目标 LSN现存
SET CONSTRAINTSSETCONSTRAINTS 7.41 次
为当前事务设置约束检查时机现存
COMMIT PREPAREDCOMMITPREPARED —
提交一个先前为两阶段提交而预备的事务现存
ROLLBACK PREPAREDROLLBACKPREPARED —
回滚一个先前为两阶段提交而预备的事务现存
RELEASE SAVEPOINTRELEASESAVEPOINT —
释放一个先前定义的保存点现存
ROLLBACK TO SAVEPOINTROLLBACKTO SAVEPOINT —
回滚到一个保存点现存
PREPARE TRANSACTIONPREPARETRANSACTION —
为两阶段提交准备当前事务现存
SET TRANSACTIONSETTRANSACTION 9.25 次
设置当前事务的特性现存
START TRANSACTIONSTARTTRANSACTION 9.14 次
开始一个事务块现存
BEGIN WORKBEGINWORK —
开始一个事务于 6.5 移除