Re: Documentation discrepancy UNIQUE NULLS NOT DISTINCT

From: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>
To: Adrian Klaver <adrian(dot)klaver(at)aklaver(dot)com>
Cc: pgsql-general <pgsql-general(at)postgresql(dot)org>
Subject: Re: Documentation discrepancy UNIQUE NULLS NOT DISTINCT
Date: 2023-01-19 22:51:04
Message-ID: CAKFQuwb5FEcX05QOcnw4M+PNMoYoPLY3Hi5GO5+aDorBVdhN-g@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-general

On Thu, Jan 19, 2023 at 3:41 PM Adrian Klaver <adrian(dot)klaver(at)aklaver(dot)com>
wrote:

> From here:
>
> https://www.postgresql.org/about/featurematrix/detail/392/
>
> UNIQUE NULLS NOT DISTINCT
>
> By default, NULL values are not treated as distinct entries. Specifying
> NULLS NOT DISTINCT on unique indexes / constraints will cause NULL
> values to be treated distinctly.
>
>
> From here:
>
> https://www.postgresql.org/docs/current/sql-createindex.html
>
> NULLS DISTINCT
> NULLS NOT DISTINCT
>
> Specifies whether for a unique index, null values should be
> considered distinct (not equal). The default is that they are distinct,
> so that a unique index could contain multiple null values in a column.
>
> and here:
>
> https://www.postgresql.org/docs/current/sql-createtable.html
>
> For the purpose of a unique constraint, null values are not considered
> equal, unless NULLS NOT DISTINCT is specified.
>
>
I think saying that NULLs are distinct by default is the better way to
present this. The documentation disagrees on the verbiage but both state
the same truth; the feature matrix page needs to be fixed.

David J.

In response to

Browse pgsql-general by date

  From Date Subject
Next Message Abhishek Prakash 2023-01-20 08:56:49 ***Conflict with recovery error***
Previous Message Adrian Klaver 2023-01-19 22:41:22 Documentation discrepancy UNIQUE NULLS NOT DISTINCT