mirror of
https://github.com/postgres/postgres.git
synced 2025-06-03 01:21:48 +03:00
6ef2448796
There is what may actually be a mistake in our markup. The problem is in a situation like <para> <command>FOO</command> is ... there is strictly speaking a line break before "FOO". In the HTML output, this does not appear to be a problem, but in the man page output, this shows up, so you get double blank lines at odd places. So far, we have attempted to work around this with an XSL hack, but that causes other problems, such as creating run-ins in places like <acronym>SQL</acronym> <command>COPY</command> So fix the problem properly by removing the extra whitespace. I only fixed the problems that affect the man page output, not all the places.
135 lines
3.8 KiB
Plaintext
135 lines
3.8 KiB
Plaintext
<!--
|
|
doc/src/sgml/ref/alter_tablespace.sgml
|
|
PostgreSQL documentation
|
|
-->
|
|
|
|
<refentry id="SQL-ALTERTABLESPACE">
|
|
<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>
|
|
|
|
<indexterm zone="sql-altertablespace">
|
|
<primary>ALTER TABLESPACE</primary>
|
|
</indexterm>
|
|
|
|
<refsynopsisdiv>
|
|
<synopsis>
|
|
ALTER TABLESPACE <replaceable>name</replaceable> RENAME TO <replaceable>new_name</replaceable>
|
|
ALTER TABLESPACE <replaceable>name</replaceable> OWNER TO <replaceable>new_owner</replaceable>
|
|
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> 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">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_parameter</replaceable></term>
|
|
<listitem>
|
|
<para>
|
|
A tablespace parameter to be set or reset. Currently, the only
|
|
available parameters are <varname>seq_page_cost</> and
|
|
<varname>random_page_cost</>. 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">). 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>
|