Le module Loader vous permet de personnaliser le programme de chargement Loader en procédant comme suit :
Vous pouvez personnaliser ces fonctions du programme de chargement Loader en procédant comme suit :
![]()
![]()
![]()
![]()
MassLoadCustomizer.properties se trouve dans le fichier archive MassLoader.zip. Extrayez ce fichier, renommez-le tout en gardant l'extension .properties. Placez-le ensuite dans un répertoire situé dans le chemin de classe.
Le fichier ISeries_LODWCSDTA_Customizer.properties se trouve dans le répertoire
/QIBM/ProdData/WebCommerce/properties. Copiez ce fichier dans le répertoire
/racine_inst/xml, renommez-le en conservant l'extension
.properties, puis apportez les modifications nécessaires au nouveau
fichier. Important : ne supprimez pas et ne modifiez pas le fichier
ISeries_LODWCSDTA_Customizer.properties d'origine.
Substitution d'un composant
Vous pouvez attribuer aux éléments ci-après du fichier de propriétés de personnalisation de Loader les valeurs de classes que vous souhaitez substituer aux composants par défaut :
- ParserName
- Nom de l'outil d'analyse à utiliser
- ValidatorName
- Nom du valideur à utiliser
- FormatterName
- Nom du module de formatage à utiliser
- JDBCFormatterName
- Nom du module de formatage lorsque la méthode d'importation SQL est utilisée
- WriterName
- Nom du programme d'écriture à utiliser
- JDBCWriterName
- Nom du programme d'écriture lorsque la méthode d'importation SQL est utilisée
Pour remplacer le programme d'écriture par défaut (DefaultWriter) de Loader par le programme d'écriture com.abc.writer.SpecialWriter, par exemple, spécifiez les informations suivantes dans le fichier de propriétés de personnalisation :
WriterName = com.abc.writer.SpecialWriter
Le programme de chargement Loader utilisera "com.abc.writer.SpecialWriter"
pour effectuer la fonction d'écriture.
Définition du programme de chargement Loader pour qu'il ignore les éléments du fichier d'entrée
Si votre fichier d'entrée contient des éléments qui ne correspondent pas à ceux de la base de données cible, vous pouvez définir le programme de chargement Loader pour qu'il ne prenne pas en compte ces éléments dans le fichier de propriétés de personnalisation de Loader. Utilisez IgnoreElements pour spécifier les éléments à ignorer et séparez ces éléments d'un point virgule (;). Par exemple, pour ignorer les éléments import, literals et ProductRepository, spécifiez les informations suivantes dans le fichier de propriétés de personnalisation de Loader :
IgnoreElements = import;literals;ProductRepository
Gestion de files d'attente d'événements
Vous pouvez gérer des files d'attente d'événements en modifiant les paramètres dans le fichier de propriétés de personnalisation de Loader. Par exemple :
QueueLowCount = 35 QueueHighCount = 90
La source des événements remplissant la file d'attente est bloquée lorsque le nombre d'éléments de la queue atteint la limite supérieure, empêchant d'autres événements de se mettre en file d'attente. La file d'attente accepte de nouveau des événements lorsque le nombre d'éléments dans la file d'attente tombe au-dessous de la limite inférieure.
Définition du programme de chargement Loader pour qu'il s'exécute avec des logiciels de base de données et systèmes d'exploitation différents
Vous pouvez modifier les paramètres des éléments suivants, dans le fichier de propriétés de personnalisation de Loader pour indiquer des logiciels de base de données et des systèmes d'exploitation différents :
Pour personnaliser l'un de ces éléments, supprimer les caractères de commentaires, doubles barres obliques, (//), précédant l'instruction, dans le fichier de propriétés de personnalisation et modifiez les éléments par défaut.
Vous pouvez modifier les paramètres de l'instruction de connexion à une base de données si vous souhaitez modifier les éléments par défaut (ce qui suppose que vous utilisez DB2).
DBConnectCommand = connect to {0} user {1} using {2};où :
0 = nom de la base de données
1 = utilisateur de la base de données
2 = mot de passe utilisateur
Vous pouvez modifier les paramètres de l'instruction de table de chargement de base de données si vous souhaitez modifier les éléments par défaut.
DBLoadTableCommand = load from {0} of del modified by coldel{1} chardel{2} insert into {3} ({4});où :
0 = nom du fichier
1 = délimiteur de colonne
2 = délimiteur de caractères
3 = nom de la table
4 = noms de colonnes, séparés par des virgules (,)
Vous pouvez modifier les paramètres de l'instruction d'importation de base de données si vous souhaitez modifier les éléments par défaut.
DBImportCommand = import from {0} of del modified by coldel{1} chardel{2} insert_update into {3} ({4});où :
0 = nom du fichier
1 = délimiteur de colonne
2 = délimiteur de caractères
3 = nom de la table
4 = noms de colonnes, séparés par des virgules (,)
Vous pouvez modifier les paramètres de l'instruction système appelant le chargement si vous souhaitez modifier les éléments par défaut. Cette instruction exécute le chargement natif et importe les scripts générés par le programme de chargement Loader.
DBLoadCommand = db2clpex DB2 -z {0} -astvf {1}
où :
0 = nom du fichier journal
1 = nom du fichier de l'instructionPour DB2 s'exécutant sous AIX, par exemple, la valeur de la propriété DBLoadCommand est la suivante :
db2 -tvf {1} -z {0}
![]()
![]()
![]()
DBLoadCommand = sqlldr log={0} control={1} USERID={2}
où :
0 = nom du fichier journal
1 = nom du fichier de l'instruction
2 = nom utilisateur de la base de données
Utilisez le paramétrage suivant pour les différentes combinaisons de base de données et de système d'exploitation :
![]()
![]()
Définissez la variable d'environnement système CLASSPATH afin qu'elle inclut le fichier db2/dbconnect.zip pour DB2 sous NT ou Windows 2000 à l'aide de la méthode sqlimport, load, import, ou delete.
![]()
![]()
![]()
Pour DB2 s'exécutant sous AIX, Solaris ou Linux, procédez comme suit :
- Avec la méthode sqlimport, load, import, ou delete, définissez la variable d'environnement système classpath pour qu'elle inclut le fichierdb2/dbconnect.zip.
- Avec la méthode load ou import, modifiez les propriétés suivantes dans le fichier de propriétés de personnalisation Loader.
/** * Connection command. (Default is for DB2) * parameter 0 = dbName * parameter 1 = dbUser * parameter 2 = userPasswd */ DBConnectCommand = connect to {0} user {1} using {2}; /** * Load Data into Table command. (Default is for DB2) * parameter 0 = filename * parameter 1 = column delimiter * parameter 2 = character delimiter * parameter 3 = name of the table * parameter 4 = name of the columns, separated by comma(,)s */ DBLoadTableCommand = load from {0} of del modified by coldel{1} insert into {3} ({4}); /** * Insert Data into Table command. (Default is for DB2) * parameter 0 = filename * parameter 1 = column delimiter * parameter 2 = character delimiter * parameter 3 = name of the table * parameter 4 = name of the columns, separated by comma(,)s */ DBUpdateTableCommand = import from {0} of del modified by coldel{1} insert_update into {3} ({4}); /** * System command to invoke load (Default is for DB2) * parameter 0 = logFileName * parameter 1 = commandFileName */ DBLoadCommand = db2 -z {0} -tf {1}
![]()
Modifiez les propriétés suivantes dans le fichier de propriétés de personnalisation de Loader pour DB2 s'exécutant sous iSeries avec la méthode sqlimport, load, import ou delete :
/** * The connect string. */ ConnectStringID = jdbc:db2:// /** * The JDBC driver information. */ JDBCDriverName = com.ibm.db2.jdbc.app.DB2Driver DbVendorName=DB2/iSeries /** * Custom writer for load/import methods. */ WriterName=com.ibm.wca.MassLoader.Writer.ISeriesWriter
![]()
![]()
![]()
![]()
![]()
Définissez la variable d'environnement système classpath pour qu'elle inclut le fichier oracle/dbconnect.zip pour la base de données Oracle s'exécutant sous Windows NT, Windows 2000, AIX, Solaris ou Linux avec la méthode sqlimport, load, import ou delete.
Activation de Loader pour insérer NULL dans une colonne
Vous pouvez activer Loader pour insérer NULL dans une colonne en définissant la propriété EnableNULLCheck par "true" dans le fichier de propriétés de personnalisation de Loader. Par exemple :
EnableNULLCheck = true
Pour des raisons de performances, cette fonction est désactivée par défaut.
Utilisez la propriété NULLStringLiteral pour déterminer la représentation de la chaîne d'une valeur null dans vos données. Pour définir Loader afin que la chaîne "-" soit utilisée pour représenter une valeur null, par exemple, spécifiez la propriété et la valeur suivante dans le fichier de propriétés de personnalisation de Loader :
NULLStringLiteral = -
Par défaut, la valeur de cette propriété est "NULL" (sans guillemets).
Définition de masques d'horodatage
Pour plus d'informations sur la modification ou l'ajout de masques d'horodatage dans le fichier de propriétés de personnalisation de Loader, reportez-vous aux tâches "Chargement d'horodatages en cours" et "Chargement de données d'horodatage et de date" répertoriées ci-dessous.
![]() |