Re: UNION does not append - Mailing list pgsql-docs

From David G. Johnston
Subject Re: UNION does not append
Date
Msg-id CAKFQuwYHOB1Wp7ZxbHveNrm2PiczNFjy5dPQoJtxT2zJyiU6UA@mail.gmail.com
Whole thread Raw
In response to UNION does not append  (PG Doc comments form <noreply@postgresql.org>)
List pgsql-docs
On Tuesday, October 7, 2025, PG Doc comments form <noreply@postgresql.org> wrote:
The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/18/queries-union.html
Description:

I'm very confused about this statement in the documentation of UNION: "UNION
effectively appends the result of query2 to the result of query1".
Because, if I append one item to a list, it is still the same list. But in
the case of UNION, it's ""copied"" into a new anonymous derived-table. Alias
don't work anymore, which I would expect if I just append some rows. Or is
it like "effectively" means that this statement is not to be taken
literally? In that case I would really appreciate a more detailed
description, that after the UNION with tables a new anonymous derived-table
is returned and the original first table can't be accessed anymore. Thank
you for taking your time to read this even if you disagree.

Yes, if you place a set-operation using query into a subquery context the subquery has to be given its own name: and the individual from clause relations of the contained query are not exposed.  This is just how subqueries work.

If you don’t place it in a subquery the rows are just sent to the client.

In both cases the word append simply means “using the column structure of the first component query”.  Though Imsuppose that is strictly “column names” since types can be changed to a more encompassing one if needed.

David J.

pgsql-docs by date:

Previous
From: Laurenz Albe
Date:
Subject: Re: UNION does not append
Next
From: Oleg
Date:
Subject: Re: Documentation improvement patch