SQL COMMAND · 事务控制
PREPARE TRANSACTION
为两阶段提交准备当前事务
PREPARE事务控制引入 10(基线)现存至 20 devel0 次语法变更
- 动词
PREPARE- 对象
TRANSACTION- 分组
- 事务控制
- 引入版本
- 10(基线)
- 状态
- 现存
- 语法变更次数
- 0
- 手册小节数
- 6
版本轨迹
相对 PostgreSQL 17 无变化。
语法铁道图 PostgreSQL 18
沿轨道从左向右阅读,分岔表示选择,绕行表示可选,回环表示重复。方框为参数,点击带下划线的参数可展开子规则。
语法概要
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启动事务块。
当前不允许将执行过以下任一操作的事务置为预备状态:涉及临时表或会话临时命名空间的操作、创建任何WITH HOLD游标,或执行过LISTEN、UNLISTEN或NOTIFY。这些特性与当前会话绑定得过于紧密,因此在要进入预备状态的事务中没有意义。
如果该事务曾用SET修改过任何运行时参数(且未使用LOCAL选项),那么这些效果在执行PREPARE TRANSACTION之后仍会保留,并且不会受到后续任何COMMIT PREPARED或ROLLBACK PREPARED的影响。因此,仅就这一点而言,PREPARE TRANSACTION的行为更像COMMIT而不是ROLLBACK。
当前所有处于预备状态的事务都列在pg_prepared_xacts系统视图中。
Caution
让事务长时间停留在预备状态并不明智。这会妨碍VACUUM回收存储空间,在极端情况下甚至可能导致数据库为防止事务 ID 回卷而关闭(见Section 24.1.5)。还要记住,该事务会继续持有它原本持有的所有锁。此功能的预期用法是:一旦外部事务管理器确认其他数据库也已准备好提交,就尽快提交或回滚该预备事务。
如果没有设置外部事务管理器来跟踪预备事务并确保它们能被及时结束,最好将max_prepared_transactions设为零,从而禁用预备事务功能。这样可以防止意外创建预备事务,而这些事务随后可能被遗忘并最终引发问题。
示例
为两阶段提交准备当前事务,并使用foobar作为事务标识符:
PREPARE TRANSACTION 'foobar';
兼容性
PREPARE TRANSACTION是PostgreSQL扩展。它供外部事务管理系统使用,其中有些系统受标准约束(例如 X/Open XA),但这些系统的 SQL 侧并未标准化。
另见
语法演化
相邻大版本之间的差异,新的在前。版本号链接到对应快照。
PostgreSQL 14← 13正文更新
正文更新
同组命令
| 命令 | 动词 | 对象 | 版本变动 | 最近变更 |
|---|---|---|---|---|
ABORT | ABORT | — | 121 次 | |
| 中止当前事务 | 现存 | |||
BEGIN | BEGIN | — | — | |
| 开始一个事务块 | 现存 | |||
COMMIT | COMMIT | — | 121 次 | |
| 提交当前事务 | 现存 | |||
END | END | — | 121 次 | |
| 提交当前事务 | 现存 | |||
ROLLBACK | ROLLBACK | — | 121 次 | |
| 中止当前事务 | 现存 | |||
SAVEPOINT | SAVEPOINT | — | — | |
| 在当前事务中定义一个新的保存点 | 现存 | |||
SET CONSTRAINTS | SET | CONSTRAINTS | — | |
| 为当前事务设置约束检查时机 | 现存 | |||
WAIT FOR | WAIT | FOR | — | |
| 等待 WAL 达到目标 LSN | 现存 | |||
COMMIT PREPARED | COMMIT | PREPARED | — | |
| 提交一个先前为两阶段提交而预备的事务 | 现存 | |||
ROLLBACK PREPARED | ROLLBACK | PREPARED | — | |
| 回滚一个先前为两阶段提交而预备的事务 | 现存 | |||
RELEASE SAVEPOINT | RELEASE | SAVEPOINT | — | |
| 释放一个先前定义的保存点 | 现存 | |||
ROLLBACK TO SAVEPOINT | ROLLBACK | TO SAVEPOINT | — | |
| 回滚到一个保存点 | 现存 | |||
PREPARE TRANSACTION | PREPARE | TRANSACTION | — | |
| 为两阶段提交准备当前事务 | 现存 | |||
SET TRANSACTION | SET | TRANSACTION | — | |
| 设置当前事务的特性 | 现存 | |||
START TRANSACTION | START | TRANSACTION | — | |
| 开始一个事务块 | 现存 | |||