UNLISTEN

Nome

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

Sinopse

UNLISTEN { nome | * }

Descrição

O comando UNLISTEN é utilizado para remover um registro para eventos de NOTIFY existente. O comando UNLISTEN cancela o registro existente da sessão corrente do PostgreSQL como ouvinte da notificação nome. O caractere curinga especial * cancela todos os registros de ouvinte da sessão corrente.

O comando NOTIFY contém uma explicação mais extensa sobre a utilização dos comandos LISTEN e NOTIFY.

Parâmetros

nome

O nome da notificação (qualquer identificador).

*

Todos os registros de ouvinte para esta sessão são limpos.

Observações

É possível deixar de ouvir algo que não estava sendo ouvido; não é mostrado nenhum erro ou advertência.

Ao final de cada sessão, o comando UNLISTEN * é executado automaticamente.

Exemplos

Para registrar:

LISTEN virtual;
NOTIFY virtual;
Notificação assíncrona "virtual" recebida do processo servidor com PID 19296.

Após o comando UNLISTEN ter sido executado, os comandos NOTIFY posteriores serão ignorados:

UNLISTEN virtual;
NOTIFY virtual;
-- não é recebido nenhum evento NOTIFY

Compatibilidade

Não existe o comando UNLISTEN no padrão SQL.

Consulte também

LISTEN, NOTIFY
SourceForge.net Logo CSS válido!