ROLLBACK PREPARED
cancel a transaction that was earlier prepared for two-phase commit
English manual coverage begins with PostgreSQL 6.4. Source history and runtime observations have their own recorded version boundaries.
Reading PG 18·Select a recorded version
- anchor
- SQL-ROLLBACK-PREPARED
- file
- sql-rollback-prepared.html
- lang
- en
- name
- ROLLBACK PREPARED
- purpose
- cancel a transaction that was earlier prepared for two-phase commit
- purpose zh
- 回滚一个先前为两阶段提交而预备的事务
- sections same as
- Unknown
- slug
- 18
- synopsis html
- ROLLBACK PREPARED <em class="replaceable"><code>transaction_id</code></em>
- synopsis text
- ROLLBACK PREPARED transaction_id
Syntax
ROLLBACK PREPARED transaction_idSyntax diagrams
Read left to right. Branches are choices, bypasses are optional, loops repeat. Select an underlined parameter to open its rule.
Definition PG 18
ROLLBACK PREPARED transaction_id
Description
ROLLBACK PREPARED rolls back a transaction that is in prepared state.
Parameters
transaction_idThe transaction identifier of the transaction that is to be rolled back.
Notes
To roll back a prepared transaction, you must be either the same user that executed the transaction originally, or a superuser. But you do not have to be in the same session that executed the transaction.
This command cannot be executed inside a transaction block. The prepared transaction is rolled back immediately.
All currently available prepared transactions are listed in the pg_prepared_xacts system view.
Examples
Roll back the transaction identified by the transaction identifier foobar:
ROLLBACK PREPARED 'foobar';
Compatibility
ROLLBACK PREPARED is a PostgreSQL extension. It is intended for use by external transaction management systems, some of which are covered by standards (such as X/Open XA), but the SQL side of those systems is not standardized.
See Also
PREPARE TRANSACTION, COMMIT PREPAREDCompare versions
Source references
Full definition and evidence JSON
Definition sources
center · PostgreSQL 18 · wiki-repair-20261023:781c51a937027ecdb0ada27339bd70c7d2442ec7ae44959d77cf9e8f6c32bdfa
Text language: en · wiki-repair-20261023:781c51a937027ecdb0ada27339bd70c7d2442ec7ae44959d77cf9e8f6c32bdfa