| Documentation PostgreSQL 7.4.29 | ||||
|---|---|---|---|---|
| Précédent | Arrière rapide | Avance rapide | Suivant | |
pg_listen crée, modifie ou annule les requêtes d'écoute
de messages asynchrones de notification à partir du serveur
PostgreSQL. Avec un paramètre
commande, la requête est établie, ou la chaîne d'une requête
déjà existante est remplacée. Sans paramètre callbackCommand,
une précédente requête est annulée.
Après qu'une requête pg_listen soit établie, la
chaîne de commande spécifiée est exécutée à chaque fois qu'un message de
notification portant le même nom arrive du serveur. Ceci arrive lorsqu'un
application client PostgreSQL lance une commande
NOTIFY référençant ce nom. La chaîne de la commande
est exécutée à partir de la boucle d'attente Tcl. C'est l'état normal d'une
application écrite en Tk. Avec les shells Tcl non-Tk, vous pouvez exécuter
update ou vwait pour entrer dans la
boucle d'attente.
Il n'est pas recommandé d'appeler les instructions SQL
LISTEN
ou UNLISTEN directement en utilisant
pg_listen. pgtcl prend en
charge l'appel de ces instructions pour vous. Mais si vous voulez envoyer un
message de notification vous-même, appelez l'instruction SQL
NOTIFY en utilisant pg_exec.
La poignée de la connexion sur laquelle écouter les notifications.
Le nom de la notification pour laquelle vous voulez commencer ou arrêter l'écoute.
Si présent, fournit la chaîne de commande à exécuter lorsqu'une notification correspondante arrive.
| Précédent | Sommaire | Suivant |
| pg_execute | Niveau supérieur | pg_on_connection_loss |