9.28. Fonctions des triggers sur les événements

PostgreSQL™ fournit ces fonctions utilitaires pour retrouver des informations à partir des triggers sur événements.

Pour plus d'informations sur les triggers sur événements, voir Chapitre 37, Déclencheurs (triggers) sur évènement.

9.28.1. Récupérer les modifications à la fin de la commande

pg_event_trigger_ddl_commands renvoie une liste des commandes DDL exécutées par chaque action de l'utilisateur lorsqu'elle est appelée à partir d'une fonction attachée à un trigger sur événement ddl_command_end. Si elle est appelée dans tout autre contexte, une erreur est levée. pg_event_trigger_ddl_commands renvoie une ligne pour chaque commande de base exécutée ; certaines commandes qui sont une simple instruction SQL peuvent retourner plus d'une ligne. Cette fonction renvoie les colonnes suivantes :

Nom Type Description
classid Oid OID du catalogue auquel appartient l'objet
objid Oid OID de l'objet dans le catalogue
objsubid integer Sous-identifiant de l'objet (exemple le numéro d'attribut pour les colonnes)
command_tag text La marque (tag) de la commande
object_type text Type de l'objet
schema_name text Nom du schéma auquel appartient l'objet, si applicable ; sinon NULL. Aucun guillemet n'est utilisé.
object_identity text Version textuelle de l'identité de l'objet, qualifié du schéma. Tous les identifiants présent dans l'identité sont placés entre guillemets si nécessaire.
in_extension bool Indique si la commande est incluse dans un script d'une extension
command pg_ddl_command Une représentation complète de la commande, dans un format interne. Elle ne peut être envoyée en sortie directement, mais elle peut être communiquée à d'autres fonctions pour obtenir différentes informations à propos de la commande.

9.28.2. Traitement des objets supprimés par une commande DDL

pg_event_trigger_dropped_objects renvoie une liste de tous les objets supprimés par la commande qui a déclenché l'appel à l'événement sql_drop. Si elle est appelée dans un autre contexte, pg_event_trigger_dropped_objects lève une erreur. pg_event_trigger_dropped_objects renvoie les colonnes suivantes :

Nom Type Description
classid Oid OID du catalogue auquel appartient l'objet
objid Oid OID de l'objet dans le catalogue
objsubid int32 Sous-identifiant de l'objet (par exemple, numéro d'attribut pour les colonnes)
original bool Utilisé pour identifier l'objet détruit à l'origine
normal bool Indique qu'il existe une relation de dépendance normale dans le graphe des dépendances menant à cet objet
is_temporary bool Indique que l'objet était un objet temporaire.
object_type text Type de l'objet
schema_name text Nom du schéma auquel appartient l'objet. NULL dans le cas contraire. Aucun guillemet n'est utilisé.
object_name text Nom de l'objet si la combinaison nom du schéma et nom de l'objet peut être utilisée comme identifiant unique pour l'objet, NULL dans les autres cas. Aucun guillemet n'est utilisé et le nom n'est jamais qualifié du nom du schéma.
object_identity text Version textuelle de l'identité de l'objet, qualifié du schéma. Tous les identifiants présents dans l'identité sont placés entre guillemets si nécessaire.
address_names text[] Un tableau qui, avec object_type et address_args, peut être utilisé par la fonction pg_get_object_address() pour recréer l'adresse de l'objet dans un serveur distant qui contient un objet de même type nommé à l'identique.
address_args text[] Complément pour address_names ci-dessus.

La fonction pg_event_trigger_dropped_objects peut être utilisée dans un trigger d'événement comme ici :

CREATE FUNCTION test_trigger_evenement_pour_suppression()
        RETURNS event_trigger LANGUAGE plpgsql AS $$
DECLARE
    obj record;
BEGIN
    FOR obj IN SELECT * FROM pg_event_trigger_dropped_objects()
    LOOP
        RAISE NOTICE '% objet supprimé : % %.% %',
                     tg_tag,
                     obj.object_type,
                     obj.schema_name,
                     obj.object_name,
                     obj.object_identity;
    END LOOP;
END
$$;
CREATE EVENT TRIGGER test_trigger_evenement_pour_suppression
   ON sql_drop
   EXECUTE PROCEDURE test_trigger_evenement_pour_suppression();
           

9.28.3. Gérer un événement de modification de table

Les fonctions décrites à Tableau 9.78, « Table Rewrite information » fournissent des informations sur une table pour laquelle un événement table_rewrite vient juste d'être lancé. Si elles sont appellées dans un autre contexte, une erreur est levée.

Tableau 9.78. Table Rewrite information

Nom Type en retour Description
pg_event_trigger_table_rewrite_oid() Oid L'OID de la table sur le point d'être modifiée.
pg_event_trigger_table_rewrite_reason() int Le(s) code(s) expliquant la raison de la modification. La signification exacte de ces codes dépend de la version (release).

La fonction pg_event_trigger_table_rewrite_oid peut être utilisée dans un trigger sur événement comme suit :

CREATE FUNCTION test_event_trigger_table_rewrite_oid()
 RETURNS event_trigger
 LANGUAGE plpgsql AS
$$
BEGIN
  RAISE NOTICE 'modification de table % pour la raison %',
                pg_event_trigger_table_rewrite_oid()::regclass,
                pg_event_trigger_table_rewrite_reason();
END;
$$;

CREATE EVENT TRIGGER test_table_rewrite_oid
                  ON table_rewrite
   EXECUTE PROCEDURE test_event_trigger_table_rewrite_oid();