database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-07-28 23:42:10 +03:00
Code Activity

Tidy up the CREATE TABLE documentation for partitioning.

Browse Source 
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
This commit is contained in:
Robert Haas
2017-03-27 11:00:09 -04:00
parent 7ecb714358
commit 4785e377f9
1 changed files with 34 additions and 34 deletions
Download Patch File Download Diff File Expand all files Collapse all files

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

@ -261,43 +261,43 @@ 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 coercible to the corresponding partition key column's type.
coercable 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>
Specifying <literal>UNBOUNDED</literal> in <literal>FROM</literal> <para>
signifies <literal>-infinity</literal> as the lower bound of the Specifying <literal>UNBOUNDED</literal> in <literal>FROM</literal>
corresponding column, whereas it signifies <literal>+infinity</literal> signifies <literal>-infinity</literal> as the lower bound of the
as the upper bound when specified in <literal>TO</literal>. corresponding column, whereas it signifies <literal>+infinity</literal>
</para> as the upper bound when specified in <literal>TO</literal>.
</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