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

COMMIT PREPARED

功能描述

在分布式数据库的两阶段提交(Two-Phase Commit, 2PC)过程中,事务的提交分为两个阶段:第一阶段执行PREPARE TRANSACTION将事务置为“预备”状态,第二阶段执行COMMIT PREPARED或ROLLBACK PREPARED完成提交或回滚。当预备事务的第一阶段已成功完成,且所有参与方均已确认可以提交时,可使用COMMIT PREPARED命令完成事务的最终提交,使事务中的数据变更持久化并对所有会话可见。

典型业务场景包括:

  • 分布式事务正常提交:两阶段提交的第一阶段(PREPARE)已成功完成,所有参与节点均回复“可以提交”,协调者发出COMMIT PREPARED完成最终提交。
  • 故障恢复后提交:协调者在第一阶段后发生故障,恢复后确认各参与者的预备事务仍在,发出COMMIT PREPARED完成延迟提交。
  • 跨会话提交:预备事务由一个会话创建(PREPARE TRANSACTION),由另一个会话提交(COMMIT PREPARED),适用于协调者与参与者不在同一会话的场景。

注意事项

  • 该功能仅在维护模式(GUC参数xc_maintenance_mode为on时)下可用。该模式谨慎打开,一般供维护人员排查问题使用,普通用户不应使用该模式。
  • 命令执行者必须是该事务的创建者或系统管理员,且创建和提交操作可以不在同一个会话中。
  • 事务功能由数据库自动维护,不应显式使用事务功能。

语法格式

1
2
COMMIT PREPARED transaction_id ;
COMMIT PREPARED transaction_id WITH CSN;

参数说明

表1 COMMIT PREPARED参数说明

参数

描述

取值范围

transaction_id

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

字符串类型,长度必须小于200字节。示例值:'txn_transfer_001'。

CSN(commit sequence number)

待提交事务的序列号(Commit Sequence Number),是一个64位递增无符号数字。使用WITH CSN语法时,系统按指定的CSN进行提交。

64位无符号整数。可通过查询pg_prepared_xacts视图或事务相关系统视图获取。

示例

以下示例演示DWS运维中的实际场景:查询数据库内部创建的残留预备事务,并通过COMMIT 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
    transaction |       gid        |        prepared         |  owner   | database
    ------------+------------------+------------------------+----------+----------
         1234567 | txn_distribute_01| 2024-01-15 14:30:00+08 | app_user | db_test
    (1 row)
    

    其中gid字段的值txn_distribute_01即为COMMIT PREPARED命令需要指定的transaction_id。

  3. 执行COMMIT PREPARED,提交GID为’txn_distribute_01’的预备事务。

    1
    COMMIT PREPARED 'txn_distribute_01';
    

  4. 验证预备事务是否已成功提交。再次查询pg_prepared_xacts视图,确认目标事务已不存在。

    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;
    

常见问题

Q:如何查询当前存在的预备事务?

A:可以通过查询系统视图pg_prepared_xacts查看当前所有处于预备状态的事务:

1
SELECT transaction, gid, prepared, owner, database FROM pg_prepared_xacts;

其中gid字段的值即为各预备事务的标识符,用于后续COMMIT PREPARED或ROLLBACK PREPARED操作。

Q:COMMIT PREPARED和COMMIT PREPARED WITH CSN有什么区别?

A:COMMIT PREPARED按默认方式提交预备事务;COMMIT PREPARED WITH CSN允许指定提交序列号(CSN),系统将按指定的CSN顺序进行提交。WITH CSN语法通常用于需要精确控制事务提交顺序的场景,一般使用默认的COMMIT PREPARED即可。