mirror of
https://github.com/postgres/postgres.git
synced 2025-09-02 04:21:28 +03:00
Core support for "extensions", which are packages of SQL objects.
This patch adds the server infrastructure to support extensions. There is still one significant loose end, namely how to make it play nice with pg_upgrade, so I am not yet committing the changes that would make all the contrib modules depend on this feature. In passing, fix a disturbingly large amount of breakage in AlterObjectNamespace() and callers. Dimitri Fontaine, reviewed by Anssi Kääriäinen, Itagaki Takahiro, Tom Lane, and numerous others
This commit is contained in:
98
doc/src/sgml/ref/alter_extension.sgml
Normal file
98
doc/src/sgml/ref/alter_extension.sgml
Normal file
@@ -0,0 +1,98 @@
|
||||
<!--
|
||||
doc/src/sgml/ref/alter_extension.sgml
|
||||
PostgreSQL documentation
|
||||
-->
|
||||
|
||||
<refentry id="SQL-ALTEREXTENSION">
|
||||
<refmeta>
|
||||
<refentrytitle>ALTER EXTENSION</refentrytitle>
|
||||
<manvolnum>7</manvolnum>
|
||||
<refmiscinfo>SQL - Language Statements</refmiscinfo>
|
||||
</refmeta>
|
||||
|
||||
<refnamediv>
|
||||
<refname>ALTER EXTENSION</refname>
|
||||
<refpurpose>
|
||||
change the definition of an extension
|
||||
</refpurpose>
|
||||
</refnamediv>
|
||||
|
||||
<indexterm zone="sql-alterextension">
|
||||
<primary>ALTER EXTENSION</primary>
|
||||
</indexterm>
|
||||
|
||||
<refsynopsisdiv>
|
||||
<synopsis>
|
||||
ALTER EXTENSION <replaceable class="PARAMETER">name</replaceable> SET SCHEMA <replaceable class="PARAMETER">new_schema</replaceable>
|
||||
</synopsis>
|
||||
</refsynopsisdiv>
|
||||
|
||||
<refsect1>
|
||||
<title>Description</title>
|
||||
|
||||
<para>
|
||||
<command>ALTER EXTENSION</command> changes the definition of an existing extension.
|
||||
Currently there is only one subform:
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><literal>SET SCHEMA</literal></term>
|
||||
<listitem>
|
||||
<para>
|
||||
This form moves the extension's objects into another schema. The
|
||||
extension has to be <firstterm>relocatable</> for this command to
|
||||
succeed. See <xref linkend="extend-extensions"> for details.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
</para>
|
||||
</refsect1>
|
||||
|
||||
<refsect1>
|
||||
<title>Parameters</title>
|
||||
|
||||
<para>
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><replaceable class="PARAMETER">name</replaceable></term>
|
||||
<listitem>
|
||||
<para>
|
||||
The name of an installed extension.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
<varlistentry>
|
||||
<term><replaceable class="PARAMETER">new_schema</replaceable></term>
|
||||
<listitem>
|
||||
<para>
|
||||
The new schema for the extension.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
</para>
|
||||
</refsect1>
|
||||
|
||||
<refsect1>
|
||||
<title>Examples</title>
|
||||
|
||||
<para>
|
||||
To change the schema of the extension <literal>hstore</literal>
|
||||
to <literal>utils</literal>:
|
||||
<programlisting>
|
||||
ALTER EXTENSION hstore SET SCHEMA utils;
|
||||
</programlisting>
|
||||
</para>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 id="SQL-ALTEREXTENSION-see-also">
|
||||
<title>See Also</title>
|
||||
|
||||
<simplelist type="inline">
|
||||
<member><xref linkend="sql-createextension"></member>
|
||||
<member><xref linkend="sql-dropextension"></member>
|
||||
</simplelist>
|
||||
</refsect1>
|
||||
</refentry>
|
Reference in New Issue
Block a user