From 6f94280dee9f8b6c511f00a50531b981faa73b54 Mon Sep 17 00:00:00 2001
From: Bruce Momjian <bruce@momjian.us>
Date: Tue, 6 Sep 2011 13:41:28 -0400
Subject: [PATCH] Document PERFORM limitation when using WITH queries.
Backpatch to 9.0 and 9.1.
Report from depstein@alliedtesting.com.
---
doc/src/sgml/plpgsql.sgml | 3 +++
1 file changed, 3 insertions(+)
diff --git a/doc/src/sgml/plpgsql.sgml b/doc/src/sgml/plpgsql.sgml
index 08c3658d5e3..a2482de2b95 100644
--- a/doc/src/sgml/plpgsql.sgml
+++ b/doc/src/sgml/plpgsql.sgml
@@ -940,6 +940,9 @@ PERFORM <replaceable>query</replaceable>;
result. Write the <replaceable>query</replaceable> the same
way you would write an SQL <command>SELECT</> command, but replace the
initial keyword <command>SELECT</> with <command>PERFORM</command>.
+ For <keyword>WITH</> queries, use <keyword>PERFORM</> and then
+ place the query in parentheses. (In this case, the query can only
+ return one row.)
<application>PL/pgSQL</application> variables will be
substituted into the query just as for commands that return no result,
and the plan is cached in the same way. Also, the special variable
--
GitLab