54.15. pg_prepared_statements

54.15. `pg_prepared_statements`
Prev	Up	Chapter 54. System Views	Home	Next

The pg_prepared_statements view displays all the prepared statements that are available in the current session. See PREPARE for more information about prepared statements.

pg_prepared_statements contains one row for each prepared statement. Rows are added to the view when a new prepared statement is created and removed when a prepared statement is released (for example, via the DEALLOCATE command).

Table 54.15. pg_prepared_statements Columns

Column Type Description
`name` `text` The identifier of the prepared statement
`statement` `text` The query string submitted by the client to create this prepared statement. For prepared statements created via SQL, this is the `PREPARE` statement submitted by the client. For prepared statements created via the frontend/backend protocol, this is the text of the prepared statement itself.
`prepare_time` `timestamptz` The time at which the prepared statement was created
`parameter_types` `regtype[]` The expected parameter types for the prepared statement in the form of an array of `regtype` . The OID corresponding to an element of this array can be obtained by casting the `regtype` value to `oid` .
`result_types` `regtype[]` The types of the columns returned by the prepared statement in the form of an array of `regtype` . The OID corresponding to an element of this array can be obtained by casting the `regtype` value to `oid` . If the prepared statement does not provide a result (e.g., a DML statement), then this field will be null.
`from_sql` `bool` `true` if the prepared statement was created via the `PREPARE` SQL command; `false` if the statement was prepared via the frontend/backend protocol
`generic_plans` `int8` Number of times generic plan was chosen
`custom_plans` `int8` Number of times custom plan was chosen

Column Type

Description

name text

The identifier of the prepared statement

statement text

The query string submitted by the client to create this prepared statement. For prepared statements created via SQL, this is the PREPARE statement submitted by the client. For prepared statements created via the frontend/backend protocol, this is the text of the prepared statement itself.

prepare_time timestamptz

The time at which the prepared statement was created

parameter_types regtype[]

The expected parameter types for the prepared statement in the form of an array of regtype . The OID corresponding to an element of this array can be obtained by casting the regtype value to oid .

result_types regtype[]

The types of the columns returned by the prepared statement in the form of an array of regtype . The OID corresponding to an element of this array can be obtained by casting the regtype value to oid . If the prepared statement does not provide a result (e.g., a DML statement), then this field will be null.

from_sql bool

true if the prepared statement was created via the PREPARE SQL command; false if the statement was prepared via the frontend/backend protocol

generic_plans int8

Number of times generic plan was chosen

custom_plans int8

Number of times custom plan was chosen

The pg_prepared_statements view is read-only.

Prev	Up	Next
54.14. `pg_policies`	Home	54.16. `pg_prepared_xacts`