mirrors/postgres
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Improve COPY documentation to clarify that it doesn't copy data to or from

Browse Source 
child tables.  Per gripe from Jaime Casanova.
This commit is contained in:
Tom Lane 2010-04-30 19:49:06 +00:00
parent b1bc2f0425
commit 854b5eb510
1 changed files with 11 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
doc/src/sgml/ref/copy.sgml
View File

@ -1,5 +1,5 @@
<!--
$PostgreSQL: pgsql/doc/src/sgml/ref/copy.sgml,v 1.97 2010/04/23 23:21:43 rhaas Exp $
$PostgreSQL: pgsql/doc/src/sgml/ref/copy.sgml,v 1.98 2010/04/30 19:49:06 tgl Exp $
PostgreSQL documentation
-->
@ -308,6 +308,16 @@ COPY <replaceable class="parameter">count</replaceable>
<replaceable class="parameter">viewname</replaceable>) TO ...</literal>.
</para>
<para>
<command>COPY</command> only deals with the specific table named;
it does not copy data to or from child tables. Thus for example
<literal>COPY <replaceable class="parameter">table</> TO</literal>
shows the same data as <literal>SELECT * FROM ONLY <replaceable
class="parameter">table</></literal>. But <literal>COPY
(SELECT * FROM <replaceable class="parameter">table</>) TO ...</literal>
can be used to dump all of the data in an inheritance hierarchy.
</para>
<para>
You must have select privilege on the table
whose values are read by <command>COPY TO</command>, and