Outil de gestion de bases de données - Mode batch

L'Outil de gestion de bases de données peut être lancé en mode automatique depuis un fichier de commande. Les paramètres spécifient les valeurs par défaut des champs dans l'interface graphique. Si le mode d'exécution "auto" ou "no_gui" est spécifié, tous les paramètres nécessaires doivent être renseignés ; sinon, l'utilisateur peut compléter les informations au niveau de l'interface.

L'outil de gestion de bases de données en mode batch existe également en version Java, avec des restrictions fonctionnelles : les outils d'administration ne sont pas disponibles, le mode "via Middleware" n'est pas implémenté.

Spécificités de la version Java

La syntaxe de la ligne de commande java est la suivante :

java <javaOpts> com.hardis.adelia.dbtool.DbTool -<commande>-descfile:<nom_fichier> -database:<url_base>...

Le CLASSPATH doit être configuré de manière à inclure le runtime Adélia Java, les scripts de configuration ainsi que les pilotes JDBC nécessaires.

Les considérations suivantes doivent néanmoins être prises en compte :

Pour maximiser la compatibilité avec la version Windows, les encodages des fichiers texte correspondent par défaut au paramétrage d'un Windows occidental (pages de code 1252 pour le jeu de caractères ANSI). Il est néanmoins possible de choisir le jeu de caractères à utiliser pour les scripts SQL dépourvus de BOM via des paramètres de la ligne de commande java :

-DansiCharset=<charset>

Charset pour les entrées/sorties ANSI (scripts, imports ASCII délimité et fichiers IXF).

Par défaut "Cp1252" ("ISO-8859-1" si non supporté par la JVM).

Il est possible de contrôler le niveau de log et les informations affichées par la ligne de commande (INFO par défaut):

-Dverbose	Affiche le détail des exceptions en cas d'erreur.
-Ddebug	Active le niveau DEBUG au niveau des loggers.
-Dtrace	Active le niveau TRACE au niveau des loggers.
-Dlog4j.external.configuration=true	Par défaut l'outil utilise une configuration simplifiée de LOG4J pour limiter l'affichage aux messages pertinents. Si cette option est spécifiée, la configuration log4j ne sera pas initialisée par l'outil (chargement de log4j2.xml depuis le CLASSPATH).

