PREPARE TRANSACTION

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

概要

PREPARE TRANSACTION transaction_id

说明

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

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

从发出会话的角度来看，PREPARE TRANSACTION与ROLLBACK命令类似：执行后，没有活动当前事务，并且已准备事务的效果不再可见。（如果提交事务，效果将再次可见。）

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

参数

transaction_id

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

备注

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

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

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

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

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

警告

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

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

示例

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

PREPARE TRANSACTION 'foobar';

兼容性

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

另请参阅

COMMIT PREPARED，ROLLBACK PREPARED