| <!-- |
| $PostgreSQL: pgsql/doc/src/sgml/ref/alter_schema.sgml,v 1.9 2006/09/16 00:30:16 momjian Exp $ |
| PostgreSQL documentation |
| --> |
| |
| <refentry id="SQL-ALTERSCHEMA"> |
| <refmeta> |
| <refentrytitle id="SQL-ALTERSCHEMA-title">ALTER SCHEMA</refentrytitle> |
| <refmiscinfo>SQL - Language Statements</refmiscinfo> |
| </refmeta> |
| |
| <refnamediv> |
| <refname>ALTER SCHEMA</refname> |
| <refpurpose>change the definition of a schema</refpurpose> |
| </refnamediv> |
| |
| <indexterm zone="sql-alterschema"> |
| <primary>ALTER SCHEMA</primary> |
| </indexterm> |
| |
| <refsynopsisdiv> |
| <synopsis> |
| ALTER SCHEMA <replaceable>name</replaceable> RENAME TO <replaceable>newname</replaceable> |
| ALTER SCHEMA <replaceable>name</replaceable> OWNER TO <replaceable>newowner</replaceable> |
| </synopsis> |
| </refsynopsisdiv> |
| |
| <refsect1> |
| <title>Description</title> |
| |
| <para> |
| <command>ALTER SCHEMA</command> changes the definition of a schema. |
| </para> |
| |
| <para> |
| You must own the schema to use <command>ALTER SCHEMA</>. |
| To rename a schema you must also have the |
| <literal>CREATE</literal> privilege for the database. |
| To alter the owner, you must also be a direct or |
| indirect member of the new owning role, and you must have the |
| <literal>CREATE</literal> privilege for the database. |
| (Note that superusers have all these privileges automatically.) |
| </para> |
| </refsect1> |
| |
| <refsect1> |
| <title>Parameters</title> |
| |
| <variablelist> |
| <varlistentry> |
| <term><replaceable>name</replaceable></term> |
| <listitem> |
| <para> |
| The name of an existing schema. |
| </para> |
| </listitem> |
| </varlistentry> |
| |
| <varlistentry> |
| <term><replaceable>newname</replaceable></term> |
| <listitem> |
| <para> |
| The new name of the schema. The new name cannot |
| begin with <literal>pg_</literal>, as such names |
| are reserved for system schemas. |
| </para> |
| </listitem> |
| </varlistentry> |
| |
| <varlistentry> |
| <term><replaceable class="parameter">newowner</replaceable></term> |
| <listitem> |
| <para> |
| The new owner of the schema. |
| </para> |
| </listitem> |
| </varlistentry> |
| </variablelist> |
| </refsect1> |
| |
| <refsect1> |
| <title>Compatibility</title> |
| |
| <para> |
| There is no <command>ALTER SCHEMA</command> statement in the SQL |
| standard. |
| </para> |
| </refsect1> |
| |
| <refsect1> |
| <title>See Also</title> |
| |
| <simplelist type="inline"> |
| <member><xref linkend="sql-createschema" endterm="sql-createschema-title"></member> |
| <member><xref linkend="sql-dropschema" endterm="sql-dropschema-title"></member> |
| </simplelist> |
| </refsect1> |
| |
| </refentry> |