]> git.ipfire.org Git - thirdparty/postgresql.git/commit
doc: Clarify that COLUMN is optional in ALTER TABLE ... ADD/DROP COLUMN.
authorFujii Masao <fujii@postgresql.org>
Thu, 5 Mar 2026 03:57:52 +0000 (12:57 +0900)
committerFujii Masao <fujii@postgresql.org>
Thu, 5 Mar 2026 03:57:52 +0000 (12:57 +0900)
commit87da83bde9f8b57e01e5cd1a7716d9db6696ea27
tree5b9c3929231fcbc63371b89f48118d95551429c9
parent270e7b4ff519de076f3da5b88ebaed8b579ebd3c
doc: Clarify that COLUMN is optional in ALTER TABLE ... ADD/DROP COLUMN.

In ALTER TABLE ... ADD/DROP COLUMN, the COLUMN keyword is optional. However,
part of the documentation could be read as if COLUMN were required, which may
mislead users about the command syntax.

This commit updates the ALTER TABLE documentation to clearly state that
COLUMN is optional for ADD and DROP.

Also this commit adds regression tests covering ALTER TABLE ... ADD/DROP
without the COLUMN keyword.

Backpatch to all supported versions.

Author: Chao Li <lic@highgo.com>
Reviewed-by: Robert Treat <rob@xzilla.net>
Reviewed-by: Fujii Masao <masao.fujii@gmail.com>
Discussion: https://postgr.es/m/CAEoWx2n6ShLMOnjOtf63TjjgGbgiTVT5OMsSOFmbjGb6Xue1Bw@mail.gmail.com
Backpatch-through: 14
doc/src/sgml/ref/alter_table.sgml
src/test/regress/expected/alter_table.out
src/test/regress/sql/alter_table.sql