From 854b5eb510f09ce55a6abd8ac3caf72b2eb36a5c Mon Sep 17 00:00:00 2001
From: Tom Lane <tgl@sss.pgh.pa.us>
Date: Fri, 30 Apr 2010 19:49:06 +0000
Subject: [PATCH] Improve COPY documentation to clarify that it doesn't copy
data to or from child tables. Per gripe from Jaime Casanova.
---
doc/src/sgml/ref/copy.sgml | 12 +++++++++++-
1 file changed, 11 insertions(+), 1 deletion(-)
diff --git a/doc/src/sgml/ref/copy.sgml b/doc/src/sgml/ref/copy.sgml
index 8f8f48dd646..ac2f0dadc20 100644
--- a/doc/src/sgml/ref/copy.sgml
+++ b/doc/src/sgml/ref/copy.sgml
@@ -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
--
GitLab