PostgreSQL 18 文档 · 53.16. pg_prepared

文档 → PostgreSQL 18

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

测试与开发版本： 19 / devel

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

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

53.16. `pg_prepared_statements` #

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

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

表 53.16. 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.15. `pg_policies`	起始页	53.17. `pg_prepared_xacts`

译文有误、术语不当或页面显示问题，请到译文仓库 pgsty/pgdoc 报告译文问题。英文原文本身的问题请通过上游文档表单反馈给 PostgreSQL 文档维护者。