选择 打开 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
测试与开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0
历史版本PostgreSQL 9.2 已于 2017 年 11 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本

UNLISTEN

UNLISTEN — 停止监听通知

大纲

UNLISTEN { channel | * }

描述

UNLISTEN用于移除现有的 NOTIFY事件注册。 UNLISTEN会取消当前 PostgreSQL会话作为名为channel的通知通道监听者的任何现有注册。 特殊通配符*会取消当前会话的所有监听注册。

NOTIFY中对LISTENNOTIFY的使用有更详细的讨论。

参数

channel

通知通道的名称(任意标识符)。

*

该会话当前的所有监听注册都会被清除。

注解

可以取消监听自己并未监听的通道,不会出现警告或错误。

每个会话结束时,都会自动执行UNLISTEN *

执行过UNLISTEN的事务不能为两阶段提交做准备。

示例

建立一个监听注册:

LISTEN virtual;
NOTIFY virtual;
Asynchronous notification "virtual" received from server process with PID 8448.

执行UNLISTEN之后,后续的NOTIFY 消息将被忽略:

UNLISTEN virtual;
NOTIFY virtual;
-- no NOTIFY event is received

兼容性

SQL 标准中没有UNLISTEN语句。

另见

LISTEN, NOTIFY

提交更正

译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。