更新时间:2023-10-17 GMT+08:00

PREPARE TRANSACTION

功能描述

为当前事务做两阶段提交的准备。

在命令之后,事务就不再和当前会话关联了;它的状态完全保存在磁盘上,它被提交成功的可能性非常高,即使是在请求提交之前数据库发生了崩溃也如此。

一旦准备好了,一个事务就可以在稍后用COMMIT PREPAREDROLLBACK PREPARED命令分别进行提交或者回滚。这些命令可以从任何会话中发出,而不光是最初执行事务的那个会话。

从发出命令的会话的角度来看,PREPARE TRANSACTION不同于ROLLBACK:在执行它之后,就不再有活跃的当前事务了,并且预备事务的效果无法见到 (在事务提交的时候其效果会再次可见)。

如果PREPARE TRANSACTION因为某些原因失败,那么它就会变成一个ROLLBACK,当前事务被取消。

注意事项

  • 事务功能由数据库自动维护,不应显式使用事务功能。
  • 分布式当前不支持客户调用自定义PREPARE TRANSACTION操作。
  • 在运行PREPARE TRANSACTION命令时,必须在postgresql.conf配置文件中增大max_prepared_transactions的数值。建议至少将其设置为等于max_connections,这样每个会话都可以有一个等待中的预备事务。

语法格式

PREPARE TRANSACTION transaction_id;

参数说明

transaction_id

待提交事务的标识符,用于后面在COMMIT PREPARED或ROLLBACK PREPARED的时候标识这个事务。它不能和任何当前预备事务已经使用了的标识符同名。

取值范围:标识符必须以字符串文本的方式书写,并且必须小于200字节长。