mirror of
https://github.com/postgres/postgres.git
synced 2025-12-19 17:02:53 +03:00
d129255077
another section if required by the platform (instead of the old way of building them in section "l" and always transforming them to the platform-specific section). This speeds up the installation on common platforms, and it avoids some funny business with the man page tools and build process.
116 lines
2.9 KiB
Plaintext
116 lines
2.9 KiB
Plaintext
<!--
|
|
$PostgreSQL: pgsql/doc/src/sgml/ref/alter_tablespace.sgml,v 1.4 2008/11/14 10:22:45 petere Exp $
|
|
PostgreSQL documentation
|
|
-->
|
|
|
|
<refentry id="SQL-ALTERTABLESPACE">
|
|
<refmeta>
|
|
<refentrytitle id="SQL-ALTERTABLESPACE-TITLE">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>
|
|
|
|
<indexterm zone="sql-altertablespace">
|
|
<primary>ALTER TABLESPACE</primary>
|
|
</indexterm>
|
|
|
|
<refsynopsisdiv>
|
|
<synopsis>
|
|
ALTER TABLESPACE <replaceable>name</replaceable> RENAME TO <replaceable>newname</replaceable>
|
|
ALTER TABLESPACE <replaceable>name</replaceable> OWNER TO <replaceable>newowner</replaceable>
|
|
</synopsis>
|
|
</refsynopsisdiv>
|
|
|
|
<refsect1>
|
|
<title>Description</title>
|
|
|
|
<para>
|
|
<command>ALTER TABLESPACE</command> changes the definition of
|
|
a tablespace.
|
|
</para>
|
|
|
|
<para>
|
|
You must own the tablespace to use <command>ALTER 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">newname</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">newowner</replaceable></term>
|
|
<listitem>
|
|
<para>
|
|
The new owner of the tablespace.
|
|
</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" endterm="sql-createtablespace-title"></member>
|
|
<member><xref linkend="sql-droptablespace" endterm="sql-droptablespace-title"></member>
|
|
</simplelist>
|
|
</refsect1>
|
|
</refentry>
|