Re: COPY manual is ambiguous about column list

From: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: Bruce Momjian <bruce(at)momjian(dot)us>, Pavlo Golub <pavlo(dot)golub(at)gmail(dot)com>, Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at>, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: COPY manual is ambiguous about column list
Date: 2019-12-20 05:07:48
Message-ID: CAKFQuwaxE-m5VKQkOapv+3kMnP2Q9hEb0NbGeBfqkQuX3UmVgQ@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Thu, Dec 19, 2019 at 9:46 PM Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:

> Bruce Momjian <bruce(at)momjian(dot)us> writes:
> > How is the attached patch?
>
> ! In <command>COPY FROM</command>, the number of columns specified
> ! must match the number of fields in the file; any table columns not
> ! specified in the <command>COPY FROM</command> column list will insert
> ! their default values.
>
> Phrasing seems a bit weird to me: you've run two nearly independent
> observations into one sentence. But s/; any/. Any/ might be enough
> to fix it.
>

Seems better to simply talk about each form independently:

If a list of columns is specified, <command>COPY TO</command> will only
copy the data in the specified columns to the file. <command>COPY
FROM</command> will, by position (i.e., the number of columns listed must
match the number of columns in the file), match each file column to the
named column in the table. Any additional columns present in the table
will receive their default value.

David J.

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Tom Lane 2019-12-20 05:32:30 Re: COPY manual is ambiguous about column list
Previous Message Tom Lane 2019-12-20 04:46:37 Re: COPY manual is ambiguous about column list