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

Doc: remove obsolete statements about system OID columns in ALTER TABLE.

Browse Source 
Missed in commit 578b22971.
This commit is contained in:
Tom Lane 2018-12-07 14:50:46 -05:00
parent b90e6cef12
commit 1464755fc4
1 changed files with 6 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
doc/src/sgml/ref/alter_table.sgml
View File

@ -616,9 +616,9 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
<term><literal>SET WITHOUT OIDS</literal></term> <term><literal>SET WITHOUT OIDS</literal></term>
<listitem> <listitem>
<para> <para>
Backward compatibility syntax for removing the <literal>oid</literal> Backward-compatible syntax for removing the <literal>oid</literal>
system column. As oid system columns cannot be added anymore, this never system column. As <literal>oid</literal> system columns cannot be
has an effect. added anymore, this never has an effect.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -744,8 +744,7 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
<para> <para>
This form links the table to a composite type as though <command>CREATE This form links the table to a composite type as though <command>CREATE
TABLE OF</command> had formed it. The table's list of column names and types TABLE OF</command> had formed it. The table's list of column names and types
must precisely match that of the composite type; the presence of must precisely match that of the composite type. The table must
an <literal>oid</literal> system column is permitted to differ. The table must
not inherit from any other table. These restrictions ensure not inherit from any other table. These restrictions ensure
that <command>CREATE TABLE OF</command> would permit an equivalent table that <command>CREATE TABLE OF</command> would permit an equivalent table
definition. definition.
@ -1178,8 +1177,7 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
the column contents and the old type is either binary coercible to the new the column contents and the old type is either binary coercible to the new
type or an unconstrained domain over the new type, a table rewrite is not type or an unconstrained domain over the new type, a table rewrite is not
needed; but any indexes on the affected columns must still be rebuilt. needed; but any indexes on the affected columns must still be rebuilt.
Adding or removing a system <literal>oid</literal> column also requires Table and/or index rebuilds may take a
rewriting the entire table. Table and/or index rebuilds may take a
significant amount of time for a large table; and will temporarily require significant amount of time for a large table; and will temporarily require
as much as double the disk space. as much as double the disk space.
</para> </para>
@ -1208,9 +1206,7 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
column. Thus, dropping a column is quick but it will not immediately column. Thus, dropping a column is quick but it will not immediately
reduce the on-disk size of your table, as the space occupied reduce the on-disk size of your table, as the space occupied
by the dropped column is not reclaimed. The space will be by the dropped column is not reclaimed. The space will be
reclaimed over time as existing rows are updated. (These statements do reclaimed over time as existing rows are updated.
not apply when dropping the system <literal>oid</literal> column; that is done
with an immediate rewrite.)
</para> </para>
<para> <para>