UNLISTEN
UNLISTEN — перестать перехватывать уведомления
Синтаксис
UNLISTEN { канал | * }
Описание
Команда UNLISTEN используется для удаления существующей подписки на события
NOTIFY. UNLISTEN отменяет любую существующую подписку текущего сеанса
QHB на канал уведомлений с именем канал. Специальный
знак * отменяет все подписки текущего сеанса.
Более подробно использование команд LISTEN и NOTIFY рассматривается на
справочной странице команды NOTIFY.
Параметры
канал
Имя канала уведомления (любой идентификатор).
*
Все текущие подписки на уведомления для этого сеанса стираются.
Примечания
Можно перестать перехватывать уведомления с канала, на который нет подписки; при этом не появится никакого предупреждения или ошибки.
В конце каждого сеанса UNLISTEN * выполняется автоматически.
Транзакцию, которая выполняла UNLISTEN, нельзя подготовить к двухфазной фиксации.
Примеры
Подписка на получение события:
LISTEN virtual;
NOTIFY virtual;
Asynchronous notification "virtual" received from server process with PID 8448.
-- От серверного процесса с PID 8448 получено асинхронное уведомление "virtual".
После того как была выполнена команда UNLISTEN, дальнейшие сообщения NOTIFY
будут игнорироваться:
UNLISTEN virtual;
NOTIFY virtual;
-- события NOTIFY не приходят
Совместимость
В стандарте SQL нет команды UNLISTEN.