From 2d1018ca56f5ddaf0bfb5b4d0133283f3e823301 Mon Sep 17 00:00:00 2001 From: Stephen Frost Date: Wed, 21 Dec 2016 15:03:32 -0500 Subject: [PATCH] Improve ALTER TABLE documentation 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 --- doc/src/sgml/ref/alter_table.sgml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/src/sgml/ref/alter_table.sgml b/doc/src/sgml/ref/alter_table.sgml index 8ea6624147..44f1ec644f 100644 --- a/doc/src/sgml/ref/alter_table.sgml +++ b/doc/src/sgml/ref/alter_table.sgml @@ -767,11 +767,11 @@ ALTER TABLE [ IF EXISTS ] name - All the actions except RENAME, - SET TABLESPACE, SET SCHEMA, + All the forms of ALTER TABLE that act on a single table, except + RENAME, SET SCHEMA, ATTACH PARTITION, and DETACH PARTITION can be combined into - a list of multiple alterations to apply in parallel. For example, it + a list of multiple alterations to be applied together. For example, it is possible to add several columns and/or alter the type of several columns in a single command. This is particularly useful with large tables, since only one pass over the table need be made. -- 2.40.0