Re: Documentation for create unique index is insuficient and (becauseof that) incorrect - Mailing list pgsql-docs

From Jonathan S. Katz
Subject Re: Documentation for create unique index is insuficient and (becauseof that) incorrect
Date
Msg-id 000aef3d-4183-d345-5d18-b811c4838160@postgresql.org
Whole thread Raw
In response to Re: Documentation for create unique index is insuficient and(because of that) incorrect  (Alvaro Herrera <alvherre@2ndquadrant.com>)
List pgsql-docs
On 11/20/18 1:08 PM, Alvaro Herrera wrote:
> On 2018-Nov-20, Tom Lane wrote:
>
>> So what I think I should do is reformulate that discussion to talk
>> about making covering indexes with INCLUDE, and then mention in
>> passing that you can also do it without that as long as you don't mind
>> the payload columns being part of the index semantics.
>
> That seems sensible.

+1

>
>> I'm also wondering whether to move that section someplace earlier
>> in chapter 11.  Right now it's near the end because it's mostly
>> info about an implementation detail; but it wouldn't be hard to
>> make the argument that covering indexes are more important than,
>> say, indexes with custom collations.  Should we move it, and if
>> so to where?
>
> I think right next to 11.5, which currently completes the topic of how
> are indexes used, is a good place.

I would vote at least before 11.9. You could make arguments how
understand how multicolumn, expression indexes, partials, etc. could be
more important, or at least used for frequently in the wild (at least
for now). And once we've explained those types then you could understand
how to use covering indexes appropriately.

Jonathan


Attachment

pgsql-docs by date:

Previous
From: Alvaro Herrera
Date:
Subject: Re: Documentation for create unique index is insuficient and(because of that) incorrect
Next
From: Tom Lane
Date:
Subject: Re: Documentation for create unique index is insuficient and (because of that) incorrect