mirrors/postgres
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Clarify the default partition's role

Browse Source 
Reviewed by Tom Lane and Amit Langote
Discussion: https://postgr.es/m/20190806222735.GA9535@alvherre.pgsql
This commit is contained in:
Alvaro Herrera 2019-08-08 16:03:14 -04:00
parent 273e78715a
commit bf6455d4c5
1 changed files with 5 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
doc/src/sgml/ref/create_table.sgml
View File

@ -397,8 +397,7 @@ 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>. This option is not available for using <literal>DEFAULT</literal>.
hash-partitioned tables.
</para> </para>
<para> <para>
@ -488,16 +487,15 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
<para> <para>
If <literal>DEFAULT</literal> is specified, the table will be If <literal>DEFAULT</literal> is specified, the table will be
created as a default partition of the parent table. The parent can created as the default partition of the parent table. This option
either be a list or range partitioned table. A partition key value is not available for hash-partitioned tables. A partition key value
not fitting into any other partition of the given parent will be not fitting into any other partition of the given parent will be
routed to the default partition. There can be only one default routed to the default partition.
partition for a given parent table.
</para> </para>
<para> <para>
When a table has an existing <literal>DEFAULT</literal> partition and When a table has an existing <literal>DEFAULT</literal> partition and
a new partition is added to it, the existing default partition must a new partition is added to it, the default partition must
be scanned to verify that it does not contain any rows which properly be scanned to verify that it does not contain any rows which properly
belong in the new partition. If the default partition contains a belong in the new partition. If the default partition contains a
large number of rows, this may be slow. The scan will be skipped if large number of rows, this may be slow. The scan will be skipped if