PREPARE TRANSACTION
功能描述
为当前事务做两阶段提交的准备。
在命令之后,事务就不再和当前会话关联了;它的状态完全保存在磁盘上,它被提交成功的可能性非常高,即使是在请求提交之前数据库发生了崩溃也如此。
一旦准备好了,一个事务就可以在稍后用COMMIT PREPARED或 ROLLBACK 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字节长。