Fix ALTER DOMAIN NOT NULL syntax
authorPeter Eisentraut <[email protected]>
Mon, 15 Apr 2024 06:20:34 +0000 (08:20 +0200)
committerPeter Eisentraut <[email protected]>
Mon, 15 Apr 2024 06:34:45 +0000 (08:34 +0200)
commit9895b35cb88edc30b836661dbc26d7665716b5a0
tree951ebe60a7af44a3e5246b323459c84e19f9b2d7
parentd21d61b96f7a4d89e4b2e7cc9b9a1ec3f642fa12
Fix ALTER DOMAIN NOT NULL syntax

This addresses a few problems with commit e5da0fe3c22 ("Catalog domain
not-null constraints").

In CREATE DOMAIN, a NOT NULL constraint looks like

    CREATE DOMAIN d1 AS int [ CONSTRAINT conname ] NOT NULL

(Before e5da0fe3c22, the constraint name was accepted but ignored.)

But in ALTER DOMAIN, a NOT NULL constraint looks like

    ALTER DOMAIN d1 ADD [ CONSTRAINT conname ] NOT NULL VALUE

where VALUE is where for a table constraint the column name would be.
(This works as of e5da0fe3c22.  Before e5da0fe3c22, this syntax
resulted in an internal error.)

But for domains, this latter syntax is confusing and needlessly
inconsistent between CREATE and ALTER.  So this changes it to just

    ALTER DOMAIN d1 ADD [ CONSTRAINT conname ] NOT NULL

(None of these syntaxes are per SQL standard; we are just living with
the bits of inconsistency that have built up over time.)

In passing, this also changes the psql \dD output to not show not-null
constraints in the column "Check", since it's already shown in the
column "Nullable".  This has also been off since e5da0fe3c22.

Reviewed-by: jian he <[email protected]>
Discussion: https://www.postgresql.org/message-id/flat/9ec24d7b-633d-463a-84c6-7acff769c9e8%40eisentraut.org
doc/src/sgml/ref/create_domain.sgml
src/backend/parser/gram.y
src/backend/utils/adt/ruleutils.c
src/bin/psql/describe.c
src/test/regress/expected/domain.out
src/test/regress/sql/domain.sql