upstream/postgresql
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2026-07-15 04:40:58 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

doc: Clarify COPY FROM WHERE expression restrictions

Browse source 
Commit aa606b9316 disallowed generated columns in COPY FROM WHERE
expressions, and commit 21c69dc73f disallowed system columns.
However, the COPY reference page still mentions only the restriction
on subqueries.

Update the documentation to also list generated columns and system
columns as unsupported in COPY FROM WHERE expressions.

Backpatch the generated-column documentation change to all supported
versions. Backpatch the system-column documentation change to v19,
where that restriction was introduced.

Author: Fujii Masao <masao.fujii@gmail.com>
Reviewed-by: Ayush Tiwari <ayushtiwari.slg01@gmail.com>
Discussion: https://postgr.es/m/CAHGQGwEgxErc54yVOAVWCsr1O=8pgw4oKRPuEQ9mfhkoYGR_XA@mail.gmail.com
Backpatch-through: 14
This commit is contained in:
Fujii Masao 2026-07-08 12:44:06 +09:00
parent b5a8018116
commit d35e8babc4
1 changed files with 5 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

9
doc/src/sgml/ref/copy.sgml
View file

@ -545,10 +545,11 @@ WHERE <replaceable class="parameter">condition</replaceable>
</para>
<para>
Currently, subqueries are not allowed in <literal>WHERE</literal>
expressions, and the evaluation does not see any changes made by the
<command>COPY</command> itself (this matters when the expression
contains calls to <literal>VOLATILE</literal> functions).
Currently, subqueries, system columns, and generated columns are not
allowed in <literal>WHERE</literal> expressions, and the evaluation
does not see any changes made by the <command>COPY</command> itself
(this matters when the expression contains calls to
<literal>VOLATILE</literal> functions).
</para>
</listitem>