Valide l'intégrité d'un référentiel de schémas et d'une base de données utilisateur en fonction des règles ou groupes de règles indiqués.
Syntaxe
Remarque : Cette
commande ne peut être exécutée que depuis le script
cqdiagnostics.pl.
Ce script contient des variables correspondant à tous les paramètres nécessaires à la commande. Editez le script pour préciser la commande
validatedb et les valeurs permettant de tester la ou les
base(s) de données, puis exécutez-le. Le script est installé dans le répertoire d'installation de Rational ClearQuest. L'emplacement par défaut est le suivant : cquest–home–dir\diagnostic\cqdiagnostics.pl.
-
- validatedb –rulefile fichier
de règles -logfile fichier journal [–resultsfile fichier
de résultats ] [ –rulenames noms de règle... | –rulegroups groupes
de règles... | –allrules ] -dbinfoschemarepo fournisseur_base_de_données serveur [ :numéro_port ] base_de_données connexion_utilisateur mot_de_passe_utilisateur options_connexion [ -dbinfouser nomlogique_bd_cq fournisseur_base_de_données serveur [ :numéro_port ] base_de_données connexion_utilisateur mot_de_passe_utilisateur options_connexion ]
[ –validateuserdbonly ] [–locale nom_envlocal]
Description
La sous-commande
validatedb permet de contrôler la validité de
l'intégrité d'un référentiel de schémas ou d'une base de données utilisateur par rapport à un ensemble de règles ou de groupes de règles
indiqués. Un fichier de règles contient les règles et groupes de règles pouvant être utilisés. Chaque règle représente une contrainte utilisée pour déterminer l'intégrité de la base de données testée. Un groupe de règles est une collection de règles.
L'outil contrôle la validité des éléments suivants d'une base de données :
- Structure d'un référentiel de schémas (tables, colonnes, index).
- Intégrité des données. La commande vérifie que toutes les données entrées dans la base de données proviennent de la même page de codes que celle des données du référentiel de schémas Rational ClearQuest.
- Structure d'une base de données utilisateur (tables, colonnes, index).
Gravité des règles
La commande
validatedb signale les violations de règle selon les niveaux de gravité suivants :
- [Severity = FATAL_ERROR] L'outil rencontre une violation qui entraînerait l'échec de la
plupart des règles suivantes et l'empêche donc de continuer les tests. La console indique le
niveau de gravité ainsi que la nature de la violation et arrête les tests suivants jusqu'à la
résolution de l'erreur. Les résultats sont également consignés dans le fichier journal et dans un
fichier de résultats, le cas échéant.
- [Severity = ERROR] L'outil rencontre une violation, mais elle ne l'empêche pas de continuer
les tests. La console affiche le niveau de gravité ainsi que la violation et continue les tests. Les résultats sont également consignés dans le fichier journal et dans un fichier de résultats, le cas échéant.
- [Severity = WARNING] L'outil rencontre une violation potentielle. La console affiche le niveau de gravité ainsi que la violation et continue les tests. Les résultats sont également consignés dans le fichier journal et dans un fichier de résultats, le cas échéant.
- [Severity = RECOMMENDATION] L'outil fournit une recommandation pour une violation ou violation potentielle et continue les tests. Les résultats sont également consignés dans le fichier journal et dans un fichier de résultats, le cas échéant.
- [Severity = INFORMATIONAL] La console affiche des informations spécifiées par la définition de
règles. Ces violations nécessitent une intervention manuelle suivant la définition de la règle. Les tests continuent et les résultats sont consignés dans le fichier journal et dans le fichier de résultats, le cas échéant.
Sortie de la commande validatedb
L'utilitaire donne les
informations suivantes :
- Résumé des paramètres d'entrée
- Chemin d'accès au fichier de règles.
- Chemin d'accès au fichier de résultats (le cas échéant).
- Chemin d'accès au fichier journal.
- Résumé des informations de base de données que vous avez fournies.
- Progression de l'exécution et statut des résultats de chaque règle.
- Etat d'exécution. L'état d'exécution indique la règle en cours d'exécution, le nombre de règles exécutées par rapport au nombre de règles appelées et les violations de règle qui se produisent.
- Etat des résultats. Si la base de données n'enfreint aucune règle, la console confirme
l'exécution d'une règle lorsqu'elle est terminée. Si la base de données enfreint une règle, la
console indique la gravité de la violation ainsi que sa nature.
- Récapitulatif des résultats à l'issue de l'exécution. Il comporte deux sections, le
récapitulatif des informations et le récapitulatif des résultats.
- Récapitulatif des informations. Toutes les violations de règle associées au niveau de gravité
INFORMATIONAL sont consignées dans cette section.
- Récapitulatif des résultats. Le récapitulatif des résultats contient les informations
suivantes :
- Nombre de règles appelées.
- Nombre de règles exécutées.
- Nombre de règles terminées.
- Nombre de violations pour chaque niveau de gravité.
Ces résultats sont consignés dans le fichier journal et dans le fichier de résultats, le cas échéant.
Options et arguments
- -rulefile
- Désigne le fichier de règles contenant les règles à tester sur une base de données.
Cette option contrôle la validité de la base de données par rapport à toutes les règles du fichier de règles.
Voir Exemples ci-après.
- -logfile
- Donne le détail de tous les événements qui se produisent pendant l'exécution d'une commande. Voir Exemples ci-après.
- -resultsfile
- Donne les résultats des tests. Le fichier de résultats ne donne pas d'informations détaillées
sur les événements comme le fait le fichier journal. Si la base de données n'enfreint pas la
règle indiquée, le fichier de résultats indique que l'exécution de la règle est terminée. Si la base de données enfreint la règle, le fichier de
résultats indique la gravité de la violation ainsi que sa nature. Voir Exemples ci-après.
- -rulenames
- Indique le nom d'une règle du fichier de règles à tester. Pour définir
plusieurs règles dans une même commande, insérez un espace entre chaque nom de règle.
Voir Exemples ci-après.
- -rulegroups
- Indique un groupe de règles du fichier de règles à tester. Utilisez cette option pour tester plusieurs règles sur une base de données sans appeler individuellement chaque règle.
Pour définir
plusieurs groupes de règles dans une même commande, insérez un espace entre chaque nom
de groupe de règles. Voir Exemples ci-après.
- -allrules
- Teste toutes les règles du fichier de règles.
- -dbinfoschemarepo
- Indique le référentiel de schémas à valider. Cette option donne les informations nécessaires pour localiser le référentiel de schémas et y accéder. Voir Tableau 1 pour connaître les paramètres de l'option -dbinfoschemarepo.
- -dbinfouser
- Indique la base de données utilisateur dont la validité doit être contrôlée. Voir Tableau 1 pour connaître les paramètres de l'option -dbinfouser.
Tableau 1. Paramètres des options -dbinfoschemarepo et -dbinfouserfournisseur_base_de_données |
serveur [:port] |
base_de_données |
connexion_utilisateur |
mot_de_passe_utilisateur |
options_connexion |
SQL_SERVER |
Nom de la machine serveur ou IP |
nom de la base de données |
nom de connexion |
mot de passe de connexion |
aucune |
ORACLE |
Nom de la machine serveur ou IP |
SID |
nom de connexion |
mot de passe de connexion |
options de connexion Oracle |
MS_ACCESS |
emplacement physique de la base de données |
aucune |
aucune |
aucune |
aucune |
DB2 |
Machine serveur ou IP |
nom de la base de données |
nom de connexion |
nom de connexion |
aucune |
- -validateuserdbonly
- A indiquer pour contrôler uniquement la validité de la base de données utilisateur.
- -locale
- Indique la langue utilisée dans la sortie. Le fichier de résultats et la console
proposent d'autres langues. Le fichier journal est quant à lui toujours écrit en anglais.
Exemples
L'exécution de la commande
validatedb se fait à partir de l'emplacement suivant :
cquest–home–dir\diagnostic\.
Remarque : Cette
commande ne peut être exécutée que depuis le script
cqdiagnostics.pl.