UNLISTEN#

UNLISTEN

UNLISTEN

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

Синтаксис

UNLISTEN { channel | * }

Описание

UNLISTEN используется для удаления существующей регистрации на события NOTIFY. UNLISTEN отменяет любую существующую регистрацию текущей сессии Tantor SE в качестве слушателя на канале уведомлений с именем channel. Специальный символ-маска * отменяет все регистрации слушателей для текущей сессии.

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

Параметры

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