Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1hK6CF-0006C6-2y for pgsql-docs@arkaria.postgresql.org; Fri, 26 Apr 2019 19:07:43 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.89) (envelope-from ) id 1hK6CD-0000O1-OO for pgsql-docs@arkaria.postgresql.org; Fri, 26 Apr 2019 19:07:41 +0000 Received: from makus.postgresql.org ([2001:4800:3e1:1::229]) by malur.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1hK6CD-0000Nu-Di for pgsql-docs@lists.postgresql.org; Fri, 26 Apr 2019 19:07:41 +0000 Received: from meldrar.postgresql.org ([2a02:c0:301:0:ffff::31]) by makus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1hK6CB-0004mA-0Q for pgsql-docs@lists.postgresql.org; Fri, 26 Apr 2019 19:07:40 +0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=postgresql.org; s=20171124; h=Content-Type:In-Reply-To:MIME-Version:Date: Message-ID:From:References:Cc:To:Subject:Sender:Reply-To: Content-Transfer-Encoding:Content-ID:Content-Description; bh=c9Y75Q5PiO8N0eTfeWMN4okg9TGYYcS2dxh9hCF2MTk=; b=0PUnSTjnbj4LblIECfr4wtdOyL h/etRXqvimHktWCzn+6klccl8W+CIIRM5Om0ay/FXHjiD+nOpBNYI9W8r2lVVvqpcbp7868+KAPkS oEEDNTuZL6foMGzQ0vajC3hhcQGgsWzHx4wYTjMa7cYyByDT2p7TuC/4OlnqPEtxFb9F5Ik+obo4+ 244JeYA+epK1ft56QX1SHJPSiYNI3aGL0MOryIcjBj7oOmkf+67twC9l7ikd30fbSUvC9PU5e37yK 5Zeos3R0UiNeintnh+jWZKvrsAl+7mHYT8+BUCbLIxCIIPQH/pcfxmldcOfOIxx0Ji6TZ9jcg2gfx A/gSBUOg==; Received: from [63.118.15.50] (helo=Ph33r-Retina.local) by meldrar.postgresql.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1hK6C7-0004B0-5d; Fri, 26 Apr 2019 19:07:37 +0000 Subject: Re: Documentation for partitioned indexes? To: Alvaro Herrera , Tom Lane Cc: pgsql-docs@lists.postgresql.org References: <20190426185333.GA12464@alvherre.pgsql> From: "Jonathan S. Katz" Openpgp: preference=signencrypt Autocrypt: addr=jkatz@postgresql.org; keydata= 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 FmEC Message-ID: <092b21a2-9579-0f1d-bf22-d6b3db2a8b48@postgresql.org> Date: Fri, 26 Apr 2019 15:07:32 -0400 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.12; rv:60.0) Gecko/20100101 Thunderbird/60.6.1 MIME-Version: 1.0 In-Reply-To: <20190426185333.GA12464@alvherre.pgsql> Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="wl3oZ0ybJt2DrztcSXhMFTIa9hfrTE7KE" X-Host-Lookup-Failed: Reverse DNS lookup failed for 63.118.15.50 (failed) List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Precedence: bulk This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --wl3oZ0ybJt2DrztcSXhMFTIa9hfrTE7KE Content-Type: multipart/mixed; boundary="mOueTtMAsZcWo86uNmWmjJovk81PVsxFw"; protected-headers="v1" From: "Jonathan S. Katz" To: Alvaro Herrera , Tom Lane Cc: pgsql-docs@lists.postgresql.org Message-ID: <092b21a2-9579-0f1d-bf22-d6b3db2a8b48@postgresql.org> Subject: Re: Documentation for partitioned indexes? References: <20190426185333.GA12464@alvherre.pgsql> In-Reply-To: <20190426185333.GA12464@alvherre.pgsql> --mOueTtMAsZcWo86uNmWmjJovk81PVsxFw Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: quoted-printable On 4/26/19 2:53 PM, Alvaro Herrera wrote: > On 2019-Apr-26, Tom Lane wrote: >=20 >> We appear to have a fair amount of support now for operations like >> constructing a partitioned index piecemeal, e.g. adding indexes >> to the partitions one at a time and then attaching them to a >> parent partitioned index, with the parent ultimately transitioning >> from "not valid" to "valid" once all the pieces are attached. >> >> However, I cannot find any coherent documentation explaining how >> to do this (or why you'd want to). Am I just looking in the wrong >> places? >=20 > Hmm. Under Notes for CREATE INDEX there is a paragraph on this: >=20 > When CREATE INDEX is invoked on a partitioned table, the default > behavior is to recurse to all partitions to ensure they all have > matching indexes. Each partition is first checked to determine > whether an equivalent index already exists, and if so, that > index will become attached as a partition index to the index > being created, which will become its parent index. If no > matching index exists, a new index will be created and > automatically attached; the name of the new index in each > partition will be determined as if no index name had been > specified in the command. If the ONLY option is specified, no > recursion is done, and the index is marked invalid. (ALTER INDEX > ... ATTACH PARTITION marks the index valid, once all partitions > acquire matching indexes.) Note, however, that any partition > that is created in the future using CREATE TABLE ... PARTITION > OF will automatically have a matching index, regardless of > whether ONLY is specified. >=20 > I suppose I better add something in Chapter 5 (DDL), possibly inside th= e > 5.10 section (Table Partitioning) -- a new 5.10.6 "Indexes for > Partitioned Tables" perhaps? +1; (though note on devel it's section 5.11, not that it matters in the SGML) I'd suggest keeping the title of the section similar to the one with constraints, i.e. "Partitioning and Indexes" Thanks, Jonathan --mOueTtMAsZcWo86uNmWmjJovk81PVsxFw-- --wl3oZ0ybJt2DrztcSXhMFTIa9hfrTE7KE Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAEBCAAdFiEE+oS2la8r95ogZD/x8QSccp8cZScFAlzDVvQACgkQ8QSccp8c ZSf7lg/8C+UlaIDWtcJTzdcdTSEN1nCgqiyBiwUrkEdgj7vnlK3kla7CYXrMJJNw Pa8jKujrnAoVStJLgCyWfd1CX+XvNYHCbTxVuo+O9Cwguc785mwt+JmY3lCz4K6y 2IF7xwcWkRF09Q/3YGI08LyKP2FPtxZ9+K3n/7Kqfc83+QlmHll2IF884w4iPv6T J/uJf8+tYuGp0vwqt0wwdKgDkRNWdMUpA2GYF3HJdcXeZ8yrizYMQMJOD+itezPw pMhu61sCMb3KBuJrggyM767Lx+MGQ//xvVHnFEF9PVnvuHVw/0gZlDkE/Z5gyz40 UOD4tzHr3SY1cpZmueDtZyA4rNMxqLDfR3V+rpvm9nt9LoM/50H3eGyj2Oed10zz ad643KFO4W8z6uvxktSm+kvEN9Wtha3VC9pBBeIYpxuQpQYg7L9Opgx4Igqn9IDE Mku3RbBXyw06X+nM8Md6/5jwvh8EODBvxbk7htkY57XhLpkJ/jW+h5WzzzsfNxwH LxWK8FuCddqyk+t8oZnG/HtDUCBUs5T3cwBWm7nP3kQKbV+Il9HTL3JEulAmE33x v3rIeSWeSMmUVnMRpeocq/nL2kQC+D7YztxIWhoKZc84+NORvn+tPQ74X/Ra+DPd +KQUtJQcizCqTd1IXUx0NI2NmXjp/Y+GBBsg42br1qYpTHfw7a8= =ZS0I -----END PGP SIGNATURE----- --wl3oZ0ybJt2DrztcSXhMFTIa9hfrTE7KE--