ROLLBACK PREPARED
功能描述
在分布式数据库的两阶段提交(Two-Phase Commit, 2PC)过程中,事务的提交分为两个阶段:第一阶段执行PREPARE TRANSACTION将事务置为“预备”状态,第二阶段执行COMMIT PREPARED或ROLLBACK PREPARED完成提交或回滚。当预备事务因节点故障、网络异常或应用错误等原因未能正常进入第二阶段提交,而长时间停留在预备状态时,会持续持有锁和系统资源,影响其他事务的正常执行。此时,可使用ROLLBACK PREPARED命令取消该预备事务,释放其占用的资源。
典型业务场景包括:
- 分布式事务参与节点宕机后,预备事务无人终结,需要手动回滚清理。
- 应用层异常退出导致两阶段提交中断,预备事务残留需人工介入处理。
- 维护人员排查两阶段提交问题时,需要回滚特定预备事务以恢复系统正常状态。
- 两阶段提交第一阶段后,某个参与节点回复”无法提交”,协调者决定回滚整个事务。
注意事项
- 该功能仅在维护模式(GUC参数xc_maintenance_mode为on时)下可用。该模式谨慎打开,一般供维护人员排查问题使用,一般用户不应使用该模式。
- 要想回滚一个预备事务,必须是最初发起事务的用户,或者是系统管理员。
- 事务功能由数据库自动维护,用户不应显式使用事务功能。ROLLBACK PREPARED用于清理数据库内部创建的残留预备事务。在DWS分布式架构下,预备事务由内部分布式事务协调器(GTM)自动创建,不支持通过客户端手动执行PREPARE TRANSACTION。运维人员可通过查询pg_prepared_xacts视图查看残留的预备事务,并使用ROLLBACK PREPARED进行清理。
语法格式
1 | ROLLBACK PREPARED transaction_id ; |
参数说明
| 参数 | 描述 | 取值范围 |
|---|---|---|
| transaction_id | 待回滚的预备事务的标识符。该标识符为执行PREPARE TRANSACTION时指定的全局事务ID(GID),必须为当前已存在的预备事务的标识符。 | 字符串类型,最大长度为256个字符。不能与当前其他预备事务已使用的标识符冲突。示例值:'txn_transfer_002'。 |
示例
以下示例演示DWS运维中最常见的实际场景:查询数据库内部创建的残留预备事务,并通过ROLLBACK PREPARED命令回滚清理。
- 开启维护模式(开启后可能会造成数据不一致的风险,需联系技术支持人员后开启)。
1SET xc_maintenance_mode = on;
- 查询当前所有残留的预备事务,获取需要回滚的事务标识符(gid字段值)。
1SELECT transaction, gid, prepared, owner, database FROM pg_prepared_xacts;
预期输出(假设存在两个残留的预备事务):
1 2 3 4 5
transaction | gid | prepared | owner | database ------------+------------------+------------------------+----------+---------- 1234567 | txn_distribute_01| 2024-01-15 14:30:00+08 | app_user | db_test 1234568 | txn_distribute_02| 2024-01-15 15:00:00+08 | app_user | db_test (2 rows)
其中gid字段的值即为各预备事务的标识符,用于ROLLBACK PREPARED操作。
- 回滚第一个残留的预备事务。
1ROLLBACK PREPARED 'txn_distribute_01';
- 验证该预备事务是否已成功回滚。
1SELECT transaction, gid FROM pg_prepared_xacts WHERE gid = 'txn_distribute_01';
预期输出(查询返回空结果,表示已成功回滚):
1 2 3
transaction | gid ------------+----- (0 rows)
- 关闭维护模式。
1SET xc_maintenance_mode = off;
常见问题
ROLLBACK PREPARED执行报错“ERROR: prepared transaction with identifier xxx does not exist”如何处理?
A:此报错表示指定的transaction_id不存在于当前预备事务列表中。可能原因包括:
- 标识符拼写错误或大小写不匹配。
- 该预备事务已被其他会话提交或回滚。
- 该预备事务从未创建成功。
请通过查询pg_prepared_xacts视图确认当前存在的预备事务及其正确的gid值,注意标识符区分大小写,需使用单引号括起来。
ROLLBACK PREPARED和ROLLBACK有什么区别?
A:ROLLBACK用于回滚当前会话中活跃的普通事务;ROLLBACK PREPARED用于回滚已经通过PREPARE TRANSACTION进入预备状态的事务。预备事务已脱离创建它的会话,必须通过ROLLBACK PREPARED(需维护模式)来回滚,普通的ROLLBACK命令无法影响预备事务。
ROLLBACK PREPARED执行报错“Explicit prepare transaction is not supported”
A:未开启维护模式,请执行以下命令开启。
SET xc_maintenance_mode = on;