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.
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. |
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 :
Fonctions trigger
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();
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();