De façon générale, les paramètres indiquant un nom de fichier ou de répertoire doivent être adaptés pour correspondre à la syntaxe des noms de fichiers de la plateforme (séparateur de chemin, lettres de lecteur, etc.).
La version java fonctionne uniquement en mode batch et ne supporte qu'un sous-ensemble des fonctionnalités de la version Windows.
Les outils d'administration ne sont pas supportés : création/sauvegarde de base de données, notamment les options create, backup, restore et delete.
Le mode d'exécution "via Middleware" n'est pas supporté.
Les instructions spécifiques à Windows dans les scripts ne sont pas implémentées (séquences d'échappement de test du registre).

Si un utilitaire est spécifié, et que l'exécution n'est pas en mode automatique, l'outil démarrera directement sur la page associée à l'action.

Les paramètres sont passés de façon générique sur la ligne de commande :

-param	pour les paramètres ne prenant pas de valeur.
-param:valeur_entiere	pour les paramètres prenant une valeur numérique.
-param:"valeur chaîne"	pour les paramètres prenant une valeur de type chaîne.

Les paramètres valides sont résumés dans les tableaux suivants :

(X : obligatoirement renseigné)

(O : optionnel)

(Vide : ignoré)

Utilitaires

Paramètre	Description	Cr	Ct	Sv	Rs	Su	E	I	C	M	Dt
create*	Création d'une base de données	X
create_tables	Création des structures de tables		X
backup*	Sauvegarde d'une base de données			X
restore*	Restauration d'une base de données				X
delete*	Suppression d'une base de données					X
export	Exportation d'une base de données						X
import	Importation d'une base de données							X
copy	Copie des données entre deux bases de données								X
update	Mise à jour des structures de tables									X
drop_tables	Suppression des structures de tables										X

* non supporté en version Java

Paramètres généraux

Paramètre	Description	Cr	Ct	Sv	Rs	Su	E	I	C	M	Dt
descfile	Nom complet du fichier de description de la base	X	X	X	X	X	X	X	X	X	X
logfile	Nom complet du fichier historique	O	O	O	O	O	O	O	O	O	O
dbm*	Nom du gestionnaire de bases de données Valeurs possibles : "db2", "oracle", "sql server", "btrieve", "ODBC", "AS400", "MySQL" Les valeurs "oracle7" et "oracle8" sont supportées pour compatibilité	X	X	X	X	X	X	X	X	X	X
database	Nom ou URL d'accès de la base de données origine ou nom de la bibliothèque AS/400 par défaut	X	X	X	X	X	X	X	X	X	X
user	Profil de connexion à la base de données origine		O				O	O	O	O	O
password	Mot de passe pour la connexion		O				O	O	O	O	O
dest_dbm*	Nom du gestionnaire de bases de données cible Valeurs possibles : "db2", "oracle", "sql server", "btrieve", "ODBC", "AS400", "MySQL" Les valeurs "oracle7" et "oracle8" sont supportées pour compatibilité								X
dest_database	Nom ou URL d'accès de la base de données cible								X
dest_user	Profil de connexion à la base de données cible								O
dest_password	Mot de passe pour la connexion								O
bt_dir*	Répertoire des fichiers origines (base Btrieve)		X				X	X	X		X
dest_bt_dir*	Répertoire des fichiers cibles (base Btrieve)						X	X	X
directory*	Répertoire pour les opérations d'import/export						X	X

no_gui*	Pas d'interface graphique ("auto" doit être spécifié)	O	O	O	O	O	O	O	O	O	O
auto*	Lance l'exécution de l'outil sans interaction avec l'utilisateur	O	O	O	O	O	O	O	O	O	O
report_mode*	Gère l'affichage des boîtes de messages : entier, somme des types de messages autorisés (1 : succès, 2 : avertissement, 4 : erreur)	O	O	O	O	O	O	O	O	O	O
no_input*	Pas d'action de l'utilisateur. Raccourci pour (-report_mode: 0 -auto)	O	O	O	O	O	O	O	O	O	O
host*	Nom d'hôte du serveur (AS/400 ou via Middleware)	X	X			X	X	X	X	X	X
port*	Port de connexion du serveur (AS/400 ou via Middleware - 910 par défaut)	O	O			O	O	O	O	O	O
miduser*	Nom d'utilisateur pour la connexion au serveur (AS/400 ou via Middleware)	X	X			X	X	X	X	X	X
midpassword*	Mot de passe pour la connexion au serveur (AS/400 ou via Middleware)	X	X			X	X	X	X	X	X
curlib*	Bibliothèque ou schéma par défaut (AS/400)		O				O	O	O	O	O
logged*	Fonctionnement en mode journalisé (AS/400) – nécessite que les tables soient journalisées explicitement ou créées dans une collection sur l'AS/400. En mode création, ce paramètre provoque la création d'une collection SQL. Mode autocommit (logged = 0) par défaut.		O				O	O	O	O	O
dest_host*	Nom d'hôte du serveur pour l'AS/400 cible (AS/400 ou via Middleware - 910 par défaut)								X
dest_port*	Port de connexion du serveur pour l'AS/400 cible (AS/400 ou via Middleware)								O
dest_miduser*	Nom d'utilisateur pour la connexion au serveur cible (AS/400 ou via Middleware)								X
dest_midpassword*	Mot de passe pour la connexion au serveur cible (AS/400 ou via Middleware)								X
dest_curlib*	Bibliothèque ou schéma par défaut pour l'AS/400 cible (AS/400)								O

* non supporté en version Java

Les sections suivantes s'appliquent aux fonctions d'administration (paramètres de création, sauvegarde, restauration et destruction d'une base de données) et ne s'appliquent donc pas à la version Java.

Paramètres pour AS/400

Paramètre	Description	Cr	Ct	Sv	Rs	Su	E	I	C	M	Dt
description	Description de la bibliothèque	X
num_asp	Numéro d'ASP (entre 1 et 32, 1 par défaut)	O

Paramètres pour DB2

Paramètre	Description	Cr	Ct	Sv	Rs	Su	E	I	C	M	Dt
database_unit	Unité de disque de la base de données	X			X
database_comment	Commentaire de la base de données	O
backup_directory	Répertoire de l'image de sauvegarde			X	X
orig_database	Nom initial de la base de données correspondant à l'image de sauvegarde				X
timestamp	Horodatage de l'image de sauvegarde à restaurer, sous la forme AAAAMMJJHHMISS				O
force_overwrite	Ecrase une base existante sans confirmation				O

Paramètres pour ORACLE

Paramètre	Description	Cr	Ct	Sv	Rs	Su	E	I	C	M	Dt
database_sid	SID de la base de données Attention : 4 lettres si Oracle < 8.1	X			X
database_directory	Répertoire de la base de données	X			X
database_password	Mot de passe interne de la base de données	X		X	X	X
backup_directory	Répertoire de l'image de sauvegarde			X	X
database_init_file	Fichier de paramètres de la base de données			X	X	X
force_shutdown	Force la fermeture des sessions actives			O	O	O
force_overwrite	Ecrase une base existante sans confirmation				O
data_tablespace	Espace table pour les tables (et les index en l'absence de paramétrage spécifique	O	O							O
index_tablespace	Espace table pour les index	O	O							O

Paramètres pour SQL SERVER

Paramètre	Description	Cr	Ct	Sv	Rs	Su	E	I	C	M	Dt
data_file	Nom du fichier de données	X
data_file_size	Taille initiale du fichier de données	O
data_file_size_max	Taille maximale du fichier de données (si -1, illimitée)	O
data_file_size_inc	Taille des incréments du fichier de données	O
log_file	Nom du fichier journal	X
log_file_size	Taille initiale du fichier journal	O
log_file_size_max	Taille maximale du fichier journal (si -1, illimitée)	O
log_file_size_inc	Taille des incréments du fichier journal	O
backup_device	Nom de l'unité de sauvegarde			X	X
backup_number	Numéro de la sauvegarde dans l'unité de sauvegarde			X	X
move_files	"Renommages" de fichiers - suite de couples nom origine,nom renommé séparés par des " ;" Ex : "d:\data\test.dat,d:\data\test_bis.dat; d:\data\test.log,d:\data\test_bis.log"				O
force_overwrite	Ecrase une base existante sans confirmation				O

Paramètres pour MySQL

Paramètre	Description	Cr	Ct	Sv	Rs	Su	E	I	C	M	Dt
user	Utilisateur disposant des droits d'administration du serveur MySQL (ex : root)	X				X
password	Mot de passe de l'utilisateur	X				X

Paramètres pour PostgreSQL

Paramètre	Description	Cr	Ct	Sv	Rs	Su	E	I	C	M	Dt
user	Utilisateur disposant des droits d'administration du serveur PostgreSQL (ex : postgres)	X				X
password	Mot de passe de l'utilisateur	X				X

Paramètres pour ODBC (Access)

Paramètre	Description	Cr	Ct	Sv	Rs	Su	E	I	C	M	Dt
database_directory	Répertoire où le fichier de la base de données sera créé (nom_base.mdb)	X

Exemples :

Création d'une base TEST DB2 sur C, sans interaction :

start /wait dbtool -descfile:"adelia.dbd" -create -dbm:"db2" -database:"TEST" -database_unit:C -database_comment:"test création" -logfile:"c:\temp\test.log" -auto

Restauration d'une base TEST DB2 sur C depuis l'image de sauvegarde de BASETEST sur d:\backup, sans interaction :

start /wait dbtool -descfile:"adelia.dbd" -restore -dbm:"db2" -database:"TEST" -database_unit:C -orig_database:"BASETEST" -backup_directory:"d:\backup" -logfile:"c:\temp\test.log" -auto

↑ Haut de page