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
.