描述

PREPARE 创建一个预备语句。预备语句是一种可用于优化性能的服务器端对象。执行 PREPARE 语句时，指定的语句会被解析、重写和规划。随后对预备语句发出 EXECUTE 命令时，只需执行该预备语句即可。这样，解析、重写和规划阶段只执行一次，而不是每次执行语句时都进行。

预备语句可以带参数，也就是在执行时会代入语句中的值。创建预备语句时，可 以按位置引用参数，例如 $1、$2 等。 也可以选择指定相应的参数数据类型列表。如果某个参数的数据类型未指定，或 被声明为 unknown，则其类型会从该参数第一次被引用时所 在的上下文中推断出来（如果可能）。执行该语句时，需要在 EXECUTE 语句中为这些参数提供实际值。有关详情，参见 EXECUTE。

预备语句只在当前数据库会话期间存在。会话结束时，预备语句就会被遗忘，因 此再次使用前必须重新创建。这也意味着单个预备语句不能由多个并发的数据库 客户端共用；不过，每个客户端都可以创建自己要使用的预备语句。预备语句也 可以用DEALLOCATE 命令手工释放。

当单个会话要执行大量相似语句时，预备语句能带来最大的性能优势。如果 语句在规划或重写时比较复杂，例如查询涉及许多表的连接，或者需要应用多条 规则，那么这种性能差异会特别明显。如果语句相对容易规划和重写，但执行本 身代价较高，则预备语句带来的性能优势就不那么明显。

参数

注解

在某些情况下，为预备语句生成的查询计划可能不如语句被正常提交并执行时所选出的查询计划。 This is because when the statement is planned and the planner attempts to determine the optimal query plan, the actual values of any parameters specified in the statement are unavailable. PostgreSQL collects statistics on the distribution of data in the table, 并可以利用语句中的常量值推测执行该语句可能得到的结果. Since this data is unavailable when planning prepared statements with parameters, the chosen plan might be suboptimal. To examine the query plan PostgreSQL has chosen for a prepared statement, use EXPLAIN.

有关查询规划以及 PostgreSQL 为此收集的统计 信息的更多内容，请参见ANALYZE文档。

可以通过查询 pg_prepared_statements 系统视图查看一个会话的所有可用预备语句。

示例

为一个INSERT 语句创建预备语句，然后执行它：

PREPARE fooplan (int, text, bool, numeric) AS
    INSERT INTO foo VALUES($1, $2, $3, $4);
EXECUTE fooplan(1, 'Hunter Valley', 't', 200.00);

为一个 SELECT 语句创建预备语句，然后执行它：

PREPARE usrrptplan (int) AS
    SELECT * FROM users u, logs l WHERE u.usrid=$1 AND u.usrid=l.usrid
    AND l.date = $2;
EXECUTE usrrptplan(1, current_date);

注意，第二个参数的数据类型未指定，因此会从 $2 所在的使用上下文中推断出来。

兼容性

SQL 标准包含PREPARE语句，但它只用于嵌入式 SQL。这里的PREPARE语句在语法上也略有不同。

另见