SET TRANSACTION — 设置当前事务的特性
SET TRANSACTIONtransaction_mode
[, ...] SET TRANSACTION SNAPSHOTsnapshot_id
SET SESSION CHARACTERISTICS AS TRANSACTIONtransaction_mode
[, ...] wheretransaction_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
。
在执行事务的第一个查询或数据修改语句(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
隔离级别,那么导出快照的事务也必须使用该隔离级别。此外,不可读写的可序列化事务不能从只读事务导入快照。
如果在没有先前的 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
等。有关更多信息,请参阅 第 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 允许省略逗号。
如果您在文档中看到任何不正确的内容、与您对特定功能的体验不符或需要进一步澄清,请使用 此表单 报告文档问题。