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; |
参数说明
| 参数 | 描述 | 取值范围 |
|---|---|---|
| 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完成最终提交。
- 开启维护模式。(开启后可能会造成数据不一致的风险,需联系技术支持人员后开启)。
1SET xc_maintenance_mode = on;
- 查询当前存在的预备事务,获取需要提交的事务标识符(gid字段值)。
1SELECT 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。
- 执行COMMIT PREPARED,提交GID为’txn_distribute_01’的预备事务。
1COMMIT PREPARED 'txn_distribute_01';
- 验证预备事务是否已成功提交。再次查询pg_prepared_xacts视图,确认目标事务已不存在。
1SELECT transaction, gid FROM pg_prepared_xacts WHERE gid = 'txn_distribute_01';
预期输出(查询返回空结果,表示预备事务已被提交终结):
1 2 3
transaction | gid ------------+----- (0 rows)
- 关闭维护模式。
1SET 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即可。