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

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 启动一个事务。

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

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

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

警告

长时间将事务保留在准备状态是不明智的。这会妨碍 VACUUM 回收存储的能力,在极端情况下可能会导致数据库关闭以防止事务 ID 回绕(参见 第 24.1.5 节)。还要记住,事务会继续持有它所持有的任何锁。该功能的预期用途是,准备的事务通常会在外部事务管理器验证其他数据库也已准备好提交后立即提交或回滚。

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

示例

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

PREPARE TRANSACTION 'foobar';

兼容性

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

提交更正

如果您在文档中发现任何不正确的内容、不符合您对特定功能的体验或需要进一步说明,请使用 此表格 报告文档问题。