PostgreSQLLa base de données la plus sophistiquée au monde.

Version anglaise

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 38, 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 lui-même
objsubid integer Sous-identifiant de l'objet (exemple le numéro d'attribut pour une colonne)
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. Chaque identifiant présent dans l'identité est placé entre guillemets si nécessaire.
in_extension bool True 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 lui-même
objsubid int32 Identifiant du sous-objet (par exemple, numéro d'attribut pour une colonne)
original bool True si c'était un des objets racines de la suppression
normal bool True s'il existe une relation de dépendance normale dans le graphe des dépendances menant à cet objet
is_temporary bool True si 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. Chaque identifiant présent dans l'identité est placé 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.

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.88, « 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.88. 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();