mirror of
https://git.postgresql.org/git/postgresql.git
synced 2024-09-30 10:01:14 +02:00
111 lines
2.6 KiB
Plaintext
111 lines
2.6 KiB
Plaintext
|
<!--
|
||
|
doc/src/sgml/ref/drop_subscription.sgml
|
||
|
PostgreSQL documentation
|
||
|
-->
|
||
|
|
||
|
<refentry id="SQL-DROPSUBSCRIPTION">
|
||
|
<indexterm zone="sql-dropsubscription">
|
||
|
<primary>DROP SUBSCRIPTION</primary>
|
||
|
</indexterm>
|
||
|
|
||
|
<refmeta>
|
||
|
<refentrytitle>DROP SUBSCRIPTION</refentrytitle>
|
||
|
<manvolnum>7</manvolnum>
|
||
|
<refmiscinfo>SQL - Language Statements</refmiscinfo>
|
||
|
</refmeta>
|
||
|
|
||
|
<refnamediv>
|
||
|
<refname>DROP SUBSCRIPTION</refname>
|
||
|
<refpurpose>remove a subscription</refpurpose>
|
||
|
</refnamediv>
|
||
|
|
||
|
<refsynopsisdiv>
|
||
|
<synopsis>
|
||
|
DROP SUBSCRIPTION [ IF EXISTS ] <replaceable class="parameter">name</replaceable> [ <replaceable class="parameter">DROP SLOT</replaceable> | <replaceable class="parameter">NODROP SLOT</replaceable> ]
|
||
|
</synopsis>
|
||
|
</refsynopsisdiv>
|
||
|
|
||
|
<refsect1>
|
||
|
<title>Description</title>
|
||
|
|
||
|
<para>
|
||
|
<command>DROP SUBSCRIPTION</command> removes a subscription from the
|
||
|
database cluster.
|
||
|
</para>
|
||
|
|
||
|
<para>
|
||
|
A subscription can only be dropped by a superuser.
|
||
|
</para>
|
||
|
|
||
|
<para>
|
||
|
The replication worker associated with the subscription will not stop until
|
||
|
after the transaction that issued this command has committed.
|
||
|
</para>
|
||
|
</refsect1>
|
||
|
|
||
|
<refsect1>
|
||
|
<title>Parameters</title>
|
||
|
|
||
|
<variablelist>
|
||
|
<varlistentry>
|
||
|
<term><replaceable class="parameter">name</replaceable></term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
The name of a subscription to be dropped.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
|
||
|
<varlistentry>
|
||
|
<term><replaceable class="parameter">DROP SLOT</replaceable></term>
|
||
|
<term><replaceable class="parameter">NODROP SLOT</replaceable></term>
|
||
|
<listitem>
|
||
|
<para>
|
||
|
Specifies whether to drop the replication slot on the publisher. The
|
||
|
default is
|
||
|
<literal>DROP SLOT</literal>.
|
||
|
</para>
|
||
|
|
||
|
<para>
|
||
|
If the publisher is not reachable when the subscription is to be
|
||
|
dropped, then it is useful to specify <literal>NODROP SLOT</literal>.
|
||
|
But the replication slot on the publisher will then have to be removed
|
||
|
manually.
|
||
|
</para>
|
||
|
</listitem>
|
||
|
</varlistentry>
|
||
|
|
||
|
</variablelist>
|
||
|
</refsect1>
|
||
|
|
||
|
<refsect1>
|
||
|
<title>Examples</title>
|
||
|
|
||
|
<para>
|
||
|
Drop a subscription:
|
||
|
<programlisting>
|
||
|
DROP SUBSCRIPTION mysub;
|
||
|
</programlisting>
|
||
|
</para>
|
||
|
|
||
|
</refsect1>
|
||
|
|
||
|
<refsect1>
|
||
|
<title>Compatibility</title>
|
||
|
|
||
|
<para>
|
||
|
<command>DROP SUBSCRIPTION</command> is a <productname>PostgreSQL</>
|
||
|
extension.
|
||
|
</para>
|
||
|
</refsect1>
|
||
|
|
||
|
<refsect1>
|
||
|
<title>See Also</title>
|
||
|
|
||
|
<simplelist type="inline">
|
||
|
<member><xref linkend="sql-createsubscription"></member>
|
||
|
<member><xref linkend="sql-altersubscription"></member>
|
||
|
</simplelist>
|
||
|
</refsect1>
|
||
|
</refentry>
|