2024 年 9 月 26 日: PostgreSQL 17 发布!
支持版本:当前 (17) / 16 / 15 / 14 / 13 / 12
开发版本:devel
不支持的版本: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

SET TRANSACTION

SET TRANSACTION — 设置当前事务的特性

概要

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

where transaction_mode is one of:

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

描述

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

可用的事务特性包括事务隔离级别、事务访问模式(读/写或只读)和可延迟模式。此外,可以为当前事务选择快照,但不能作为会话默认值。

事务的隔离级别决定了当其他事务并发运行时事务可以看到哪些数据。

READ COMMITTED

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

REPEATABLE READ

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

SERIALIZABLE

当前事务的所有语句只能看到在当前事务中执行第一个查询或数据修改语句之前提交的行。如果并发可序列化事务之间的读写模式会创建一个在任何可序列化(一次一个)执行这些事务的情况下都不会出现的情况,其中一个事务将被回滚并出现 serialization_failure 错误。

SQL 标准定义了另一个级别,READ UNCOMMITTED。在 PostgreSQL 中,READ UNCOMMITTED 被视为 READ COMMITTED

在执行事务的第一个查询或数据修改语句(SELECTINSERTDELETEUPDATEMERGEFETCHCOPY)之后,不能更改事务隔离级别。有关事务隔离和并发控制的更多信息,请参阅 第 13 章

事务访问模式决定了事务是读/写还是只读。读/写是默认值。当事务为只读时,以下 SQL 命令将被禁止:INSERTUPDATEDELETEMERGECOPY FROM(如果它们要写入的表不是临时表);所有 CREATEALTERDROP 命令;COMMENTGRANTREVOKETRUNCATE;以及 EXPLAIN ANALYZEEXECUTE(如果它们要执行的命令属于上述命令)。这是一种高级的只读概念,不会阻止所有写入磁盘的操作。

除非事务也是 SERIALIZABLEREAD ONLY,否则 DEFERRABLE 事务属性不会产生任何影响。当为事务选择所有这三个属性时,事务可能会在第一次获取快照时阻塞,之后它能够在没有 SERIALIZABLE 事务的正常开销的情况下运行,并且不会有任何导致或被序列化失败取消的风险。这种模式非常适合长时间运行的报告或备份。

SET TRANSACTION SNAPSHOT 命令允许一个新事务使用与现有事务相同的 快照 运行。预先存在的事务必须使用 pg_export_snapshot 函数导出其快照(请参阅 第 9.28.5 节)。该函数返回一个快照标识符,该标识符必须传递给 SET TRANSACTION SNAPSHOT 来指定要导入的快照。在该命令中,标识符必须作为字符串文字写入,例如 '00000003-0000001B-1'SET TRANSACTION SNAPSHOT 只能在事务开始时执行,在执行事务的第一个查询或数据修改语句(SELECTINSERTDELETEUPDATEMERGEFETCHCOPY)之前。此外,事务必须已经设置为 SERIALIZABLEREPEATABLE READ 隔离级别(否则,快照将立即被丢弃,因为 READ COMMITTED 模式为每个命令获取新的快照)。如果导入的事务使用 SERIALIZABLE 隔离级别,那么导出快照的事务也必须使用该隔离级别。此外,不可读写的可序列化事务不能从只读事务导入快照。

注释

如果在没有先前的 START TRANSACTIONBEGIN 的情况下执行 SET TRANSACTION,它会发出警告,否则不会产生任何影响。

可以通过在 BEGINSTART TRANSACTION 中指定所需的 transaction_modes 来省去 SET TRANSACTION。但是,该选项不适用于 SET TRANSACTION SNAPSHOT

会话默认事务模式也可以通过配置参数 default_transaction_isolationdefault_transaction_read_onlydefault_transaction_deferrable 来设置或检查。(实际上,SET SESSION CHARACTERISTICS 只是使用 SET 设置这些变量的冗长等价物。)这意味着可以在配置文件中设置默认值,通过 ALTER DATABASE 等。有关更多信息,请参阅 第 19 章

当前事务的模式也可以通过配置参数 transaction_isolationtransaction_read_onlytransaction_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 允许省略逗号。

提交更正

如果您在文档中看到任何不正确的内容、与您对特定功能的体验不符或需要进一步澄清,请使用 此表单 报告文档问题。