更新时间:2026-11-20 GMT+08:00

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 ;

参数说明

表1 ROLLBACK PREPARED参数说明

参数

描述

取值范围

transaction_id

待回滚的预备事务的标识符。该标识符为执行PREPARE TRANSACTION时指定的全局事务ID(GID),必须为当前已存在的预备事务的标识符。

字符串类型,最大长度为256个字符。不能与当前其他预备事务已使用的标识符冲突。示例值:'txn_transfer_002'。

示例

以下示例演示DWS运维中最常见的实际场景:查询数据库内部创建的残留预备事务,并通过ROLLBACK PREPARED命令回滚清理。

  1. 开启维护模式(开启后可能会造成数据不一致的风险,需联系技术支持人员后开启)。

    1
    SET xc_maintenance_mode = on;
    

  2. 查询当前所有残留的预备事务,获取需要回滚的事务标识符(gid字段值)。

    1
    SELECT 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操作。

  3. 回滚第一个残留的预备事务。

    1
    ROLLBACK PREPARED 'txn_distribute_01';
    

  4. 验证该预备事务是否已成功回滚。

    1
    SELECT transaction, gid FROM pg_prepared_xacts WHERE gid = 'txn_distribute_01';
    

    预期输出(查询返回空结果,表示已成功回滚):

    1
    2
    3
    transaction | gid
    ------------+-----
    (0 rows)
    

  5. 关闭维护模式。

    1
    SET 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;