IdentifiantMot de passe
Loading...
Mot de passe oublié ?Je m'inscris ! (gratuit)

UNLISTEN

UNLISTEN — arrête l'écoute d'une notification

Synopsis

UNLISTEN { canal | * }

Description

UNLISTEN est utilisé pour supprimer un abonnement aux événements NOTIFY. UNLISTEN annule tout abonnement pour la session PostgreSQL™ en cours sur le canal de notification nommé canal. Le caractère générique * annule tous les abonnements de la session en cours.

NOTIFY(7) contient une discussion plus complète de l'utilisation de LISTEN et de NOTIFY.

Paramètres

canal

Le nom d'un canal de notification (un identificateur quelconque).

*

Tous les abonnements de cette session sont annulés.

Notes

Il est possible de se désabonner de quelque chose pour lequel il n'y a pas d'abonnement ; aucun message d'avertissement ou d'erreur n'est alors retourné.

À la fin de chaque session, UNLISTEN * est exécuté automatiquement.

Une transaction qui a exécuté UNLISTEN ne peut pas être préparée pour une validation en deux phases.

Exemples

Pour s'abonner :

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

Une fois que UNLISTEN a été exécuté, les messages NOTIFY suivants sont ignorés :

UNLISTEN virtual;
NOTIFY virtual;
-- aucun événement NOTIFY n'est reçu

Compatibilité

Il n'y a pas de commande UNLISTEN dans le standard SQL.

Voir aussi

LISTEN(7), NOTIFY(7)