Русский

UNLISTEN

Прекращает прослушивание уведомления.

Синтаксис

UNLISTEN { <channel> | * }

Описание

UNLISTEN используется для удаления существующей регистрации на события NOTIFY. UNLISTEN отменяет любую текущую регистрацию сеанса базы данных в качестве слушателя канала уведомлений с именем channel. Специальный подстановочный символ * отменяет все регистрации слушателей для текущего сеанса.

NOTIFY содержит более подробное описание использования LISTEN и NOTIFY.

Параметры

channel
- Имя канала уведомлений (любой идентификатор).
*
- Все текущие регистрации прослушивания для этого сеанса будут очищены.
  Замечания
  
  Вы можете выполнить UNLISTEN для канала, за которым вы не следили; предупреждение или ошибка при этом не возникнут.

В конце каждого сеанса автоматически выполняется 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

Совместимость

Оператор UNLISTEN отсутствует в стандарте SQL.

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

Русский English 简体中文