Les paramètres de configuration de l'utilitaire de conversion de base de données UMF sont stockés dans un fichier de configuration.
La table 1 définit deux sections du fichier de configuration de l'utilitaire de conversion de base de données UMF.
Tableau 1. Sections du fichier de configurationEn-tête de chapitre |
Description |
[gda] |
Contient les données de configuration d'un utilitaire de conversion de base de données UMF. Ne pas modifier le nom de cette section. |
[SQL] |
Définit la connexion de la base de données à la fois pour les bases de données
source et de configuration. |
Paramètres de la section [gda]
- ErrorLimit =n
- Nombre d'erreurs qui se produisent avant l'arrêt du noeud (10 par défaut).
- ErrorPause =n
- Temps de pause en secondes après une erreur (1 par défaut).
- ErrorResetInterval =n
- Temps en minutes avant la réinitialisation du nombre d'erreurs (par défaut, 0 1440 minutes/24 heures).
Remarque :
ErrorLimit et ErrorResetInterval interagissent. Si la limite des erreurs n'est pas dépassée, le nombre d'erreurs
est remis à 0 dès que ce paramètre ErrorResetInterval s'est écoulé. L'erreur suivante est alors comptabilisée comme erreur
numéro 1 et le pipeline ne s'arrête pas tant que le paramètre ErrorLimit n'est
pas dépassé dans le délai indiqué par ErrorResetInterval.
- SyncLogName
- Permet d'indiquer un nom de journal de synchronisation différent dans
le fichier INI (valeur par défaut = SYNC_LOG). Par défaut, la valeur est 'sync_log'. Utilisable avec la
macro $$REPLACE(SYNC_LOG) afin d'autoriser le partage d'un ensemble
d'entrées de configuration de la base de données entre plusieurs noeuds.
- ConfigName
- (Paramètre facultatif) Sert à indiquer les enregistrements de
configuration à utiliser pour ce noeud (par défaut = SYNC_LOG_TEST). Il doit correspondre à la valeur de
ACQ_NODE_QUERY.ACQ_NODE et ACQ_NODE_MAP.ACQ_NODE.
Cette action permet à plusieurs noeuds d'utiliser les mêmes tables de
bases de données Configuration. Par défaut, la valeur est le nom
du noeud.
- SelectCount
- Détermine le nombre d'enregistrements traités dans une instruction
SELECT, généralement aux alentours de 1000 (4, par défaut). Certains ajustements
des performances sont éventuellement nécessaires pour parvenir à la valeur optimale de
ce paramètre.
- Une valeur trop élevée peut engendrer des verrouillages
excessifs de la base de données source.
- Une valeur trop basse (proche de 1) risque de réduire les
performances à cause du temps système ajouté à chaque instruction SELECT, étant
exécutée plus souvent.
- La modification de la valeur de ce paramètre permet
de régler la vitesse d'envoi des messages vers les files
d'attente du pipeline (un nombre plus élevé signifie un
envoi plus rapide vers les files d'attente).
- DsrcCode
- (Chaîne facultative) S'utilise dans les mappages à l'aide de $$REPLACE(DSRC_CODE) dans ACQ_NODE_QUERY.SELECT_STMT (par défaut = `Source1'). En règle
générale, sert à permettre l'utilisation des mêmes entrées de configuration de base
de données par plusieurs noeuds d'acquisition.
- PropertyCode
- (chaîne facultative) Utilisée dans les mappages à l'aide de
$$REPLACE(PROPERTY_CODE) dans ACQ_NODE_QUERY.SELECT_STMT. En règle
générale, sert à permettre l'utilisation des mêmes entrées de configuration de base
de données par plusieurs noeuds d'acquisition.
- String1 (String2 à 5 existent également)
- (Chaîne facultative) S'utilise dans les mappages à l'aide de $$REPLACE(STRING1) dans ACQ_NODE_QUERY.SELECT_STMT (par défaut = 'E,G,H'). En règle
générale, sert à permettre l'utilisation des mêmes entrées de configuration de base
de données par plusieurs noeuds d'acquisition.
- RoutingField
- Balise UMF déterminant la zone UMF qui sert à partager les
messages UMF cibles entre tous les pipelines définis dans les règles de
routage du noeud (par défaut = DSRC_ACCT).
Cette zone correspond au numéro de référence client
(en règle générale, DSRC_ACCT). Tous les caractères non numériques sont
enlevés de la zone et une mesure est réalisée sur le numéro qui en
découle.
- ConfigEntryLessThanEqualT =n
- Sert à exécuter plus d'un seul noeud sur un seul journal de
synchronisation (valeur par défaut = 4).
Force le noeud à s'exécuter uniquement avec les entrées
ACQ_NODE_QUERY où ACQ_QUERY_SEQ <= valeur
- ConfigEntryGreaterThanEqualT =n
- Sert à exécuter plus d'un seul noeud sur un seul journal de
synchronisation (valeur par défaut = 1).
Force le noeud à s'exécuter uniquement avec les entrées
ACQ_NODE_QUERY où ACQ_QUERY_SEQ >= valeur
Paramètres de la section [sql]
- ConfigDatabaseName = source_de_données
- Base de données Configuration :
- Oracle = SID
- MS SQL Server =DSN.
- La base de données définie par défaut pour le DSN
doit être la base de données cible.
- DB2 = ODBC
- ConfigLoginName =nom_utilisateur
- Nom de connexion de la base de données Configuration. Peut être vierge sous Windows si la
connexion ODBC utilise l'authentification Windows.
- ConfigLoginPassword =mot_de_passe
- Mot de passe de la base de données Configuration.
- ConfigDbType =type_de_base
- Type de la base de données Configuration :
- MSSQL (par défaut)
- DB2
- ORACLE
- SourceDatabaseName
- Base de données source :
- Oracle = SID
- MS SQL Server =DSN.
- La base de données définie par défaut pour le DSN
doit être la base de données cible.
- DB2 = ODBC
- SourceLoginName
- Nom de connexion de la base de données source. Peut être vierge sous Windows si la
connexion ODBC utilise l'authentification Windows.
- SourceLoginPassword
- Mot de passe de la base de données source.
- SourceDbType =type_de_base
- Type de la base de données source :
- MSSQL (par défaut)
- DB2
- ORACLE
- DBTimeOut =n
- Délai d'attente (en secondes) de l'utilitaire de conversion de base de données UMF pour obtenir une réponse de la base
de données avant expiration (par défaut = 10)
- DebugLevel =n
- Contrôle les messages envoyés au journal de débogage SQL :
nodename.SqlDebug.log
- 0=Aucun journal créé, utilisé pour le débogage (valeur par défaut)
- 1=Consigne les statistiques de performances
- 2=Consigne tous les SQL
- 3=Débogue les niveaux 1 et 2