database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-07-30 11:03:19 +03:00
Code Activity

Improve docs for ALTER TABLE .. SET TABLESPACE

Browse Source 
Discussion: https://postgr.es/m/20190220173815.GA7959@alvherre.pgsql
Reviewed-by: Robert Haas
This commit is contained in:
Alvaro Herrera
2019-02-28 19:24:21 -03:00
parent 4598a99cf2
commit 2c31825fb9
1 changed files with 8 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

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

@ -630,6 +630,13 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
moves the data file(s) associated with the table to the new tablespace. moves the data file(s) associated with the table to the new tablespace.
Indexes on the table, if any, are not moved; but they can be moved Indexes on the table, if any, are not moved; but they can be moved
separately with additional <literal>SET TABLESPACE</literal> commands. separately with additional <literal>SET TABLESPACE</literal> commands.
When applied to a partitioned table, nothing is moved, but any
partitions created afterwards with
<command>CREATE TABLE PARTITION OF</command> will use that tablespace,
unless the <literal>TABLESPACE</literal> clause is used to override it.
</para>
<para>
All tables in the current database in a tablespace can be moved by using All tables in the current database in a tablespace can be moved by using
the <literal>ALL IN TABLESPACE</literal> form, which will lock all tables the <literal>ALL IN TABLESPACE</literal> form, which will lock all tables
to be moved first and then move each one. This form also supports to be moved first and then move each one. This form also supports
@ -637,7 +644,7 @@ WITH ( MODULUS <replaceable class="parameter">numeric_literal</replaceable>, REM
roles specified. If the <literal>NOWAIT</literal> option is specified roles specified. If the <literal>NOWAIT</literal> option is specified
then the command will fail if it is unable to acquire all of the locks then the command will fail if it is unable to acquire all of the locks
required immediately. Note that system catalogs are not moved by this required immediately. Note that system catalogs are not moved by this
command, use <command>ALTER DATABASE</command> or explicit command; use <command>ALTER DATABASE</command> or explicit
<command>ALTER TABLE</command> invocations instead if desired. The <command>ALTER TABLE</command> invocations instead if desired. The
<literal>information_schema</literal> relations are not considered part <literal>information_schema</literal> relations are not considered part
of the system catalogs and will be moved. of the system catalogs and will be moved.