Traçage et journalisation d'erreur de la base de données
Lorsqu'un mappage écrit des données dans une base de données, vous pouvez choisir d'activer le traçage et la journalisation d'erreur de la base de données. Le traçage est utile si vous souhaitez suivre tous les changements effectués par le mappage dans la base de données lorsque le mappage est en cours d'exécution. Lorsque le traçage est activé, des événements comme des actions d'insertion ou de mise à jour de la base de données ou des erreurs sont journalisées dans un fichier XML que vous pouvez ensuite analyser ou éventuellement traiter ultérieurement de manière automatisée. Si vous préférez que le fichier log soit sous un autre format que XML, vous pouvez mapper les données en option de celui-ci vers un autre genre de composant pris en charge par MapForce (par exemple, un fichier texte, ou même une autre base de données).
| Note : | pour qu’un mappage prenne en charge un traçage et une journalisation d’erreur, le langage de mappage doit être défini comme Built-in. |
Le traçage de la base de données est configurable, dans le sens que vous pouvez choisir de tracer tous les messages, uniquement des erreurs ou vous pouvez désactiver le traçage complètement. De plus, vous pouvez utiliser le traçage aux niveaux suivants :
•Niveau de composant de base de données. À ce niveau, vous activez ou désactivez le traçage pour ce composant de base de données. Ceci est utile pour les mappages qui ont de multiples composants de base de données cible et vous avez besoin de traçage uniquement pour certains d’entre eux.
•Niveau de table ou de procédure stockée. Dans un composant de base de données, vous pouvez décider si vous souhaitez que le traçage se produise pour chaque table ou procédure stockée. S'il est activé le traçage à ce niveau contient des événements touchant à des actions de table comme "Insert All", "Update If", "Ignore If", "Delete If". Dans le cas de procédures stockées, les événements liés à l'appel de procédure stockée sont tracés.
•Niveau de champ de base de données. Par défaut, tous les champs sont tracés, mais vous pouvez exclure certains champs du traçage, ou bien, vous pouvez spécifier qu'ils doivent être inclus dans le fichier de traçage uniquement en cas d'erreur.
Chose importante, les trois niveaux au-dessus sont hiérarchiques et les paramètres de traçage sont ventilés de haut en bas. Ainsi, si vous désactivez le traçage au niveau du composant de base de données, il ne sera pas possible de l'activer au niveau de table ou de procédure stockée. De même, si vous désactivez le traçage au niveau de la table, il ne sera pas possible de le configurer au niveau du champ de base de données (colonne). La même chose vaut lorsque vous réduisez le niveau de traçage. Par exemple, si vous limitez le traçage uniquement à des erreurs au niveau du composant de base de données, il ne sera pas possible d'utiliser le traçage complet au niveau de la table ou de la procédure stockée.
Traçage au niveau de composant de base de données
Pour activer le traçage au niveau du composant de la base de données :
1.Cliquer avec la touche de droite sur le composant de base de données, et choisissez Propriétés depuis le menu contextuel (en alternative, double-cliquer sur la barre de titre du composant de base de données). Le dialogue Paramètres de composant de la base de données s'ouvre.
2.Sélectionnez le niveau de traçage désiré (Toujours, Erreurs, Désactivé). Sélectionnez des erreurs créera un fichier de trace uniquement si les erreurs de base de données apparaissent quand le mappage est exécuté.
3.À côté de Fichier de traçage, saisir le nom ou le chemin du fichier XML dans lequel tous les détails de traçage seront rédigés (par exemple, Log.xml). Si vous saisissez un nom de fichier au lieu d'un chemin complet, le fichier de traçage sera créé dans le même répertoire que le mappage sera exécuté.
Une fois avoir activé le traçage, le composant de base de données change sa structure dans le mappage. Notamment, il affiche une nouvelle hiérarchie de nœud, en plus de la structure de base de données, là où l’item du niveau supérieur est un fichier de traçage dans la hiérarchie. Pour plus d'informations, voir Structure du fichier de traçage.
L'activation du traçage au niveau du composant de base de données l'active automatiquement pour toutes les tables ou les procédures stockées sur le composant pour lequel une connexion de mappage existe. Le cas échéant, vous pouvez modifier encore le traçage au niveau de table ou de procédure stockée, comme décrit ci-dessous. Veuillez noter que les tables ou les procédures stockées qui sont affichées dans le composant mais qui ne participent pas au mappage (cela signifie qu'aucune connexion de mappage n'existe pour lui) ne seront pas tracées.