Document partitiong tables ancillary object handling some more

Add a couple of lines to make it explicit that indexes, constraints,
triggers are added, removed, or left alone.

Backpatch to pg11.

Author: Álvaro Herrera <alvherre@alvh.no-ip.org>
Reviewed-by: Justin Pryzby <pryzby@telsasoft.com>
Discussion: https://postgr.es/m/20200421162038.GA18628@alvherre.pgsql
This commit is contained in:
Alvaro Herrera 2020-04-21 17:14:18 -04:00
parent d12bdba77b
commit 8803506c41
No known key found for this signature in database
GPG Key ID: 1C20ACB9D5C564AE
2 changed files with 9 additions and 4 deletions

View File

@ -872,7 +872,9 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
Note that if the existing table is a foreign table, it is currently not
allowed to attach the table as a partition of the target table if there
are <literal>UNIQUE</literal> indexes on the target table. (See also
<xref linkend="sql-createforeigntable"/>.)
<xref linkend="sql-createforeigntable"/>.) For each user-defined
row-level trigger that exists in the target table, a corresponding one
is created in the attached table.
</para>
<para>
@ -941,10 +943,11 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
<term><literal>DETACH PARTITION</literal> <replaceable class="parameter">partition_name</replaceable></term>
<listitem>
<para>
This form detaches specified partition of the target table. The detached
This form detaches the specified partition of the target table. The detached
partition continues to exist as a standalone table, but no longer has any
ties to the table from which it was detached. Any indexes that were
attached to the target table's indexes are detached.
attached to the target table's indexes are detached. Any triggers that
were created as clones of those in the target table are removed.
</para>
</listitem>
</varlistentry>

View File

@ -399,7 +399,9 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
Creates the table as a <firstterm>partition</firstterm> of the specified
parent table. The table can be created either as a partition for specific
values using <literal>FOR VALUES</literal> or as a default partition
using <literal>DEFAULT</literal>.
using <literal>DEFAULT</literal>. Any indexes, constraints and
user-defined row-level triggers that exist in the parent table are cloned
on the new partition.
</para>
<para>