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 覆盖，以用于单个事务。

可用的事务特性有事务隔离级别、事务访问模式（读/写或只读）和可推迟模式。此外，可以选择一个快照，但只能用于当前事务，不能作为会话默认值。

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

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.27.5 节）。该函数返回一个快照标识符，该标识符必须提供给 SET TRANSACTION SNAPSHOT 以指定要导入哪个快照。标识符必须在此命令中写为字符串文字，例如 '00000003-0000001B-1'。 SET TRANSACTION SNAPSHOT 只能在事务开始时执行，即在事务的第一个查询或数据修改语句（SELECT、INSERT、DELETE、UPDATE、MERGE、FETCH 或 COPY）之前执行。此外，事务必须已设置为 SERIALIZABLE 或 REPEATABLE READ 隔离级别（否则，快照将立即丢弃，因为 READ COMMITTED 模式为每个命令获取一个新快照）。如果导入事务使用 SERIALIZABLE 隔离级别，则导出快照的事务也必须使用该隔离级别。此外，非只读可序列化事务无法从只读事务中导入快照。

注释

如果在没有先前的 START TRANSACTION 或 BEGIN 的情况下执行 SET TRANSACTION，它将发出警告，否则无效。

可以通过在 BEGIN 或 START TRANSACTION 中指定所需的 transaction_modes 来取消 SET TRANSACTION。但该选项不适用于 SET TRANSACTION SNAPSHOT。

还可以通过配置参数 default_transaction_isolation、default_transaction_read_only 和 default_transaction_deferrable 设置或检查会话默认事务模式。（实际上 SET SESSION CHARACTERISTICS 只是使用 SET 设置这些变量的详细等效项。）这意味着可以在配置文件中、通过 ALTER DATABASE 等设置默认值。有关更多信息，请参阅 第 20 章。

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