DESCRIBE TRANSACTION¶

Describes the transaction, including the start time and the state (running, committed, rolled back).

DESCRIBE can be abbreviated to DESC.

See also:: CURRENT_TRANSACTION , LAST_TRANSACTION , BEGIN , COMMIT , ROLLBACK , SHOW TRANSACTIONS

Syntax¶

{ DESC | DESCRIBE } TRANSACTION <transaction_id>

Copy

transaction_id

Specifies the identifier of the transaction to describe.

transaction_id must be a literal, not a session variable.

To post-process the output of this command, you can use the pipe operator (->>) or the RESULT_SCAN function. Both constructs treat the output as a result set that you can query.

The output column names for this command are generated in lowercase. If you consume a result set from this command with the pipe operator or the RESULT_SCAN function, use double-quoted identifiers for the column names in the query to ensure that they match the column names in the output that was scanned. For example, if the name of an output column is type, then specify "type" for the identifier.

The output of the command includes the following columns, which describe the properties and metadata of the object:

Column	Description
`id`	Unique identifier of the transaction.
`user`	The user ID of the user who ran the transaction.
`session name`	The ID of the user session in which the transaction was executed.
`started_on`	Date and time that the transaction was created.
`state`	The transaction’s completion status, e.g. committed, rolled back, or still running.
`ended_on`	Date and time that the transaction finished.

DESC TRANSACTION 1651535571261000000;

Copy