mirror of
https://github.com/postgres/postgres.git
synced 2025-06-04 12:42:24 +03:00
3c49c6facb
Since some preparation work had already been done, the only source changes left were changing empty-element tags like <xref linkend="foo"> to <xref linkend="foo"/>, and changing the DOCTYPE. The source files are still named *.sgml, but they are actually XML files now. Renaming could be considered later. In the build system, the intermediate step to convert from SGML to XML is removed. Everything is build straight from the source files again. The OpenSP (or the old SP) package is no longer needed. The documentation toolchain instructions are updated and are much simpler now. Peter Eisentraut, Alexander Lakhin, Jürgen Purtz
138 lines
4.0 KiB
Plaintext
138 lines
4.0 KiB
Plaintext
<!--
|
|
doc/src/sgml/ref/alter_tablespace.sgml
|
|
PostgreSQL documentation
|
|
-->
|
|
|
|
<refentry id="sql-altertablespace">
|
|
<indexterm zone="sql-altertablespace">
|
|
<primary>ALTER TABLESPACE</primary>
|
|
</indexterm>
|
|
|
|
<refmeta>
|
|
<refentrytitle>ALTER TABLESPACE</refentrytitle>
|
|
<manvolnum>7</manvolnum>
|
|
<refmiscinfo>SQL - Language Statements</refmiscinfo>
|
|
</refmeta>
|
|
|
|
<refnamediv>
|
|
<refname>ALTER TABLESPACE</refname>
|
|
<refpurpose>change the definition of a tablespace</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsynopsisdiv>
|
|
<synopsis>
|
|
ALTER TABLESPACE <replaceable>name</replaceable> RENAME TO <replaceable>new_name</replaceable>
|
|
ALTER TABLESPACE <replaceable>name</replaceable> OWNER TO { <replaceable>new_owner</replaceable> | CURRENT_USER | SESSION_USER }
|
|
ALTER TABLESPACE <replaceable>name</replaceable> SET ( <replaceable class="parameter">tablespace_option</replaceable> = <replaceable class="parameter">value</replaceable> [, ... ] )
|
|
ALTER TABLESPACE <replaceable>name</replaceable> RESET ( <replaceable class="parameter">tablespace_option</replaceable> [, ... ] )
|
|
</synopsis>
|
|
</refsynopsisdiv>
|
|
|
|
<refsect1>
|
|
<title>Description</title>
|
|
|
|
<para>
|
|
<command>ALTER TABLESPACE</command> can be used to change the definition of
|
|
a tablespace.
|
|
</para>
|
|
|
|
<para>
|
|
You must own the tablespace to change the definition of a tablespace.
|
|
To alter the owner, you must also be a direct or indirect member of the new
|
|
owning role.
|
|
(Note that superusers have these privileges automatically.)
|
|
</para>
|
|
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>Parameters</title>
|
|
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><replaceable class="parameter">name</replaceable></term>
|
|
<listitem>
|
|
<para>
|
|
The name of an existing tablespace.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><replaceable class="parameter">new_name</replaceable></term>
|
|
<listitem>
|
|
<para>
|
|
The new name of the tablespace. The new name cannot
|
|
begin with <literal>pg_</literal>, as such names
|
|
are reserved for system tablespaces.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><replaceable class="parameter">new_owner</replaceable></term>
|
|
<listitem>
|
|
<para>
|
|
The new owner of the tablespace.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><replaceable class="parameter">tablespace_option</replaceable></term>
|
|
<listitem>
|
|
<para>
|
|
A tablespace parameter to be set or reset. Currently, the only
|
|
available parameters are <varname>seq_page_cost</varname>,
|
|
<varname>random_page_cost</varname> and <varname>effective_io_concurrency</varname>.
|
|
Setting either value for a particular tablespace will override the
|
|
planner's usual estimate of the cost of reading pages from tables in
|
|
that tablespace, as established by the configuration parameters of the
|
|
same name (see <xref linkend="guc-seq-page-cost"/>,
|
|
<xref linkend="guc-random-page-cost"/>,
|
|
<xref linkend="guc-effective-io-concurrency"/>). This may be useful if
|
|
one tablespace is located on a disk which is faster or slower than the
|
|
remainder of the I/O subsystem.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>Examples</title>
|
|
|
|
<para>
|
|
Rename tablespace <literal>index_space</literal> to <literal>fast_raid</literal>:
|
|
<programlisting>
|
|
ALTER TABLESPACE index_space RENAME TO fast_raid;
|
|
</programlisting>
|
|
</para>
|
|
|
|
<para>
|
|
Change the owner of tablespace <literal>index_space</literal>:
|
|
<programlisting>
|
|
ALTER TABLESPACE index_space OWNER TO mary;
|
|
</programlisting></para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>Compatibility</title>
|
|
|
|
<para>
|
|
There is no <command>ALTER TABLESPACE</command> statement in
|
|
the SQL standard.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1>
|
|
<title>See Also</title>
|
|
|
|
<simplelist type="inline">
|
|
<member><xref linkend="sql-createtablespace"/></member>
|
|
<member><xref linkend="sql-droptablespace"/></member>
|
|
</simplelist>
|
|
</refsect1>
|
|
</refentry>
|