Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit 854b5eb

Browse files
committed
Improve COPY documentation to clarify that it doesn't copy data to or from
child tables. Per gripe from Jaime Casanova.
1 parent b1bc2f0 commit 854b5eb

File tree

1 file changed

+11
-1
lines changed

1 file changed

+11
-1
lines changed

doc/src/sgml/ref/copy.sgml

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<!--
2-
$PostgreSQL: pgsql/doc/src/sgml/ref/copy.sgml,v 1.97 2010/04/23 23:21:43 rhaas Exp $
2+
$PostgreSQL: pgsql/doc/src/sgml/ref/copy.sgml,v 1.98 2010/04/30 19:49:06 tgl Exp $
33
PostgreSQL documentation
44
-->
55

@@ -308,6 +308,16 @@ COPY <replaceable class="parameter">count</replaceable>
308308
<replaceable class="parameter">viewname</replaceable>) TO ...</literal>.
309309
</para>
310310

311+
<para>
312+
<command>COPY</command> only deals with the specific table named;
313+
it does not copy data to or from child tables. Thus for example
314+
<literal>COPY <replaceable class="parameter">table</> TO</literal>
315+
shows the same data as <literal>SELECT * FROM ONLY <replaceable
316+
class="parameter">table</></literal>. But <literal>COPY
317+
(SELECT * FROM <replaceable class="parameter">table</>) TO ...</literal>
318+
can be used to dump all of the data in an inheritance hierarchy.
319+
</para>
320+
311321
<para>
312322
You must have select privilege on the table
313323
whose values are read by <command>COPY TO</command>, and

0 commit comments

Comments
 (0)