Commit 4785e377 authored by Robert Haas's avatar Robert Haas

Tidy up the CREATE TABLE documentation for partitioning.

Remove some <note> tags that make this too "loud".  Fix some typos.

Amit Langote, with a few minor corrections by me

Discussion: http://postgr.es/m/a6f99cdb-21e7-1d65-1381-91f2cfa156e2@lab.ntt.co.jp
parent 7ecb7143
...@@ -261,29 +261,30 @@ CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXI ...@@ -261,29 +261,30 @@ CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXI
any existing partition of that parent. any existing partition of that parent.
</para> </para>
<note>
<para> <para>
Each of the values specified in the partition bound specification is Each of the values specified in the partition bound specification is
a literal, <literal>NULL</literal>, or <literal>UNBOUNDED</literal>. a literal, <literal>NULL</literal>, or <literal>UNBOUNDED</literal>.
A literal is either a numeric constant or a string constant that is A literal is either a numeric constant or a string constant that is
coercable to the corresponding partition key column's type. coercible to the corresponding partition key column's type.
</para> </para>
<para> <para>
When creating a range partition, the lower bound specified with When creating a range partition, the lower bound specified with
<literal>FROM</literal> is an inclusive bound, whereas the upper bound <literal>FROM</literal> is an inclusive bound, whereas the upper
specified with <literal>TO</literal> is an exclusive bound. That is, bound specified with <literal>TO</literal> is an exclusive bound.
the values specified in the <literal>FROM</literal> list are accepted That is, the values specified in the <literal>FROM</literal> list
values of the corresponding partition key columns in a given partition, are accepted values of the corresponding partition key columns in a
whereas those in the <literal>TO</literal> list are not. To be precise, given partition, whereas those in the <literal>TO</literal> list are
this applies only to the first of the partition key columns for which not. To be precise, this applies only to the first of the partition
the corresponding values in the <literal>FROM</literal> and key columns for which the corresponding values in the <literal>FROM</literal>
<literal>TO</literal> lists are not equal. All rows in a given and <literal>TO</literal> lists are not equal. All rows in a given
partition contain the same values for all preceding columns, equal to partition contain the same values for all preceding columns, equal to
those specified in <literal>FROM</literal> and <literal>TO</literal> those specified in <literal>FROM</literal> and <literal>TO</literal>
lists. On the other hand, any subsequent columns are insignificant lists. On the other hand, any subsequent columns are insignificant
as far as implicit partition constraint is concerned. as far as implicit partition constraint is concerned.
</para>
<para>
Specifying <literal>UNBOUNDED</literal> in <literal>FROM</literal> Specifying <literal>UNBOUNDED</literal> in <literal>FROM</literal>
signifies <literal>-infinity</literal> as the lower bound of the signifies <literal>-infinity</literal> as the lower bound of the
corresponding column, whereas it signifies <literal>+infinity</literal> corresponding column, whereas it signifies <literal>+infinity</literal>
...@@ -291,13 +292,12 @@ CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXI ...@@ -291,13 +292,12 @@ CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXI
</para> </para>
<para> <para>
When creating a list partition, <literal>NULL</literal> can be specified When creating a list partition, <literal>NULL</literal> can be
to signify that the partition allows the partition key column to be null. specified to signify that the partition allows the partition key
However, there cannot be more than one such list partitions for a given column to be null. However, there cannot be more than one such
parent table. <literal>NULL</literal> cannot specified for range list partition for a given parent table. <literal>NULL</literal>
partitions. cannot be specified for range partitions.
</para> </para>
</note>
<para> <para>
A partition must have the same column names and types as the partitioned A partition must have the same column names and types as the partitioned
......
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