Autres fonctions de gestion des groupes de tables
Réinitialiser les tables de log d’un groupe
En standard, et sauf indication contraire, les tables de log sont vidées lors du démarrage du groupe de tables auquel elles appartiennent. En cas de besoin, il est néanmoins possible de réinitialiser ces tables de log avec la commande SQL suivante
SELECT emaj.emaj_reset_group('<nom.du.groupe>');
La fonction retourne le nombre de tables et de séquences contenues dans le groupe.
Pour réinitialiser les tables de log d’un groupe, ce dernier doit bien sûr être à l’état inactif (« IDLE »).
Commenter un groupe de tables
Il est possible de positionner un commentaire sur un groupe quelconque lors de sa création. Mais on peut le faire également plus tard avec :
SELECT emaj.emaj_comment_group('<nom.du.groupe>', '<commentaire>');
La fonction ne retourne aucune donnée.
Pour modifier un commentaire, il suffit d’exécuter à nouveau la fonction pour le même groupe de tables, avec le nouveau commentaire.
Pour supprimer un commentaire, il suffit d’exécuter la fonction avec une valeur NULL pour le paramètre commentaire.
Les commentaires sont surtout intéressants avec l’utilisation d’Emaj_web, qui les affiche systématiquement dans les tableaux des groupes. Mais on peut également les retrouver dans la colonne group_comment de la table emaj.emaj_group.
Protéger un groupe de tables contre les rollbacks
Il peut être utile à certains moments de se protéger contre des rollbacks intempestifs de groupes de tables, en particulier sur des bases de données de production. Deux fonctions répondent à ce besoin.
La fonction emaj_protect_group() pose une protection sur un groupe de tables.
SELECT emaj.emaj_protect_group('<nom.du.groupe>');
La fonction retourne l’entier 1 si le groupe de tables n’était pas déjà protégé, ou 0 s’il était déjà protégé.
Une fois le groupe de tables protégé, toute tentative de rollback, tracé ou non, sera refusée.
Un groupe de tables de type « audit-seul » ou dans un état « inactif » ne peut être protégé.
Au démarrage d’un groupe de tables, ce dernier n’est pas protégé. Lorsqu’il est arrêté, un groupe de tables protégé contre les rollbacks perd automatiquement sa protection.
La fonction emaj_unprotect_group() ôte une protection existante sur un groupe de tables.
SELECT emaj.emaj_unprotect_group('<nom.du.groupe>');
La fonction retourne l’entier 1 si le groupe de table était protégé au préalable, ou 0 s’il n’était pas déjà protégé.
Un groupe de tables de type « audit-seul » ne peut être déprotégé.
Une fois la protection d’un groupe de tables ôtée, il devient à nouveau possible d’effectuer tous types de rollback sur le groupe.
Un mécanisme de protection au niveau des marques complète ce dispositif.
Arrêt forcé d’un groupe de tables
Il peut arriver qu’un groupe de tables endommagé ne puisse pas être arrêté. C’est par exemple le cas si une table applicative du groupe de tables a été supprimée par inadvertance alors que ce dernier était actif. Si les fonctions usuelles emaj_stop_group() ou emaj_stop_groups() retournent une erreur, il est possible de forcer l’arrêt d’une groupe de tables à l’aide de la fonction emaj_force_stop_group().
SELECT emaj.emaj_force_stop_group('<nom.du.groupe>');
La fonction retourne le nombre de tables et de séquences contenues dans le groupe.
Cette fonction emaj_force_stop_group() effectue le même traitement que la fonction emaj_stop_group(), Elle présente néanmoins les différences suivantes :
elle gère les éventuelles absences des tables et triggers E-Maj à désactiver, des messages de type « Warning » étant générés dans ces cas,
elle ne pose PAS de marque d’arrêt,
le groupe de tables doit nécessairement être actif quand la fonction est appelée,
les logs et marques sont toujours laissés en l’état.
Une fois la fonction exécutée, le groupe de tables est en état « IDLE ». Il peut alors être supprimé avec la fonction emaj_drop_group().
Il est recommandé de n’utiliser cette fonction qu’en cas de réel besoin.
Suppression forcée d’un groupe de tables
Il peut arriver qu’un groupe de tables endommagé ne puisse pas être arrêté. Mais n’étant pas arrêté, il est impossible de le supprimer. Pour néanmoins pouvoir supprimer un groupe de tables en état actif, une fonction spéciale est disponible.
SELECT emaj.emaj_force_drop_group('<nom.du.groupe>');
La fonction retourne le nombre de tables et de séquences contenues dans le groupe.
Cette fonction emaj_force_drop_group() effectue le même traitement que la fonction emaj_drop_group(), mais sans contrôler l’état du groupe au préalable. Il est recommandé de n’utiliser cette fonction qu’en cas de réel besoin.
Note
Depuis la création de la fonction emaj_force_stop_group(), cette fonction emaj_force_drop_group() devient en principe inutile. Elle est susceptible de disparaître dans une future version d’E-Maj.
Connaitre l’existence ou l’état d’un groupe de tables ou d’une marque
L’administrateur E-Maj souhaitant écrire des scripts SQL idempotents pour administrer ses groupes de tables dispose de quelques fonctions utiles : emaj_does_exist_group(), emaj_is_logging_group() et emaj_does_exist_mark_group().
SELECT emaj.emaj_does_exist_group('<nom.du.groupe>');
SELECT emaj.emaj_is_logging_group('<nom.du.groupe>');
SELECT emaj.emaj_does_exist_mark_group('<nom.du.groupe>', ‘<nom.de.marque>’);
Toutes retournent un booléen qui prend la valeur TRUE lorsque respectivement :
un groupe de tables donné existe,
un groupe de tables existe et est actif,
une marque donnée existe.
En utilisant ces fonctions dans une clause WHERE, on peut, par exemple, ne créer le groupe de tables que s’il n’existe pas déjà.
SELECT emaj.emaj_create_group('<nom.du.groupe>')
WHERE NOT emaj.emaj_does_exist_group('<nom.du.groupe>');
Effacer les traces de suppression d’un groupe de tables
Lorsqu’un groupe de tables est supprimé, des données sur sa vie antérieure (créations, suppressions, démarrages et arrêts) sont conservées dans deux tables d’historiques, avec une même rétention que les autres données historiques. Mais en cas de suppression d’un groupe de tables qui a été créé par erreur, il peut s’avérer utile d’effacer immédiatement ces traces, afin de ne pas polluer ces historiques. Pour ce faire, une fonction spéciale est disponible :
SELECT emaj.emaj_forget_group('<nom.du.groupe>');
Le groupe de tables ne doit plus exister.
La fonction retourne le nombre de traces supprimées.