Improve COPY documentation to clarify that it doesn't copy data to or from
authorTom Lane
Fri, 30 Apr 2010 19:49:06 +0000 (19:49 +0000)
committerTom Lane
Fri, 30 Apr 2010 19:49:06 +0000 (19:49 +0000)
child tables.  Per gripe from Jaime Casanova.

doc/src/sgml/ref/copy.sgml

index 8f8f48dd6468b7d508280ad3296d2b6bfa962784..ac2f0dadc205e18d8b64d837c8a77ab556c6ef44 100644 (file)
@@ -1,5 +1,5 @@
 
 
@@ -308,6 +308,16 @@ COPY count
     viewname) TO ....
    
 
+   
+    COPY only deals with the specific table named;
+    it does not copy data to or from child tables.  Thus for example
+    COPY table TO
+    shows the same data as SELECT * FROM ONLY 
+    class="parameter">table.  But COPY
+    (SELECT * FROM table) TO ...
+    can be used to dump all of the data in an inheritance hierarchy.
+   
+
    
     You must have select privilege on the table
     whose values are read by COPY TO, and