pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。
PREPARE — 为执行准备一个语句
PREPAREplan_name[ (datatype[, ...] ) ] ASstatement
PREPARE 创建一个预备语句。预备语句是一种可用于优化性能的服务器端对象。执行 PREPARE 语句时,指定的语句会被解析、重写和规划。随后对预备语句发出 EXECUTE 命令时,只需执行该预备语句即可。这样,解析、重写和规划阶段只执行一次,而不是每次执行语句时都进行。
预备语句可以带参数,也就是在执行语句时被代入语句中的值。要在预备语句中 使用参数,需在PREPARE语句中提供一个数据类型列表,并在 要预备的语句本身中,使用$1、$2等按 位置引用这些参数。执行语句时,在 EXECUTE 语句中为这些参数指定实际值。有关详情,参见 EXECUTE。
预备语句只在当前数据库会话期间存在。会话结束时,预备语句就会被遗忘,因 此再次使用前必须重新创建。这也意味着单个预备语句不能由多个并发的数据库 客户端共用;不过,每个客户端都可以创建自己要使用的预备语句。预备语句也 可以用DEALLOCATE 命令手工释放。
当单个会话要执行大量相似语句时,预备语句能带来最大的性能优势。如果 语句在规划或重写时比较复杂,例如查询涉及许多表的连接,或者需要应用多条 规则,那么这种性能差异会特别明显。如果语句相对容易规划和重写,但执行本 身代价较高,则预备语句带来的性能优势就不那么明显。
plan_name为这个特定预备语句指定的任意名称。它在单个会话内必须唯一,随后用于执 行或释放先前已准备的语句。
datatype预备语句中某个参数的数据类型。要在预备语句本身中引用参数,可使用 $1、$2 等。
statement任何SELECT、INSERT、UPDATE 或DELETE语句。
在某些情况下,为预备语句生成的查询计划可能不如语句被正常提交并执行时所选出的查询计划。这是因为在对语句做规划、规划器尝试确定最优查询计划时,语句中指定的任何参数的实际值都不可用。PostgreSQL收集表中数据分布的统计信息,并且可以利用语句中的常量值来推测执行该语句的可能结果。由于在规划带参数的预备语句时这些数据不可用,所选出的计划可能是次优的。要检查PostgreSQL为预备语句选择的查询计划,可以使用EXPLAIN。
有关查询规划以及 PostgreSQL 为此收集的统计 信息的更多内容,请参见ANALYZE文档。
为一个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, date) 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);
SQL 标准包含PREPARE语句,但它只用于嵌入式 SQL。这里的PREPARE语句在语法上也略有不同。
译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。