UNLISTEN

UNLISTEN — deixa de aguardar por uma notificação

Sinopse

UNLISTEN { canal | * }

Descrição

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

O comando NOTIFY contém uma discussão mais detalhada sobre o uso dos comandos LISTEN e NOTIFY. NOTIFY.

Parâmetros

canal

O nome do canal de notificação (qualquer identificador).

*

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

Notas

Pode-se deixar de ouvir algo que não estava sendo ouvido; nenhum aviso ou erro será relatado.

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

Uma transação que executa o comando UNLISTEN não pode ser preparada para efetivação de duas fases.

Exemplos

Para registrar:

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

Assim que o comando UNLISTEN for executado, as demais mensagens do comando NOTIFY serão ignoradas:

UNLISTEN virtual;
NOTIFY virtual;
-- não será mais recebido nenhum evento NOTIFY

Conformidade

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

Veja também

LISTEN, NOTIFY