Redrock Postgres 搜索 英文
版本: 9.3 / 9.4 / 9.5 / 9.6 / 10 / 11 / 12 / 13 / 14 / 15 / 16

PREPARE TRANSACTION

PREPARE TRANSACTION — 为两阶段提交准备当前事务

概要

PREPARE TRANSACTION transaction_id

说明

PREPARE TRANSACTION 为两阶段提交准备当前事务。此命令执行后,事务将不再与当前会话关联;相反,其状态将完全存储在磁盘上,并且即使在请求提交之前发生数据库崩溃,也极有可能成功提交。

准备完毕后,稍后可以使用 COMMIT PREPAREDROLLBACK PREPARED 分别提交或回滚事务。这些命令可以从任何会话发出,而不仅仅是执行原始事务的会话。

从发出会话的角度来看,PREPARE TRANSACTIONROLLBACK 命令类似:执行后,没有活动当前事务,并且已准备事务的效果不再可见。(如果提交事务,效果将再次可见。)

如果 PREPARE TRANSACTION 命令因任何原因失败,它将变为 ROLLBACK:当前事务将被取消。

参数

transaction_id

用于稍后为 COMMIT PREPAREDROLLBACK PREPARED 标识此事务的任意标识符。该标识符必须写为字符串文字,并且长度必须小于 200 个字节。它不能与用于任何当前已准备事务的标识符相同。

备注

PREPARE TRANSACTION 不适用于应用程序或交互式会话。其目的是允许外部事务管理器在多个数据库或其他事务资源中执行原子全局事务。除非您正在编写事务管理器,否则您可能不应该使用 PREPARE TRANSACTION

此命令必须在事务块内使用。使用 BEGIN 开始事务。

目前不允许 PREPARE 已执行涉及临时表或会话临时命名空间的任何操作、创建任何 WITH HOLD 游标或执行 LISTENUNLISTENNOTIFY 的事务。这些功能与当前会话联系得太紧密,无法在要准备的事务中使用。

如果事务使用 SET(不带 LOCAL 选项)修改了任何运行时参数,则这些影响会在 PREPARE TRANSACTION 之后仍然存在,并且不会受到任何后续的 COMMIT PREPAREDROLLBACK PREPARED 的影响。因此,在这一方面,PREPARE TRANSACTION 的行为更像 COMMIT,而不是 ROLLBACK

所有当前可用的已准备事务都列在 pg_prepared_xacts 系统视图中。

警告

不建议将事务长时间保留在已准备状态。这会影响 VACUUM 回收存储的能力,在极端情况下可能会导致数据库关闭以防止事务 ID 环绕(请参阅 第 25.1.5 节)。还要记住,事务将继续持有它所持有的任何锁。该功能的预期用法是,一旦外部事务管理器验证其他数据库也已准备提交,通常会提交或回滚已准备的事务。

如果您尚未设置外部事务管理器来跟踪已准备的事务并确保及时关闭它们,则最好通过将 max_prepared_transactions 设置为零来禁用已准备事务功能。这将防止意外创建已准备的事务,这些事务可能会被遗忘并最终导致问题。

示例

使用 foobar 作为事务标识符,为两阶段提交准备当前事务

PREPARE TRANSACTION 'foobar';

兼容性

PREPARE TRANSACTIONPostgreSQL 扩展。它旨在供外部事务管理系统使用,其中一些系统受标准(例如 X/Open XA)涵盖,但这些系统的 SQL 方面并未标准化。

另请参阅

COMMIT PREPAREDROLLBACK PREPARED