DROP SUBSCRIPTION
DROP SUBSCRIPTION — 移除一个订阅
大纲
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,并最终可能导致磁盘被占满。另见第 31.2.1 节。
如果订阅与复制槽相关联,则不能在事务块内执行
DROP SUBSCRIPTION。
示例
删除一个订阅:
DROP SUBSCRIPTION mysub;
兼容性
DROP SUBSCRIPTION 是 PostgreSQL 扩展。
报告文档问题
阅读 上游文档. 通过 PostgreSQL 文档反馈表单.