pgsql: doc: clarify aliasing of VALUES in FROM clauses - Mailing list pgsql-committers

From Fujii Masao
Subject pgsql: doc: clarify aliasing of VALUES in FROM clauses
Date
Msg-id E1x1OvI-000000032qv-1ds7@gemulon.postgresql.org
Whole thread
List pgsql-committers
doc: clarify aliasing of VALUES in FROM clauses

The VALUES reference page said that an AS clause was required when
VALUES is used in a FROM clause. This was imprecise because AS is
optional when specifying an alias.

In v14 and v15, a table alias is still required in this case, so state
that explicitly instead. In v16 and later, commit bcedd8f5fce made table
aliases for subqueries in FROM clauses optional, so state that the
table alias is optional there. In all branches, continue to recommend
explicit column aliases as good practice.

Backpatch to all supported versions.

Author: Ian Barwick <barwick@gmail.com>
Reviewed-by: Laurenz Albe <laurenz.albe@cybertec.at>
Reviewed-by: Fujii Masao <masao.fujii@gmail.com>
Discussion: https://postgr.es/m/CAB8KJ=jrvZdNLLhYSiCgbjLTz2LKEjYw+-HVQkaF+kgk61KtHA@mail.gmail.com
Backpatch-through: 14

Branch
------
REL_16_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/334ee0777f8a24b599867c2a232ee28c64076d6f

Modified Files
--------------
doc/src/sgml/ref/values.sgml | 7 +++----
1 file changed, 3 insertions(+), 4 deletions(-)


Attachment

pgsql-committers by date:

Previous
From: Daniel Gustafsson
Date:
Subject: pgsql: Handle PG_INT32_MIN negation overflow in right()
Next
From: Fujii Masao
Date:
Subject: pgsql: doc: clarify aliasing of VALUES in FROM clauses