pgsql: Doc: clarify that CREATE TABLE discards redundant unique constra

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: pgsql-committers(at)lists(dot)postgresql(dot)org
Subject: pgsql: Doc: clarify that CREATE TABLE discards redundant unique constra
Date: 2020-12-08 18:10:16
Message-ID: [email protected]
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-committers

Doc: clarify that CREATE TABLE discards redundant unique constraints.

The SQL standard says that redundant unique constraints are disallowed,
but we long ago decided that throwing an error would be too
user-unfriendly, so we just drop redundant ones. The docs weren't very
clear about that though, as this behavior was only explained for PRIMARY
KEY vs UNIQUE, not UNIQUE vs UNIQUE.

While here, I couldn't resist doing some copy-editing and markup-fixing
on the adjacent text about INCLUDE options.

Per bug #16767 from Matthias vd Meent.

Discussion: https://postgr.es/m/[email protected]

Branch
------
REL_12_STABLE

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

Modified Files
--------------
doc/src/sgml/ref/create_table.sgml | 58 +++++++++++++++++++++++---------------
1 file changed, 36 insertions(+), 22 deletions(-)

Browse pgsql-committers by date

  From Date Subject
Next Message Dean Rasheed 2020-12-08 19:43:05 pgsql: Improve estimation of OR clauses using multiple extended statist
Previous Message Tom Lane 2020-12-08 17:06:38 pgsql: Doc: explain that the string types can't store \0 (ASCII NUL).