From: | Justin Pryzby <pryzby(at)telsasoft(dot)com> |
---|---|
To: | Robert Haas <rhaas(at)postgresql(dot)org> |
Cc: | pgsql-hackers(at)lists(dot)postgresql(dot)org, David Rowley <drowley(at)postgresql(dot)org>, Alvaro Herrera <alvherre(at)alvh(dot)no-ip(dot)org> |
Subject: | doc: mentioned CREATE+ATTACH PARTITION as an alternative to CREATE TABLE..PARTITION OF |
Date: | 2022-07-18 14:33:04 |
Message-ID: | 20220718143304.GC18011@telsasoft.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-hackers |
It's easy to use CREATE TABLE..LIKE + ALTER..ATTACH PARTITION to avoid
acquiring a strong lock when creating a new partition.
But it's also easy to forget.
commit 76c0d1198cf2908423b321cd3340d296cb668c8e
Author: Justin Pryzby <pryzbyj(at)telsasoft(dot)com>
Date: Mon Jul 18 09:24:55 2022 -0500
doc: mention CREATE+ATTACH PARTITION as an alternative to CREATE TABLE..PARTITION OF
See also: 898e5e3290a72d288923260143930fb32036c00c
Should backpatch to v12
diff --git a/doc/src/sgml/ref/create_table.sgml b/doc/src/sgml/ref/create_table.sgml
index 6bbf15ed1a4..db7d8710bae 100644
--- a/doc/src/sgml/ref/create_table.sgml
+++ b/doc/src/sgml/ref/create_table.sgml
@@ -619,6 +619,16 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
with <literal>DROP TABLE</literal> requires taking an <literal>ACCESS
EXCLUSIVE</literal> lock on the parent table.
</para>
+
+ <para>
+ Note that creating a partition acquires an <literal>ACCESS
+ EXCLUSIVE</literal> lock on the parent table.
+ It may be preferable to first CREATE a separate table and then ATTACH it,
+ which does not require as strong of a lock.
+ See <link linkend="sql-altertable-attach-partition">ATTACH PARTITION</link>
+ and <xref linkend="ddl-partitioning"/> for more information.
+ </para>
+
</listitem>
</varlistentry>
From | Date | Subject | |
---|---|---|---|
Next Message | Andrew Dunstan | 2022-07-18 14:39:09 | Re: doc: mentioned CREATE+ATTACH PARTITION as an alternative to CREATE TABLE..PARTITION OF |
Previous Message | Pavel Stehule | 2022-07-18 14:32:56 | Re: limits of max, min optimization |