2004-06-25 23:55:59 +02:00
|
|
|
<!--
|
2010-09-20 22:08:53 +02:00
|
|
|
doc/src/sgml/ref/alter_tablespace.sgml
|
2004-06-25 23:55:59 +02:00
|
|
|
PostgreSQL documentation
|
|
|
|
-->
|
|
|
|
|
2017-10-20 03:16:39 +02:00
|
|
|
<refentry id="sql-altertablespace">
|
2014-02-24 03:25:35 +01:00
|
|
|
<indexterm zone="sql-altertablespace">
|
|
|
|
<primary>ALTER TABLESPACE</primary>
|
|
|
|
</indexterm>
|
|
|
|
|
2004-06-25 23:55:59 +02:00
|
|
|
<refmeta>
|
2010-04-03 09:23:02 +02:00
|
|
|
<refentrytitle>ALTER TABLESPACE</refentrytitle>
|
2008-11-14 11:22:48 +01:00
|
|
|
<manvolnum>7</manvolnum>
|
2004-06-25 23:55:59 +02:00
|
|
|
<refmiscinfo>SQL - Language Statements</refmiscinfo>
|
|
|
|
</refmeta>
|
|
|
|
|
|
|
|
<refnamediv>
|
|
|
|
<refname>ALTER TABLESPACE</refname>
|
2014-08-29 05:59:03 +02:00
|
|
|
<refpurpose>change the definition of a tablespace</refpurpose>
|
2010-11-23 21:27:50 +01:00
|
|
|
</refnamediv>
|
|
|
|
|
2004-06-25 23:55:59 +02:00
|
|
|
<refsynopsisdiv>
|
|
|
|
<synopsis>
|
2009-09-19 12:23:27 +02:00
|
|
|
ALTER TABLESPACE <replaceable>name</replaceable> RENAME TO <replaceable>new_name</replaceable>
|
Allow CURRENT/SESSION_USER to be used in certain commands
Commands such as ALTER USER, ALTER GROUP, ALTER ROLE, GRANT, and the
various ALTER OBJECT / OWNER TO, as well as ad-hoc clauses related to
roles such as the AUTHORIZATION clause of CREATE SCHEMA, the FOR clause
of CREATE USER MAPPING, and the FOR ROLE clause of ALTER DEFAULT
PRIVILEGES can now take the keywords CURRENT_USER and SESSION_USER as
user specifiers in place of an explicit user name.
This commit also fixes some quite ugly handling of special standards-
mandated syntax in CREATE USER MAPPING, which in particular would fail
to work in presence of a role named "current_user".
The special role specifiers PUBLIC and NONE also have more consistent
handling now.
Also take the opportunity to add location tracking to user specifiers.
Authors: Kyotaro Horiguchi. Heavily reworked by Álvaro Herrera.
Reviewed by: Rushabh Lathia, Adam Brightwell, Marti Raudsepp.
2015-03-09 19:41:54 +01:00
|
|
|
ALTER TABLESPACE <replaceable>name</replaceable> OWNER TO { <replaceable>new_owner</replaceable> | CURRENT_USER | SESSION_USER }
|
2017-10-09 04:00:57 +02:00
|
|
|
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> [, ... ] )
|
2004-06-25 23:55:59 +02:00
|
|
|
</synopsis>
|
|
|
|
</refsynopsisdiv>
|
2010-11-23 21:27:50 +01:00
|
|
|
|
2004-06-25 23:55:59 +02:00
|
|
|
<refsect1>
|
|
|
|
<title>Description</title>
|
|
|
|
|
|
|
|
<para>
|
2014-01-19 00:56:40 +01:00
|
|
|
<command>ALTER TABLESPACE</command> can be used to change the definition of
|
2014-11-14 21:16:01 +01:00
|
|
|
a tablespace.
|
2004-06-25 23:55:59 +02:00
|
|
|
</para>
|
2005-10-14 00:44:51 +02:00
|
|
|
|
|
|
|
<para>
|
2014-01-19 00:56:40 +01:00
|
|
|
You must own the tablespace to change the definition of a tablespace.
|
2005-10-14 00:44:51 +02:00
|
|
|
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.)
|
2014-07-27 05:19:02 +02:00
|
|
|
</para>
|
|
|
|
|
2004-06-25 23:55:59 +02:00
|
|
|
</refsect1>
|
2010-11-23 21:27:50 +01:00
|
|
|
|
2004-06-25 23:55:59 +02:00
|
|
|
<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>
|
2009-09-19 12:23:27 +02:00
|
|
|
<term><replaceable class="parameter">new_name</replaceable></term>
|
2004-06-25 23:55:59 +02:00
|
|
|
<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>
|
2009-09-19 12:23:27 +02:00
|
|
|
<term><replaceable class="parameter">new_owner</replaceable></term>
|
2004-06-25 23:55:59 +02:00
|
|
|
<listitem>
|
|
|
|
<para>
|
|
|
|
The new owner of the tablespace.
|
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
2010-01-05 22:54:00 +01:00
|
|
|
|
|
|
|
<varlistentry>
|
2012-10-09 09:29:37 +02:00
|
|
|
<term><replaceable class="parameter">tablespace_option</replaceable></term>
|
2010-01-05 22:54:00 +01:00
|
|
|
<listitem>
|
|
|
|
<para>
|
|
|
|
A tablespace parameter to be set or reset. Currently, the only
|
2017-10-09 03:44:17 +02:00
|
|
|
available parameters are <varname>seq_page_cost</varname>,
|
|
|
|
<varname>random_page_cost</varname> and <varname>effective_io_concurrency</varname>.
|
2016-12-16 17:25:29 +01:00
|
|
|
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
|
2017-11-23 15:39:47 +01:00
|
|
|
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
|
2016-12-16 17:25:29 +01:00
|
|
|
one tablespace is located on a disk which is faster or slower than the
|
2010-01-05 22:54:00 +01:00
|
|
|
remainder of the I/O subsystem.
|
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
2014-01-19 00:56:40 +01:00
|
|
|
|
2004-06-25 23:55:59 +02:00
|
|
|
</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;
|
2011-08-07 09:49:45 +02:00
|
|
|
</programlisting></para>
|
2004-06-25 23:55:59 +02:00
|
|
|
</refsect1>
|
2010-11-23 21:27:50 +01:00
|
|
|
|
2004-06-25 23:55:59 +02:00
|
|
|
<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">
|
2017-11-23 15:39:47 +01:00
|
|
|
<member><xref linkend="sql-createtablespace"/></member>
|
|
|
|
<member><xref linkend="sql-droptablespace"/></member>
|
2004-06-25 23:55:59 +02:00
|
|
|
</simplelist>
|
|
|
|
</refsect1>
|
|
|
|
</refentry>
|