doc: clarify CREATE TABLE AS ... IF NOT EXISTS

Mention that the table is not modified if it already exists.

Reported-by: frank_limpert@yahoo.com

Discussion: https://postgr.es/m/164441177106.9677.5991676148704507229@wrigleys.postgresql.org

Backpatch-through: 10
This commit is contained in:
Bruce Momjian 2022-08-12 10:59:00 -04:00
parent 4d807bbc4b
commit 7d66ccee99
1 changed files with 2 additions and 3 deletions

View File

@ -100,9 +100,8 @@ CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXI
<term><literal>IF NOT EXISTS</literal></term> <term><literal>IF NOT EXISTS</literal></term>
<listitem> <listitem>
<para> <para>
Do not throw an error if a relation with the same name already exists. Do not throw an error if a relation with the same name already
A notice is issued in this case. Refer to <xref linkend="sql-createtable"/> exists; simply issue a notice and leave the table unmodified.
for details.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>