DROP SUBSCRIPTION
移除一个订阅
英文手册覆盖始于 PostgreSQL 6.4. 来源历史与运行验证各自保留独立版本边界。
当前阅读 PG 18·选择有来源记录的版本
- anchor
- SQL-DROPSUBSCRIPTION
- file
- sql-dropsubscription.html
- lang
- en
- name
- DROP SUBSCRIPTION
- purpose
- remove a subscription
- purpose zh
- 未知
- sections same as
- 未知
- slug
- 18
- synopsis html
- DROP SUBSCRIPTION [ IF EXISTS ] <em class="replaceable"><code>name</code></em> [ CASCADE | RESTRICT ]
- synopsis text
- DROP SUBSCRIPTION [ IF EXISTS ] name [ CASCADE | RESTRICT ]
语法
DROP SUBSCRIPTION [ IF EXISTS ] name [ CASCADE | RESTRICT ]语法图
从左向右阅读；分支表示选择，旁路表示可选，循环表示重复。点击带下划线的参数可打开对应规则。
版本定义 PG 18
DROP SUBSCRIPTION [ IF EXISTS ] name [ CASCADE | RESTRICT ]
描述
DROP SUBSCRIPTION从数据库集簇中移除一个订阅。
要执行此命令，用户必须是该订阅的拥有者。
如果该订阅与复制槽相关联，则不能在事务块内执行 DROP SUBSCRIPTION。（可以使用ALTER SUBSCRIPTION 来取消设置该槽。）
参数
IF EXISTS如果订阅不存在，不要抛出错误。在这种情况下会发出一个提示。
name要移除的订阅名称。
CASCADERESTRICT这些关键字没有任何效果，因为订阅上不存在依赖关系。
注解
删除一个与远端主机上的复制槽相关联的订阅时（这通常是正常状态），DROP SUBSCRIPTION会连接到远端主机，并在执行过程中尝试删除该复制槽（以及任何剩余的表同步槽）。这样做是必要的，以便释放远端主机上为该订阅分配的资源。如果此操作失败，无论是因为远端主机不可达，还是因为远端复制槽无法删除、不存在或者从未存在，DROP SUBSCRIPTION命令都会失败。要在这种情况下继续，首先执行 ALTER SUBSCRIPTION ... DISABLE 禁用订阅，然后执行 ALTER SUBSCRIPTION ... SET (slot_name = NONE) 将其与复制槽解除关联。此后，DROP SUBSCRIPTION将不会尝试删除订阅自身的复制槽。如果还有某些表同步尚未完成，它仍可能连接到发布者，以删除由系统内部创建的表同步槽；如果发布者不可达，则必须手工删除这些槽（以及仍然存在的主复制槽）。否则，这些槽会继续保留 WAL，并最终可能导致磁盘被占满。另见第 29.2.1 节。
如果订阅与复制槽相关联，则不能在事务块内执行 DROP SUBSCRIPTION。
示例
删除一个订阅：
DROP SUBSCRIPTION mysub;
兼容性
DROP SUBSCRIPTION是PostgreSQL扩展。
另见
CREATE SUBSCRIPTION, ALTER SUBSCRIPTION比较版本
来源引用
定义来源
center · PostgreSQL 18 · a709ab85
正文语言: zh-Hans · 1b5ca64c