From 4d04031dd279c4494f4e7b557844f77dec2f5322 Mon Sep 17 00:00:00 2001
From: Michael Paquier <michael@paquier.xyz>
Date: Tue, 5 Nov 2019 10:32:43 +0900
Subject: [PATCH] Doc: Clarify locks taken when using ALTER TABLE ATTACH
PARTITION
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Since 898e5e32, this command uses partially ShareUpdateExclusiveLock,
but the docs did not get the call.
Author: Justin Pryzby
Reviewed-by: Amit Langote, Álvaro Herrera, Michael Paquier
Discussion: https://postgr.es/m/20191028001207.GB23808@telsasoft.com
Backpatch-through: 12
---
doc/src/sgml/ref/alter_table.sgml | 7 +++++++
1 file changed, 7 insertions(+)
diff --git a/doc/src/sgml/ref/alter_table.sgml b/doc/src/sgml/ref/alter_table.sgml
index f86de7a4ac7..44bbfe790e6 100644
--- a/doc/src/sgml/ref/alter_table.sgml
+++ b/doc/src/sgml/ref/alter_table.sgml
@@ -901,6 +901,13 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
the scan of the new partition, it is always skipped when the default
partition is a foreign table.
</para>
+
+ <para>
+ Attaching a partition acquires a
+ <literal>SHARE UPDATE EXCLUSIVE</literal> lock on the parent table,
+ in addition to <literal>ACCESS EXCLUSIVE</literal> locks on the table
+ to be attached and on the default partition (if any).
+ </para>
</listitem>
</varlistentry>
--
GitLab