mirror of
https://git.postgresql.org/git/postgresql.git
synced 2024-10-06 18:16:55 +02:00
doc: Fix up ALTER TABLESPACE reference page
The documentation of ALTER TABLESPACE ... MOVE was added without any markup, not even paragraph breaks. Fix that, and clarify the text in a few places.
This commit is contained in:
parent
a8dddcaf75
commit
48f9e3d22e
@ -43,30 +43,45 @@ ALTER TABLESPACE <replaceable>name</replaceable> MOVE { ALL | TABLES | INDEXES |
|
|||||||
To alter the owner, you must also be a direct or indirect member of the new
|
To alter the owner, you must also be a direct or indirect member of the new
|
||||||
owning role.
|
owning role.
|
||||||
(Note that superusers have these privileges automatically.)
|
(Note that superusers have these privileges automatically.)
|
||||||
|
</para>
|
||||||
|
|
||||||
Users may use ALTER TABLESPACE ... MOVE to move objects between tablespaces.
|
<para>
|
||||||
ALL will move all tables, indexes and materialized views while specifying
|
<literal>ALTER TABLESPACE ... MOVE</literal> moves objects between
|
||||||
TABLES will move only tables (but not their indexes), INDEXES will only move
|
tablespaces. <literal>ALL</literal> will move all tables, indexes and
|
||||||
indexes (including those underneath materialized views, but not tables) and
|
materialized views; specifying <literal>TABLES</literal> will move only
|
||||||
MATERIALIZED VIEWS will only move the table relation of the materialized
|
tables (but not their indexes), <literal>INDEXES</literal> will only move
|
||||||
view (but no indexes associated with it). Users may also specify a list of
|
indexes (including those underneath materialized views, but not tables),
|
||||||
roles whose objects are to be moved using OWNED BY.
|
and <literal>MATERIALIZED VIEWS</literal> will only move the table relation
|
||||||
|
of the materialized view (but no indexes associated with it). Users can
|
||||||
|
also specify a list of roles whose objects are to be moved, using
|
||||||
|
<literal>OWNED BY</literal>.
|
||||||
|
</para>
|
||||||
|
|
||||||
Users must have CREATE rights on the new tablespace and be considered an
|
<para>
|
||||||
owner (either directly or indirectly) on all objects to be moved. Note that
|
Users must have <literal>CREATE</literal> rights on the new tablespace and
|
||||||
the superuser is considered an owner of all objects and therefore an
|
be considered an owner (either directly or indirectly) of all objects to be
|
||||||
ALTER TABLESPACE ... MOVE ALL issued by the superuser will move all objects
|
moved. Note that the superuser is considered an owner of all objects, and
|
||||||
in the current database which are in the tablespace.
|
therefore an <literal>ALTER TABLESPACE ... MOVE ALL</literal> issued by the
|
||||||
|
superuser will move all objects in the current database that are in the
|
||||||
|
tablespace. (Attempting to move objects without the required rights will
|
||||||
|
result in an error. Non-superusers can use <literal>OWNED BY</literal> in
|
||||||
|
such cases, to restrict the set of objects moved to those with the required
|
||||||
|
rights.)
|
||||||
|
</para>
|
||||||
|
|
||||||
All objects to be moved will be locked immediately by the command. The
|
<para>
|
||||||
NOWAIT option, if specified, will cause the command to fail if it is unable
|
All objects to be moved will be locked immediately by the command. If the
|
||||||
to acquire the locks.
|
<literal>NOWAIT</literal> is specified, it will cause the command to fail
|
||||||
|
if it is unable to acquire the locks.
|
||||||
|
</para>
|
||||||
|
|
||||||
System catalogs will not be moved by this command- individuals wishing to
|
<para>
|
||||||
move a whole database should use ALTER DATABASE, or call ALTER TABLE on the
|
System catalogs will not be moved by this command. To move a whole
|
||||||
individual system catalogs. Note that relations in <literal>information_schema</literal>
|
database, use <command>ALTER DATABASE</command>, or call <command>ALTER
|
||||||
will be moved, just as any other normal database objects, if the user is the
|
TABLE</command> on the individual system catalogs. Note that relations in
|
||||||
superuser or considered an owner of the relations in <literal>information_schema</literal>.
|
<literal>information_schema</literal> will be moved, just as any other
|
||||||
|
normal database objects, if the user is the superuser or considered an
|
||||||
|
owner of the relations in <literal>information_schema</literal>.
|
||||||
</para>
|
</para>
|
||||||
</refsect1>
|
</refsect1>
|
||||||
|
|
||||||
@ -125,7 +140,7 @@ ALTER TABLESPACE <replaceable>name</replaceable> MOVE { ALL | TABLES | INDEXES |
|
|||||||
<term><replaceable class="parameter">role_name</replaceable></term>
|
<term><replaceable class="parameter">role_name</replaceable></term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
Role(s) whose objects are to be moved.
|
Role whose objects are to be moved.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
@ -135,7 +150,7 @@ ALTER TABLESPACE <replaceable>name</replaceable> MOVE { ALL | TABLES | INDEXES |
|
|||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
The name of the tablespace to move objects into. The user must have
|
The name of the tablespace to move objects into. The user must have
|
||||||
CREATE rights on the new tablespace to move objects into that
|
<literal>CREATE</literal> rights on the new tablespace to move objects into that
|
||||||
tablespace, unless the tablespace being moved into is the default
|
tablespace, unless the tablespace being moved into is the default
|
||||||
tablespace for the database connected to.
|
tablespace for the database connected to.
|
||||||
</para>
|
</para>
|
||||||
@ -143,12 +158,12 @@ ALTER TABLESPACE <replaceable>name</replaceable> MOVE { ALL | TABLES | INDEXES |
|
|||||||
</varlistentry>
|
</varlistentry>
|
||||||
|
|
||||||
<varlistentry>
|
<varlistentry>
|
||||||
<term><replaceable class="parameter">NOWAIT</replaceable></term>
|
<term>NOWAIT</term>
|
||||||
<listitem>
|
<listitem>
|
||||||
<para>
|
<para>
|
||||||
The NOWAIT option causes the ALTER TABLESPACE command to fail immediately
|
The <literal>NOWAIT</literal> option causes the <command>ALTER TABLESPACE</command> command to fail immediately
|
||||||
if it is unable to acquire the necessary lock on all of the objects being
|
if it is unable to acquire the necessary lock on all of the objects being
|
||||||
move.
|
moved.
|
||||||
</para>
|
</para>
|
||||||
</listitem>
|
</listitem>
|
||||||
</varlistentry>
|
</varlistentry>
|
||||||
@ -173,7 +188,7 @@ ALTER TABLESPACE index_space OWNER TO mary;
|
|||||||
</programlisting></para>
|
</programlisting></para>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
Move all of the objects which I own from the default tablespace to
|
Move all of the objects from the default tablespace to
|
||||||
the <literal>fast_raid</literal> tablespace:
|
the <literal>fast_raid</literal> tablespace:
|
||||||
<programlisting>
|
<programlisting>
|
||||||
ALTER TABLESPACE pg_default MOVE ALL TO fast_raid;
|
ALTER TABLESPACE pg_default MOVE ALL TO fast_raid;
|
||||||
|
Loading…
Reference in New Issue
Block a user