Commit 8803506c authored by Alvaro Herrera's avatar Alvaro Herrera

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: default avatarJustin Pryzby <pryzby@telsasoft.com>
Discussion: https://postgr.es/m/20200421162038.GA18628@alvherre.pgsql
parent d12bdba7
...@@ -872,7 +872,9 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM ...@@ -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 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 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 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>
<para> <para>
...@@ -941,10 +943,11 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM ...@@ -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> <term><literal>DETACH PARTITION</literal> <replaceable class="parameter">partition_name</replaceable></term>
<listitem> <listitem>
<para> <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 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 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> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
......
...@@ -399,7 +399,9 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM ...@@ -399,7 +399,9 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
Creates the table as a <firstterm>partition</firstterm> of the specified Creates the table as a <firstterm>partition</firstterm> of the specified
parent table. The table can be created either as a partition for specific parent table. The table can be created either as a partition for specific
values using <literal>FOR VALUES</literal> or as a default partition 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>
<para> <para>
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment