UNLISTEN
Прекращает прослушивание уведомлений.
Синтаксис
UNLISTEN { <channel> | * }Описание
UNLISTEN используется для отмены существующей регистрации на получение событий NOTIFY. UNLISTEN отменяет любую существующую регистрацию в текущей сессии Greengage DB на канал уведомлений с именем channel. Специальный символ подстановки * отменяет все регистрации в текущей сессии.
В описании NOTIFY использование команд 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;
-- событие NOTIFY не поступаетСовместимость
Команда UNLISTEN отсутствует в стандарте SQL.