53.17. pg_prepared_statements — PostgreSQL 19

支持中的版本：当前版本 (18) / 17 / 16 / 15 / 14

开发中的版本： 19 / 20devel

已结束支持的版本： 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2

预发布版本文档。 PostgreSQL 19beta4 为测试版本，最终发布内容可能有所不同。

53.17. `pg_prepared_statements`
上一页	上一级	第 53 章系统视图	起始页	下一页

53.17. `pg_prepared_statements` #

pg_prepared_statements 视图显示当前会话中所有可用的预备语句。关于预备语句的更多信息，参见 PREPARE。

pg_prepared_statements 为每个预备语句包含一行。创建新的预备语句时，会向该视图添加一行；释放预备语句时（例如通过 DEALLOCATE 命令）则会移除该行。

表 53.17. pg_prepared_statements 列

列类型描述
`name` `text` 预备语句的标识符
`statement` `text` 客户端提交用于创建此预备语句的查询字符串。对于通过 SQL 创建的预备语句，这里是由客户端提交的 `PREPARE` 语句。对于通过前端/后端协议创建的预备语句，这里是预备语句本身的文本。
`prepare_time` `timestamptz` 预备语句被创建的时间
`parameter_types` `regtype[]` 预备语句期望的参数类型，以一个 `regtype` 数组的形式。这个数组中一个元素所对应的 OID 可通过将 `regtype` 值转换为 `oid` 获得。
`result_types` `regtype[]` 该预备语句返回列的类型，以 `regtype` 数组形式表示。该数组中某个元素对应的 OID 可以通过将 `regtype` 值转换为 `oid` 获得。如果预备语句不提供结果（例如 DML 语句），则该字段为 NULL。
`from_sql` `bool` 如果预备语句通过 SQL 命令 `PREPARE` 创建，则为 `true`；如果预备语句通过前端/后端协议创建，则为 `false`
`generic_plans` `int8` 通用计划被选用的次数
`custom_plans` `int8` 定制计划被选用的次数

列类型

描述

name text

预备语句的标识符

statement text

客户端提交用于创建此预备语句的查询字符串。对于通过 SQL 创建的预备语句，这里是由客户端提交的 PREPARE 语句。对于通过前端/后端协议创建的预备语句，这里是预备语句本身的文本。

prepare_time timestamptz

预备语句被创建的时间

parameter_types regtype[]

预备语句期望的参数类型，以一个 regtype 数组的形式。这个数组中一个元素所对应的 OID 可通过将 regtype 值转换为 oid 获得。

result_types regtype[]

该预备语句返回列的类型，以 regtype 数组形式表示。该数组中某个元素对应的 OID 可以通过将 regtype 值转换为 oid 获得。如果预备语句不提供结果（例如 DML 语句），则该字段为 NULL。

from_sql bool

如果预备语句通过 SQL 命令 PREPARE 创建，则为 true；如果预备语句通过前端/后端协议创建，则为 false

generic_plans int8

通用计划被选用的次数

custom_plans int8

定制计划被选用的次数

pg_prepared_statements 视图是只读的。

上一页	上一级	下一页
53.16. `pg_policies`	起始页	53.18. `pg_prepared_xacts`

阅读上游文档. 反馈更正前请先核对当前版本手册.