Перейти к основному содержимому

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.

Смотрите также

LISTEN, NOTIFY