pgsql: Improve documentation about CREATE INDEX CONCURRENTLY. - Mailing list pgsql-committers

From Tom Lane
Subject pgsql: Improve documentation about CREATE INDEX CONCURRENTLY.
Date
Msg-id E1aVkb4-0008Dk-9Q@gemulon.postgresql.org
Whole thread Raw
List pgsql-committers
Improve documentation about CREATE INDEX CONCURRENTLY.

Clarify the description of which transactions will block a CREATE INDEX
CONCURRENTLY command from proceeding, and mention that the index might
still not be usable after CREATE INDEX completes.  (This happens if the
index build detected broken HOT chains, so that pg_index.indcheckxmin gets
set, and there are open old transactions preventing the xmin horizon from
advancing past the index's initial creation.  I didn't want to explain what
broken HOT chains are, though, so I omitted an explanation of exactly when
old transactions prevent the index from being used.)

Per discussion with Chris Travers.  Back-patch to all supported branches,
since the same text appears in all of them.

Branch
------
REL9_1_STABLE

Details
-------
http://git.postgresql.org/pg/commitdiff/56f5e77f6c6e1ad1df1cdec4d8179886bef88075

Modified Files
--------------
doc/src/sgml/ref/create_index.sgml | 17 ++++++++++-------
1 file changed, 10 insertions(+), 7 deletions(-)


pgsql-committers by date:

Previous
From: Tom Lane
Date:
Subject: pgsql: Improve documentation about CREATE INDEX CONCURRENTLY.
Next
From: Tom Lane
Date:
Subject: pgsql: Improve documentation about CREATE INDEX CONCURRENTLY.