L'Outil de copie de données peut être utilisé en ligne de commandes via la commande CopyB.
Cette commande s'appuie sur un fichier script (*.cps) indiquant les opérations à effectuer. Ce fichier peut être généré interactivement par l'Outil de copie de données (assistant graphique), ou être construit par l'utilisateur.
La syntaxe de la commande est la suivante :
C:\> copyb @<nom_du_fichier_script>.cps
Il est également possible de préciser complètement le contenu d'un script sur la ligne de commandes :
C:\> copyb LOG=((NAME="test.log"))...
Cette syntaxe présente l'inconvénient de générer des lignes de commandes très longues et peu lisibles. En outre, dans le cas de copies multiples de données provenant de la même source, cette solution est moins performante que l'utilisation d'un fichier script .cps (multiples reconnexions à la base de données et/ou au Middleware).
L'outil de copie de données existe aussi en version Java, les paramètres de la ligne de commande sont identiques à la version Windows.
La syntaxe de la ligne de commande est la suivante :
java <javaOpts> com.hardis.adelia.copyb.CopyB @<nom_du_fichier_script>.cps
java <javaOpts> com.hardis.adelia.copyb.CopyB LOG=((NAME="test.log"))...
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 être prises en compte pour la version Java :
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 et 850 pour le jeu de caractères ASCII). Il est néanmoins possible de choisir les jeux de caractères à utiliser via des paramètres de la ligne de commande Java :
- DansiCharset =< charset > | Charset pour les entrées/sorties ANSI (source ASCII délimité, IXF). Par défaut "Cp1252" ("ISO-8859-1" si non supporté par la JVM). |
- DasciiCharset =< charset > | Charset pour les entrées/sorties AS CI I (source ASCII délimité). Par défaut "Cp 850" ("US-ASCII" 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é 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 devront être adaptés pour correspondre à la syntaxe des noms de fichiers de la plateforme (séparateur de chemin, lettres de lecteur, etc.).
Cliquez ci-dessous pour plus d'informations sur :
› Le format d'un fichier script.