UNLISTEN

UNLISTEN — deja de escuchar una notificación

Synopsis

UNLISTEN { channel | * }

Descripción

UNLISTEN se utiliza para eliminar un registro existente para eventos de NOTIFY. UNLISTEN cancela cualquier registro existente de la sesión actual de PostgreSQL como oyente («listener») en el canal de notificación llamado channel. El comodín especial * cancela todos los registros de oyentes para la sesión actual.

La NOTIFY contiene una discusión más detallada sobre el uso de LISTEN y NOTIFY.

Parámetros

channel

Nombre de un canal de notificación (cualquier identificador).

*

Se borran todos los registros de escucha actuales para esta sesión.

Notas

Puedes dejar de escuchar algo que no estabas escuchando; no aparecerá ninguna advertencia ni error.

Al final de cada sesión, se ejecuta automáticamente UNLISTEN *.

Una transacción que ha ejecutado UNLISTEN no se puede preparar para confirmación en dos fases («two-phase commit»).

Ejemplos

Para hacer un registro:

LISTEN virtual;
NOTIFY virtual;
Asynchronous notification "virtual" received from server process with PID 8448.

Una vez que se ha ejecutado UNLISTEN, se ignorarán los siguientes mensajes de NOTIFY:

UNLISTEN virtual;
NOTIFY virtual;
-- no se recibe ningún evento NOTIFY

Compatibilidad

No existe el comando UNLISTEN en el estándar SQL.

Véase también

LISTEN, NOTIFY