UNLISTEN
Эта страница переведена при помощи нейросети GigaChat.
UNLISTEN
- прекращение получения уведомления.
Синтаксис
UNLISTEN { channel | * }
Описание
UNLISTEN
используется для отмены существующей подписки на получение событий NOTIFY
. UNLISTEN
отменяет любую существующую подписку в текущем сеансе PostgreSQL в качестве слушателя на канале уведомлений с именем 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;
-- no NOTIFY event is received
Совместимость
В стандарте SQL нет команды UNLISTEN
.