历史版本。 PostgreSQL 8.1 已结束支持。 请参阅 当前版本手册.
UNLISTEN
UNLISTEN — 停止监听通知
大纲
UNLISTEN { name | * }描述
UNLISTEN用于移除现有的
NOTIFY事件注册。UNLISTEN会取消当前
PostgreSQL会话作为名为name的通知的任何现有监听注册。特殊通配符*会取消当前会话的所有监听注册。
NOTIFY中对LISTEN和
NOTIFY的使用有更详细的讨论。
参数
name通知的名称(任意标识符)。
*该会话当前的所有监听注册都会被清除。
注解
可以取消监听自己并未监听的通道,不会出现警告或错误。
每个会话结束时,都会自动执行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语句。