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
.