database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-11-03 09:13:20 +03:00
Code Activity

Correct ALTER TYPE -> SET DATA TYPE in ALTER TABLE documentation.

Browse Source 
The latter is the correct name of the operation to change the data type
of a column.

Noah Misch
This commit is contained in:
Robert Haas
2011-01-25 18:50:35 -05:00
parent 5042d16d12
commit 2b2b2ae2aa
1 changed files with 4 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

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

@@ -777,7 +777,7 @@ ALTER TABLE <replaceable class="PARAMETER">name</replaceable>
</para> </para>
<para> <para>
The fact that <literal>ALTER TYPE</> requires rewriting the whole table The fact that <literal>SET DATA TYPE</> requires rewriting the whole table
is sometimes an advantage, because the rewriting process eliminates is sometimes an advantage, because the rewriting process eliminates
any dead space in the table. For example, to reclaim the space occupied any dead space in the table. For example, to reclaim the space occupied
by a dropped column immediately, the fastest way is: by a dropped column immediately, the fastest way is:
@@ -792,15 +792,15 @@ ALTER TABLE table ALTER COLUMN anycol TYPE anytype;
</para> </para>
<para> <para>
The <literal>USING</literal> option of <literal>ALTER TYPE</> can actually The <literal>USING</literal> option of <literal>SET DATA TYPE</> can actually
specify any expression involving the old values of the row; that is, it specify any expression involving the old values of the row; that is, it
can refer to other columns as well as the one being converted. This allows can refer to other columns as well as the one being converted. This allows
very general conversions to be done with the <literal>ALTER TYPE</> very general conversions to be done with the <literal>SET DATA TYPE</>
syntax. Because of this flexibility, the <literal>USING</literal> syntax. Because of this flexibility, the <literal>USING</literal>
expression is not applied to the column's default value (if any); the expression is not applied to the column's default value (if any); the
result might not be a constant expression as required for a default. result might not be a constant expression as required for a default.
This means that when there is no implicit or assignment cast from old to This means that when there is no implicit or assignment cast from old to
new type, <literal>ALTER TYPE</> might fail to convert the default even new type, <literal>SET DATA TYPE</> might fail to convert the default even
though a <literal>USING</literal> clause is supplied. In such cases, though a <literal>USING</literal> clause is supplied. In such cases,
drop the default with <literal>DROP DEFAULT</>, perform the <literal>ALTER drop the default with <literal>DROP DEFAULT</>, perform the <literal>ALTER
TYPE</>, and then use <literal>SET DEFAULT</> to add a suitable new TYPE</>, and then use <literal>SET DEFAULT</> to add a suitable new