postgres.git / summary / log / commit / refs
commit dd4c4eaab724835f4553656efb6451b79ffbb9e1
Author: Bruce Momjian <bruce@momjian.us>
Date: Sat Dec 21 17:44:38 2019 +0000
First released in: 13.0, 9.4.26, 9.5.21, 9.6.17, 10.12, 11.7, 12.2
docs: clarify handling of column lists in COPY TO/FROM
Previously it was unclear how COPY FROM handled cases where not all
columns were specified, or if the order didn't match.
Reported-by: pavlo.golub@gmail.com
Discussion: https://postgr.es/m/157487729344.7213.14245726713444755296@wrigleys.postgresql.org
Backpatch-through: 9.4
doc/src/sgml/ref/copy.sgml | 10 +++++-----
1 file changed, 5 insertions(+), 5 deletions(-)
diff --git a/doc/src/sgml/ref/copy.sgml b/doc/src/sgml/ref/copy.sgml
index 23efb8a15d7..079541be674 100644
--- a/doc/src/sgml/ref/copy.sgml
+++ b/doc/src/sgml/ref/copy.sgml
@@ -61,11 +61,11 @@ COPY { <replaceable class="parameter">table_name</replaceable> [ ( <replaceable
</para>
<para>
- If a list of columns is specified, <command>COPY</command> will
- only copy the data in the specified columns to or from the file.
- If there are any columns in the table that are not in the column list,
- <command>COPY FROM</command> will insert the default values for
- those columns.
+ If a column list is specified, <command>COPY TO</command> copies only
+ the data in the specified columns to the file. For <command>COPY
+ FROM</command>, each field in the file is inserted, in order, into the
+ specified column. Table columns not specified in the <command>COPY
+ FROM</command> column list will receive their default values.
</para>
<para>
[parent: 5e22a111185c]