diff options
Diffstat (limited to 'doc/src/sgml/ref/alter_schema.sgml')
-rw-r--r-- | doc/src/sgml/ref/alter_schema.sgml | 100 |
1 files changed, 100 insertions, 0 deletions
diff --git a/doc/src/sgml/ref/alter_schema.sgml b/doc/src/sgml/ref/alter_schema.sgml new file mode 100644 index 0000000..04624c5 --- /dev/null +++ b/doc/src/sgml/ref/alter_schema.sgml @@ -0,0 +1,100 @@ +<!-- +doc/src/sgml/ref/alter_schema.sgml +PostgreSQL documentation +--> + +<refentry id="sql-alterschema"> + <indexterm zone="sql-alterschema"> + <primary>ALTER SCHEMA</primary> + </indexterm> + + <refmeta> + <refentrytitle>ALTER SCHEMA</refentrytitle> + <manvolnum>7</manvolnum> + <refmiscinfo>SQL - Language Statements</refmiscinfo> + </refmeta> + + <refnamediv> + <refname>ALTER SCHEMA</refname> + <refpurpose>change the definition of a schema</refpurpose> + </refnamediv> + + <refsynopsisdiv> +<synopsis> +ALTER SCHEMA <replaceable>name</replaceable> RENAME TO <replaceable>new_name</replaceable> +ALTER SCHEMA <replaceable>name</replaceable> OWNER TO { <replaceable>new_owner</replaceable> | CURRENT_ROLE | CURRENT_USER | SESSION_USER } +</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</command>. + 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>new_name</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">new_owner</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"/></member> + <member><xref linkend="sql-dropschema"/></member> + </simplelist> + </refsect1> + +</refentry> |