doc: clarify PERIOD and WITHOUT OVERLAPS in CREATE TABLE

Discussion: https://postgr.es/m/04938501-fc8f-46f3-97a4-9a81a3f24530@illuminatedcomputing.com

Author: Paul Jungwirth

Backpatch-through: master
This commit is contained in:
Bruce Momjian 2024-05-09 16:34:09 -04:00
parent d727c54317
commit c3db1f30cb

View file

@ -1184,11 +1184,13 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
referent for its entire duration. This column must be a range or referent for its entire duration. This column must be a range or
multirange type. In addition, the referenced table must have a primary multirange type. In addition, the referenced table must have a primary
key or unique constraint declared with <literal>WITHOUT key or unique constraint declared with <literal>WITHOUT
OVERLAPS</literal>. Finally, if one side of the foreign key uses OVERLAPS</literal>. Finally, if the foreign key has a PERIOD
<literal>PERIOD</literal>, the other side must too. If the <replaceable <replaceable class="parameter">column_name</replaceable> specification
class="parameter">refcolumn</replaceable> list is omitted, the the corresponding <replaceable class="parameter">refcolumn</replaceable>,
<literal>WITHOUT OVERLAPS</literal> part of the primary key is treated if present, must also be marked <literal>PERIOD</literal>. If the
as if marked with <literal>PERIOD</literal>. <replaceable class="parameter">refcolumn</replaceable> clause is omitted,
and thus the reftable's primary key constraint chosen, the primary key
must have its final column marked <literal>WITHOUT OVERLAPS</literal>.
</para> </para>
<para> <para>