diff options
Diffstat (limited to 'doc/src/sgml/ref/alter_tablespace.sgml')
-rw-r--r-- | doc/src/sgml/ref/alter_tablespace.sgml | 125 |
1 files changed, 125 insertions, 0 deletions
diff --git a/doc/src/sgml/ref/alter_tablespace.sgml b/doc/src/sgml/ref/alter_tablespace.sgml new file mode 100644 index 00000000000..bdfe4b81553 --- /dev/null +++ b/doc/src/sgml/ref/alter_tablespace.sgml @@ -0,0 +1,125 @@ +<!-- +$PostgreSQL: pgsql/doc/src/sgml/ref/alter_tablespace.sgml,v 1.1 2004/06/25 21:55:50 tgl Exp $ +PostgreSQL documentation +--> + +<refentry id="SQL-ALTERTABLESPACE"> + <refmeta> + <refentrytitle id="SQL-ALTERTABLESPACE-TITLE">ALTER TABLESPACE</refentrytitle> + <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> + </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. + You must be a superuser to change the owner of a 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> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:nil +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +sgml-parent-document:nil +sgml-default-dtd-file:"../reference.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:"/usr/lib/sgml/catalog" +sgml-local-ecat-files:nil +End: +--> |