2017-01-19 18:00:00 +01:00
|
|
|
<!--
|
|
|
|
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>
|
2017-05-09 16:20:42 +02:00
|
|
|
DROP SUBSCRIPTION [ IF EXISTS ] <replaceable class="parameter">name</replaceable> [ CASCADE | RESTRICT ]
|
2017-01-19 18:00:00 +01:00
|
|
|
</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>
|
2017-03-04 05:25:34 +01:00
|
|
|
<command>DROP SUBSCRIPTION</command> cannot be executed inside a
|
2017-05-09 16:20:42 +02:00
|
|
|
transaction block if the subscription is associated with a replication
|
|
|
|
slot. (You can use <command>ALTER SUBSCRIPTION</command> to unset the
|
|
|
|
slot.)
|
2017-01-19 18:00:00 +01:00
|
|
|
</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>
|
2017-05-09 16:20:42 +02:00
|
|
|
<term><literal>CASCADE</literal></term>
|
|
|
|
<term><literal>RESTRICT</literal></term>
|
2017-01-19 18:00:00 +01:00
|
|
|
|
2017-05-09 16:20:42 +02:00
|
|
|
<listitem>
|
2017-01-19 18:00:00 +01:00
|
|
|
<para>
|
2017-05-09 16:20:42 +02:00
|
|
|
These key words do not have any effect, since there are no dependencies
|
|
|
|
on subscriptions.
|
2017-01-19 18:00:00 +01:00
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
</variablelist>
|
|
|
|
</refsect1>
|
|
|
|
|
2017-06-01 04:35:33 +02:00
|
|
|
<refsect1>
|
|
|
|
<title>Notes</title>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
When dropping a subscription that is associated with a replication slot on
|
|
|
|
the remote host (the normal state), <command>DROP SUBSCRIPTION</command>
|
|
|
|
will connect to the remote host and try to drop the replication slot as
|
|
|
|
part of its operation. This is necessary so that the resources allocated
|
|
|
|
for the subscription on the remote host are released. If this fails,
|
|
|
|
either because the remote host is not reachable or because the remote
|
|
|
|
replication slot cannot be dropped or does not exist or never existed,
|
|
|
|
the <command>DROP SUBSCRIPTION</command> command will fail. To proceed in
|
|
|
|
this situation, disassociate the subscription from the replication slot by
|
|
|
|
executing <literal>ALTER SUBSCRIPTION ... SET (slot_name = NONE)</literal>.
|
|
|
|
After that, <command>DROP SUBSCRIPTION</command> will no longer attempt any
|
|
|
|
actions on a remote host. Note that if the remote replication slot still
|
|
|
|
exists, it should then be dropped manually; otherwise it will continue to
|
|
|
|
reserve WAL and might eventually cause the disk to fill up. See
|
|
|
|
also <xref linkend="logical-replication-subscription-slot">.
|
|
|
|
</para>
|
2017-09-22 21:01:13 +02:00
|
|
|
|
|
|
|
<para>
|
|
|
|
If a subscription is associated with a replication slot, then <command>DROP
|
|
|
|
SUBSCRIPTION</command> cannot be executed inside a transaction block.
|
|
|
|
</para>
|
2017-06-01 04:35:33 +02:00
|
|
|
</refsect1>
|
|
|
|
|
2017-01-19 18:00:00 +01:00
|
|
|
<refsect1>
|
|
|
|
<title>Examples</title>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
Drop a subscription:
|
|
|
|
<programlisting>
|
|
|
|
DROP SUBSCRIPTION mysub;
|
2017-06-14 19:55:43 +02:00
|
|
|
</programlisting></para>
|
2017-01-19 18:00:00 +01:00
|
|
|
</refsect1>
|
|
|
|
|
|
|
|
<refsect1>
|
|
|
|
<title>Compatibility</title>
|
|
|
|
|
|
|
|
<para>
|
2017-10-09 03:44:17 +02:00
|
|
|
<command>DROP SUBSCRIPTION</command> is a <productname>PostgreSQL</productname>
|
2017-01-19 18:00:00 +01:00
|
|
|
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>
|