LISTEN

Nom

LISTEN -- �coute une notification

Synopsis

LISTEN nom

Description

LISTEN enregistre la session courante comme en attente d'une condition de notification nom. Si la session courante est d�j� enregistr�e comme en �coute de cette condition de notification condition, rien n'est fait.

Quand la commande NOTIFY nom est appel�e, soit par cette session soit par une autre connect�e � la m�me base de donn�es, toutes les sessions en cours d'�coute de cette condition de notification sont notifi�es et chacune pourra notifier en retour son application cliente connect�e. Voir la discussion de NOTIFY pour plus d'informations.

Une session peut �tre effac�e pour une condition de notification donn�e avec la commande UNLISTEN. Les enregistrements d'�coute d'une session sont automatiquement effac�s lorsque la session se termine.

La m�thode qu'une application client doit utiliser pour d�tecter des �v�nements de notification d�pend de l'interface de programmation PostgreSQL qu'elle utilise. Avec la biblioth�que libpq, l'application ex�cute LISTEN comme une commande SQL ordinaire, puis doit appeler p�riodiquement la fonction PQnotifies pour savoir quels �v�nements de notification ont �t� re�us. Les autres interfaces, comme libpgtcl, fournissent des m�thodes de plus haut niveau pour g�rer les �v�nements de notification ; en fait, avec libpgtcl, le d�veloppeur de l'application ne devrait m�me pas lancer LISTEN ou UNLISTEN directement. Voir la documentation de l'interface que vous utilisez pour plus de d�tails.

NOTIFY contient une discussion plus d�taill�e sur l'utilisation de LISTEN et NOTIFY.

Param�tres

nom

Nom d'une condition de notification (tout identifiant).

Exemples

Configure et ex�cute une s�quence listen/notify � partir de psql :

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

Compatibilit�

Il n'existe pas d'instruction LISTEN dans le standard SQL.

Voir aussi

NOTIFY, UNLISTEN