UNLISTEN

UNLISTEN — перестать перехватывать уведомления


Синтаксис

UNLISTEN { канал | * }

Описание

Команда UNLISTEN используется для удаления существующей подписки на события NOTIFY. UNLISTEN отменяет любую существующую подписку текущего сеанса QHB на канал уведомлений с именем канал. Специальный знак * отменяет все подписки текущего сеанса.

Справочная страница команды NOTIFY содержит более подробное описание команд LISTEN и NOTIFY.


Параметры

канал

Имя канала уведомления (любой идентификатор).

*

Все текущие подписки на уведомления для этого сеанса отменяются.


Примечания

Вы можете перестать перехватывать уведомления с канала, на который не подписаны; при этом не появится никакого предупреждения или ошибки.

В конце каждого сеанса UNLISTEN * выполняется автоматически.

Транзакцию, которая выполняла UNLISTEN, нельзя подготовить к двухфазной фиксации.


Примеры

Подписка на получение события:

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

После того, как UNLISTEN была выполнена, дальнейшие сообщения NOTIFY будут игнорироваться:

UNLISTEN virtual;
NOTIFY virtual;
-- события NOTIFY не приходят

Совместимость

В стандарте SQL нет команды UNLISTEN.


См. также

LISTEN, NOTIFY