agora inbox for pgsql-committers@postgresql.org  
help / color / mirror / Atom feed
pgsql: doc: clarify aliasing of VALUES in FROM clauses
7+ messages / 1 participants
[nested] [flat]

* pgsql: doc: clarify aliasing of VALUES in FROM clauses
@ 2026-09-01 13:52  Fujii Masao <fujii@postgresql.org>
  0 siblings, 0 replies; 7+ messages in thread

From: Fujii Masao @ 2026-09-01 13:52 UTC (permalink / raw)
  To: pgsql-committers@lists.postgresql.org

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
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/076630cbdbdb8b6d69ad8fb30c2b6b707560c234

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



^ permalink  raw  reply  [nested|flat] 7+ messages in thread

* pgsql: doc: clarify aliasing of VALUES in FROM clauses
@ 2026-09-01 13:52  Fujii Masao <fujii@postgresql.org>
  0 siblings, 0 replies; 7+ messages in thread

From: Fujii Masao @ 2026-09-01 13:52 UTC (permalink / raw)
  To: pgsql-committers@lists.postgresql.org

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_19_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/a4da80419305797a24da544bb8514b6399ce0b1f

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



^ permalink  raw  reply  [nested|flat] 7+ messages in thread

* pgsql: doc: clarify aliasing of VALUES in FROM clauses
@ 2026-09-01 13:52  Fujii Masao <fujii@postgresql.org>
  0 siblings, 0 replies; 7+ messages in thread

From: Fujii Masao @ 2026-09-01 13:52 UTC (permalink / raw)
  To: pgsql-committers@lists.postgresql.org

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_18_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/4aa640a395cab42012fd26570dafca1001a6debd

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



^ permalink  raw  reply  [nested|flat] 7+ messages in thread

* pgsql: doc: clarify aliasing of VALUES in FROM clauses
@ 2026-09-01 13:53  Fujii Masao <fujii@postgresql.org>
  0 siblings, 0 replies; 7+ messages in thread

From: Fujii Masao @ 2026-09-01 13:53 UTC (permalink / raw)
  To: pgsql-committers@lists.postgresql.org

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_17_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/45dc7bd2492a05a737f75dae4f5667142a5b562a

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



^ permalink  raw  reply  [nested|flat] 7+ messages in thread

* pgsql: doc: clarify aliasing of VALUES in FROM clauses
@ 2026-09-01 13:53  Fujii Masao <fujii@postgresql.org>
  0 siblings, 0 replies; 7+ messages in thread

From: Fujii Masao @ 2026-09-01 13:53 UTC (permalink / raw)
  To: pgsql-committers@lists.postgresql.org

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(-)



^ permalink  raw  reply  [nested|flat] 7+ messages in thread

* pgsql: doc: clarify aliasing of VALUES in FROM clauses
@ 2026-09-01 13:53  Fujii Masao <fujii@postgresql.org>
  0 siblings, 0 replies; 7+ messages in thread

From: Fujii Masao @ 2026-09-01 13:53 UTC (permalink / raw)
  To: pgsql-committers@lists.postgresql.org

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_15_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/b6d2d82871c3dee3508c67a3b17ed4356654c036

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



^ permalink  raw  reply  [nested|flat] 7+ messages in thread

* pgsql: doc: clarify aliasing of VALUES in FROM clauses
@ 2026-09-01 13:53  Fujii Masao <fujii@postgresql.org>
  0 siblings, 0 replies; 7+ messages in thread

From: Fujii Masao @ 2026-09-01 13:53 UTC (permalink / raw)
  To: pgsql-committers@lists.postgresql.org

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_14_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/03851df1105da45350e6d8db20d099299b27428c

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



^ permalink  raw  reply  [nested|flat] 7+ messages in thread


end of thread, other threads:[~2026-09-01 13:53 UTC | newest]

Thread overview: 7+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2026-09-01 13:52 pgsql: doc: clarify aliasing of VALUES in FROM clauses Fujii Masao <fujii@postgresql.org>
2026-09-01 13:52 pgsql: doc: clarify aliasing of VALUES in FROM clauses Fujii Masao <fujii@postgresql.org>
2026-09-01 13:52 pgsql: doc: clarify aliasing of VALUES in FROM clauses Fujii Masao <fujii@postgresql.org>
2026-09-01 13:53 pgsql: doc: clarify aliasing of VALUES in FROM clauses Fujii Masao <fujii@postgresql.org>
2026-09-01 13:53 pgsql: doc: clarify aliasing of VALUES in FROM clauses Fujii Masao <fujii@postgresql.org>
2026-09-01 13:53 pgsql: doc: clarify aliasing of VALUES in FROM clauses Fujii Masao <fujii@postgresql.org>
2026-09-01 13:53 pgsql: doc: clarify aliasing of VALUES in FROM clauses Fujii Masao <fujii@postgresql.org>

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox