diff options
| author | Tom Lane <tgl@sss.pgh.pa.us> | 2019-11-19 14:43:37 -0500 |
|---|---|---|
| committer | Tom Lane <tgl@sss.pgh.pa.us> | 2019-11-19 14:43:37 -0500 |
| commit | 823a551fe0c6e732f48cb54dc60d5cfd66b0aff4 (patch) | |
| tree | 9e35f955d2785c9c167139d06809802cee69a53c | |
| parent | 93b2bbede91b32d12d9e444e576be2efff6942b5 (diff) | |
| download | postgresql-823a551fe0c6e732f48cb54dc60d5cfd66b0aff4.tar.gz postgresql-823a551fe0c6e732f48cb54dc60d5cfd66b0aff4.zip | |
Doc: clarify use of RECURSIVE in WITH.
Apparently some people misinterpreted the syntax as being that
RECURSIVE is a prefix of individual WITH queries. It's a modifier
for the WITH clause as a whole, so state that more clearly.
Discussion: https://postgr.es/m/ca53c6ce-a0c6-b14a-a8e3-162f0b2cc119@a-kretschmer.de
| -rw-r--r-- | doc/src/sgml/ref/select.sgml | 8 |
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/src/sgml/ref/select.sgml b/doc/src/sgml/ref/select.sgml index 06d611b64c2..691e4028030 100644 --- a/doc/src/sgml/ref/select.sgml +++ b/doc/src/sgml/ref/select.sgml @@ -274,6 +274,14 @@ TABLE [ ONLY ] <replaceable class="parameter">table_name</replaceable> [ * ] </para> <para> + When there are multiple queries in the <literal>WITH</literal> + clause, <literal>RECURSIVE</literal> should be written only once, + immediately after <literal>WITH</literal>. It applies to all queries + in the <literal>WITH</literal> clause, though it has no effect on + queries that do not use recursion or forward references. + </para> + + <para> The primary query and the <literal>WITH</literal> queries are all (notionally) executed at the same time. This implies that the effects of a data-modifying statement in <literal>WITH</literal> cannot be seen from |