From: David Rowley <drowley@postgresql.org>
Date: Thu, 6 Jun 2019 00:37:04 +0000 (+1200)
Subject: Docs: concurrent builds of partitioned indexes are not supported
X-Git-Tag: REL_11_4~29
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=a15e8ce7b647ccc4580bf00374c33e5ab793f3e3;p=postgresql

Docs: concurrent builds of partitioned indexes are not supported

Document that CREATE INDEX CONCURRENTLY is not currently supported for
indexes on partitioned tables.

Discussion: https://postgr.es/m/CAKJS1f_CErd2z9L21Q8OGLD4TgH7yw1z9MAtHTSO13sXVG-yow@mail.gmail.com
Backpatch-through: 11
---

diff --git a/doc/src/sgml/ref/create_index.sgml b/doc/src/sgml/ref/create_index.sgml
index ad619cdcfe..3a4e71ca1c 100644
--- a/doc/src/sgml/ref/create_index.sgml
+++ b/doc/src/sgml/ref/create_index.sgml
@@ -586,6 +586,16 @@ Indexes:
     within a transaction block, but <command>CREATE INDEX CONCURRENTLY</command>
     cannot.
    </para>
+
+   <para>
+    Concurrent builds for indexes on partitioned tables are currently not
+    supported.  However, you may concurrently build the index on each
+    partition individually and then finally create the partitioned index
+    non-concurrently in order to reduce the time where writes to the
+    partitioned table will be locked out.  In this case, building the
+    partitioned index is a metadata only operation.
+   </para>
+
   </refsect2>
  </refsect1>