UNLISTEN

Nome

UNLISTEN -- pára de escutar 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 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).
*
Cancela todos os registros de ouvinte desta sessão.

Observações

É possível deixar de escutar algo que não estava sendo escutado; 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;
Asynchronous notification "virtual" received from server process with PID 8448.

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

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

Compatibilidade

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

Veja também

LISTEN , NOTIFY
SourceForge.net Logo