UNLISTEN

本文介绍了UNLISTEN的语法、参数以及示例等内容。

简介

UNLISTEN被用来移除一个已经存在的对 NOTIFY事件的注册。 UNLISTEN取消任何已经存在的把当前 PolarDB会话作为名为 channel的通知频道的监听者的注册。特殊的通配符取消当前会话的所有监听者注册。

NOTIFY 包含有关LISTENNOTIFY使用的更深入讨论。

语法

    UNLISTEN { channel | * }

参数说明

channel一个通知频道的名称(任何标识符)。

说明

所有用于这个会话的当前监听注册都会被清除。

说明

您可以unlisten您没有监听的东西,不会出现警告或者错误。

在每一个会话末尾,会自动执行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