38.6. Proc�dures pour d�clencheurs en PL/Tcl

Les proc�dures pour d�clencheurs peuvent �tre �crites en PL/Tcl. PostgreSQL requiert qu'une proc�dure, devant �tre appel�e en tant que d�clencheur, doit �tre d�clar�e comme une fonction sans arguments et retourner une valeur de type trigger.

L'information du gestionnaire de d�clencheur est pass�e au corps de la proc�dure avec les variables suivantes :

Le code de retour d'une proc�dure d�clencheur peut �tre faite avec une des cha�nes OK ou SKIP ou une liste renvoy�e par la commande Tcl array get. Si la valeur de retour est OK, l'op�ration (INSERT/UPDATE/DELETE) qui a lanc� le d�clencheur continuera normalement. SKIP indique au gestionnaire de d�clencheurs de supprimer silencieusement l'op�ration pour cette ligne. Si une liste est renvoy�e, elle indique � PL/Tcl de renvoyer la ligne modifi�e au gestionnaire de d�clencheurs qui l'ins�rera au lieu de celle donn�es par $NEW (ceci fonctionne seulement pour INSERT et UPDATE). Inutile de dire que tout ceci est vraiment significatif lorsque le d�clencheur est BEFORE et FOR EACH ROW ; sinon le code de retour est ignor�.

Voici un petit exemple de proc�dure d�clencheur qui force une valeur enti�re dans une table pour garder trace du nombre de mises � jour r�alis�es sur la ligne. Pour les nouvelles lignes ins�r�es, la valeur est initialis�e � 0 puis incr�ment�e � chaque op�ration de mise � jour.

CREATE FUNCTION trigfunc_modcount() RETURNS trigger AS '
    switch $TG_op {
        INSERT {
            set NEW($1) 0
        }
        UPDATE {
            set NEW($1) $OLD($1)
            incr NEW($1)
        }
        default {
            return OK
        }
    }
    return [array get NEW]
' LANGUAGE pltcl;

CREATE TABLE mytab (num integer, description text, modcnt integer);

CREATE TRIGGER trig_mytab_modcount BEFORE INSERT OR UPDATE ON mytab
    FOR EACH ROW EXECUTE PROCEDURE trigfunc_modcount('modcnt');

Notez que la proc�dure d�clencheur elle-m�me ne conna�t pas le nom de la colonne ; c'est fourni avec les arguments du d�clencheur. Ceci permet � la proc�dure d�clencheur d'�tre r�-utilis�e avec diff�rentes tables.