database/postgres
database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-05-06 19:59:18 +03:00
Code

Improve ALTER TABLE documentation

Browse Source 
The ALTER TABLE documentation wasn't terribly clear when it came to
which commands could be combined together and what it meant when they
were.

In particular, SET TABLESPACE *can* be combined with other commands,
when it's operating against a single table, but not when multiple tables
are being moved with ALL IN TABLESPACE.  Further, the actions are
applied together but not really in 'parallel', at least today.

Pointed out by: Amit Langote

Improved wording from Tom.

Back-patch to 9.4, where the ALL IN TABLESPACE option was added.

Discussion: https://www.postgresql.org/message-id/14c535b4-13ef-0590-1b98-76af355a0763%40lab.ntt.co.jp
This commit is contained in:
Stephen Frost 2016-12-21 15:03:37 -05:00
parent 542975a147
commit eaac6c7585
1 changed files with 4 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -708,10 +708,10 @@ ALTER TABLE ALL IN TABLESPACE <replaceable class="PARAMETER">name</replaceable>
</para> </para>
<para> <para>
All the actions except <literal>RENAME</literal>, All the forms of ALTER TABLE that act on a single table, except
<literal>SET TABLESPACE</literal> and <literal>SET SCHEMA</literal> <literal>RENAME</literal>, and <literal>SET SCHEMA</literal>
can be combined into can be combined into a list of multiple alterations to applied together.
a list of multiple alterations to apply in parallel. For example, it For example, it
is possible to add several columns and/or alter the type of several is possible to add several columns and/or alter the type of several
columns in a single command. This is particularly useful with large columns in a single command. This is particularly useful with large
tables, since only one pass over the table need be made. tables, since only one pass over the table need be made.