Improve documentation about CREATE INDEX CONCURRENTLY.
authorTom Lane <[email protected]>
Tue, 16 Feb 2016 18:43:03 +0000 (13:43 -0500)
committerTom Lane <[email protected]>
Tue, 16 Feb 2016 18:43:26 +0000 (13:43 -0500)
commit6ce8236ff40c8b5aeea93d2a155be1ef3210b8c4
treed9c7c134391e78697e1544b9f81ef5acb670e2e3
parent3970b510ad1964f1825d159ffc1b41b85d74ece7
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.
doc/src/sgml/ref/create_index.sgml