UNLISTEN

Name

UNLISTEN  --  pára de escutar uma notificação

Synopsis

UNLISTEN { nome_notificação | * }
  

Entradas

nome_notificação

O nome de uma condição de notificação registrada previamente.

*

Todos os registros de escuta atuais deste processo servidor são removidos.

Saídas

UNLISTEN

Constata que o comando foi executado.

Descrição

O comando UNLISTEN é utilizado para remover um registro de NOTIFY existente. UNLISTEN cancela qualquer registro existente da sessão corrente do PostgreSQL para escutar a condição de notificação nome_notificação. A condição especial * (curinga) cancela todos os registros de escuta da sessão corrente.

O comando NOTIFY contém uma discussão mais extensa da utilização do comando LISTEN e do comando NOTIFY.

Notas

O nome_notificação não necessita ser um nome de classe válido, podendo ser qualquer cadeia de caracteres válida como um nome, com até 32 caracteres.

O servidor não reclama quando é executado o UNLISTEN para algo que não esteja sendo escutado. Cada processo servidor executa automaticamente o comando UNLISTEN * ao encerrar sua execução.

Utilização

Para participar de um registro existente:

LISTEN virtual;
LISTEN
NOTIFY virtual;
NOTIFY
Asynchronous NOTIFY 'virtual' from backend with pid '8448' received

Quando UNLISTEN é executado, os comandos NOTIFY posteriores são ignorados:

UNLISTEN virtual;
UNLISTEN
NOTIFY virtual;
NOTIFY
-- notice no NOTIFY event is received

Compatibilidade

SQL92

Não existe o comando UNLISTEN no SQL92.