| |
Après avoir défini les paramètres d'authentification, vous devez définir les paramètres du pilote.
Ces paramètres se répartissent en trois séries :
Dans iManager, cliquez sur Gestion DirXML > Présentation.
Recherchez l'ensemble qui contient le pilote puis cliquez sur l'icône du pilote.
Dans Présentation du pilote DirXML, cliquez sur l'objet Pilote. Les configurations de pilote s'affichent.
Le tableau suivant dresse la liste des paramètres avec des exemples de valeurs :
Le nom de classe du pilote JDBC tiers est un paramètre obligatoire avec distinction majuscules/minuscules. Il désigne le nom de classe qualifié complet du pilote JDBC tiers que vous utilisez pour communiquer avec votre base de données. Le tableau suivant donne des exemples de nom de classe du pilote :
Synchroniser le schéma est un paramètre obligatoire avec distinction possible majuscules/minuscules. Ce paramètre correspond au schéma de base de données en cours de synchronisation. Un schéma de base de données est analogue au nom du propriétaire des tables en cours de synchronisation. Par exemple, si vous souhaitez synchroniser deux tables, EMP et PHONE, qui appartiennent au même utilisateur de base de données DIRXML, vous devez entrer DIRXML dans ce champ. Lorsque ce paramètre est utilisé, le paramètre Synchroniser la ou les tables doit être laissé vide ou omis de la configuration d'un pilote.
Synchroniser la ou les tables est un paramètre obligatoire avec distinction possible majuscules/minuscules. Ce paramètre permet de créer un schéma de base de données virtuel en dressant une liste des noms des tables parent (ou des noms de classe de base de données logiques) à synchroniser. Ce paramètre est utile pour une synchronisation avec des bases de données qui ne prennent pas en charge la notion de schéma ou lorsque le schéma de synchronisation contient un grand nombre de tables dont quelques-unes seulement présentent un intérêt pour le pilote. Lorsque ce paramètre est utilisé, le paramètre Synchroniser le schéma doit être laissé vide ou omis de la configuration d'un pilote.
Réutiliser les instructions est un paramètre sans distinction majuscules/minuscules qui peut être obligatoire pour certaines bases de données. Si vous attribuez la valeur « oui » (valeur par défaut) à ce paramètre, le pilote alloue les objets java.sql.Statement, java.sql.PreparedStatement et java.sql.CallableStatement une seule fois, puis les réutilise. Lorsque ce paramètre a la valeur « non », le pilote alloue ou libère les objets Instruction chaque fois qu'ils sont employés. La valeur « non » attribuée à ce paramètre entraîne un ralentissement des performances du pilote.
Il convient d'attribuer la valeur « non » à ce paramètre en cas d'utilisation avec le pilote Microsoft SQL Server 2000 pour JDBC. Sinon, pour des performances maximales du pilote, Novell recommande d'utiliser la valeur par défaut ou d'omettre ce paramètre de la plupart des configurations de pilote.
Utiliser les transactions manuelles est un paramètre sans distinction majuscules/minuscules dont la valeur est tirée des métadonnées de la base de données en phase d'exécution. Ce paramètre ne doit être utilisé que lorsqu'il est nécessaire de remplacer le comportement par défaut du pilote. Par exemple, pour MySQL, la prise en charge des transactions est déterminée sur la base de la table plutôt que de la base de données. Dans ce cas, il est nécessaire de désactiver la prise en charge des transactions manuelles lors d'une synchronisation avec des tables sans prise en charge des transactions.
Lorsque ce paramètre a la valeur « oui », le pilote prend en charge l'utilisation de transactions manuelles. Lorsqu'il a la valeur « non », toute instruction exécutée par le pilote est une transaction automatique.
Pour assurer l'intégrité des données dans la base de données cible, Novell recommande d'omettre ce paramètre de la plupart des configurations de pilote.
Utiliser la connexion simple est un paramètre sans distinction majuscules/minuscules qui peut être obligatoire pour certaines bases de données. Lorsqu'il a la valeur « oui », les canaux Abonné et Éditeur partagent une connexion unique. Lorsqu'il a la valeur « non » (par défaut), chaque canal emprunte une connexion séparée. La valeur « oui » attribuée à ce paramètre entraîne un ralentissement des performances du pilote. Ce paramètre ne doit prendre la valeur « oui » que lorsque les canaux Abonné et Éditeur sont utilisés.
Pour des performances maximales du pilote, il est recommandé d'utiliser la valeur par défaut ou d'omettre ce paramètre de la plupart des configurations de pilote.
Le niveau d'isolation de transaction par défaut est un paramètre facultatif sans distinction majuscules/minuscules, qui comporte quatre valeurs possibles en fonction des constantes publiques définies dans l'interface java.sql.Connection :
La valeur par défaut est « lecture validée ». Novell recommande d'utiliser le niveau d'isolation de transaction « lecture validée ». Pour plus d'informations sur ces valeurs, reportez-vous au site Web de Sun.
Étant donné que certains pilotes de fabricants tiers ne reconnaissent pas la valeur « aucune » du niveau d'isolation de transaction pour une connexion, le pilote accepte également la valeur supplémentaire « non prise en charge ».
L'instruction de test de la connexion est un paramètre facultatif avec distinction possible majuscules/minuscules. Ce paramètre est une solution de remplacement rapide à la création d'une classe de testeur de connexion. Pour détecter l'échec de la connexion, il suffit souvent d'envoyer une instruction SQL arbitraire via le réseau.
Lorsqu'il est présent, ce paramètre remplace le paramètre Nom de classe du testeur de connexion.
Le nom de classe du testeur de connexion est un paramètre avec distinction majuscules/minuscules, qui peut être obligatoire pour certains pilotes tiers. Il s'agit du nom qualifié complet de la classe utilisée pour déterminer l'état de la connexion. Cette classe doit être publique, comporter un constructeur par défaut public et mettre en oeuvre l'interface com.novell.nds.dirxml.driver.jdbc.db.DBConnectionTester.
La valeur par défaut est « com.novell.nds.dirxml.driver.jdbc.util.JDBCConnectionTester ».
Pour le pilote Microsoft SQL pour JDBC, définissez la valeur suivante : « com.novell.nds.dirxml.driver.jdbc.db.MSSQLConnectionTester »
Pour le pilote JDBC d'Informix, définissez la valeur : « com.novell.nds.dirxml.driver.jdbc.db.InformixConnectionTester »
Pour le pilote Mysql Connector/J, définissez la valeur : « com.novell.nds.dirxml.driver.jdbc.db.MySQLConnectionTester »
Ce paramètre est ignoré lorsqu'une valeur est définie pour le paramètre Instruction de test de la connexion.
Récupérer les métadonnées minimales est un paramètre sans distinction majuscules/minuscules, qui peut être obligatoire pour certaines bases de données. Lorsqu'il a la valeur « oui », le pilote n'appelle que des méthodes de métadonnées obligatoires. Pour plus de détails, reportez-vous à Méthodes java.sql.DatabaseMetaData . Lorsque la valeur « non » (par défaut) est définie pour ce paramètre, le pilote appelle les méthodes de métadonnées obligatoires et facultatives. Les méthodes de métadonnées facultatives sont requises pour la synchronisation des attributs à valeurs multiples et référentiels.
La valeur « oui » définie pour cette valeur entraîne une amélioration du temps de démarrage du pilote.
Ce paramètre a été désapprouvé et n'a aucun effet. Tous les noms de table sont désormais des noms qualifiés de schéma dans la mesure où un nom de schéma est disponible.
Gérer les résultats des instructions est un paramètre facultatif sans distinction majuscules/minuscules. Ce paramètre indique au pilote le nombre d'ensembles de résultats qui peuvent être générés par une instruction SQL. Trois valeurs sont possibles : « none », « single », « multiple » (valeur par défaut).
Pour des raisons de compatibilité amont, la valeur « yes » équivaut à « multiple » et la valeur « no », à « none ».
Pour le pilote ODBC de Microsoft, Oracle ou Informix, vous devez attribuer la valeur « single » à ce paramètre. Pour les autres bases de données ou pilotes tiers, Novell recommande d'utiliser la valeur par défaut ou d'omettre ce paramètre de la plupart des configurations de pilote.
La chaîne d'initialisation de la connexion est un paramètre facultatif avec distinction possible majuscules/minuscules. La chaîne d'initialisation de la connexion sert à définir des propriétés sur les connexions utilisées par le pilote. Il convient de séparer plusieurs valeurs d'instruction par des points-virgules. Ce paramètre permet d'ajuster les normes de compatibilité ANSI et le contexte de base de données.
Le tableau suivant dresse la liste des paramètres avec des exemples de valeurs.
Désactiver est un paramètre facultatif sans distinction majuscules/minuscules. Lorsque ce paramètre a la valeur « oui », le canal Abonné ne traite pas les événements, mais renvoie des avertissements à la place. Lorsque la valeur de ce paramètre est « non » (par défaut), le canal Abonné traite les événements.
La génération de clé primaire est un paramètre facultatif avec distinction possible majuscules/minuscules. Les identificateurs de base de données utilisés dans cette valeur ne doivent pas être délimités.
Lors du traitement d'événements <add> (ajouter), le canal Abonné utilise des valeurs de clé primaire pour créer des associations DirXML. Ce paramètre indique comment le canal Abonné obtient les valeurs de clé primaire nécessaires pour générer une valeur d'association. Il existe trois possibilités :
Méthode 1 (par défaut) : Par défaut, le pilote suppose que les valeurs de clé primaire sont déjà présentes dans l'événement XML. Si c'est le cas, aucune valeur ne doit être générée. Cela est souhaitable lorsqu'un attribut eDirectory, comme un GUID, est explicitement assigné au schéma de la colonne de clé primaire d'une table ou d'une vue.
La syntaxe de cette première méthode est la suivante : <nomclasse-basedonnées-logique>(NONE)
Exemple :
EMP(NONE)
VIEW_EMP(NONE)
Méthode 2 : Il est souvent souhaitable dans un environnement de test que le canal Abonné génère les valeurs de clé primaire avant qu'une procédure stockée soit disponible. Pour les colonnes de type numérique, le pilote utilise une simple fonction (MAX+1) pour générer des valeurs de clé primaire. Dans le cas de colonnes de type chaîne, le pilote génère une suite aléatoire de caractères alphanumériques. Les autres types de données ne sont pas pris en charge.
La syntaxe de la méthode 2 est la suivante : <nomclasse-basedonnées-logique>(DRIVER)
Exemple :
EMP(DRIVER)
VIEW_EMP(DRIVER)
Méthode 3 : Les valeurs de clé primaire sont tirées d'une procédure stockée ou fonction définie par l'utilisateur.
La syntaxe des procédures stockées est la suivante : <nomclasse-basedonnées-logique>("<signature-procédure-stockée>"), où < signature-procédure-stockée> = <nom-procédure>(nom-colonne>, . . .).
Exemple :
EMP("SP_EMPNO(EMPNO,FNAME)")
VIEW_EMP("SP_EMPNO(PK_EMPNO,FNAME)")
La syntaxe des fonctions est la suivante : <nomclasse-basedonnées-logique>("? = <signature-procédure-stockée>"), où < signature-procédure-stockée> = <nom-procédure>(nom-colonne>, . . .).
Exemple :
EMP("? = SP_EMPNO(EMPNO,FNAME)")
VIEW_EMP("? = SP_EMPNO(PK_EMPNO,FNAME)")
Cette notation assigne une table ou une vue parent à une procédure stockée ou une fonction définie par l'utilisateur. Les noms de colonne sont ceux de la classe de base de données logique qui doit être transmise à la procédure stockée ou fonction. L'ordre, le nombre et le type de données des paramètres doivent correspondre à l'ordre, au nombre et au type de données des paramètres attendus par la procédure. Pour les procédures stockées, les colonnes de clé primaire doivent être transmises comme paramètres IN OUT. Les colonnes sans clé doivent être transmises comme paramètres IN.
Le moment choisi pour la génération de la clé est un paramètre sans distinction majuscules/minuscules, qui est obligatoire pour la plupart des bases de données en cas d'utilisation des méthodes deux et trois de génération de la clé primaire. Ce paramètre est ignoré lorsque la première méthode de génération de la clé primaire est utilisée.
La valeur par défaut est « avant ».
Méthode 2 : Lorsque ce paramètre a la valeur « avant », le pilote exécute une instruction SELECT avant l'insertion d'une ligne dans une table ou vue parent. Lorsque ce paramètre a la valeur « après », le pilote exécute une instruction SELECT après l'insertion d'une ligne dans une table ou vue parent.
Méthode 3 : Avec la valeur « avant », les procédures/fonctions déclarées dans le paramètre « Génération de clé primaire » sont appelées avant l'insertion d'une ligne dans une table ou vue parent. Avec la valeur « après », les procédures/fonctions sont appelées après l'insertion d'une ligne dans une table ou vue parent.
Pour toutes les bases de données, sauf Oracle, la valeur « après » doit être attribuée à ce paramètre. Pour Oracle, il convient d'utiliser la valeur par défaut ou d'omettre ce paramètre.
Vérifier le nombre de mises à jour est un paramètre facultatif sans distinction majuscules/minuscules. Lorsque ce paramètre a la valeur « oui » (par défaut), un décompte des mises à jour est effectué afin de vérifier que la table ou la vue a bien été mise à jour. Si ce paramètre a la valeur « oui » et qu'une table ou une vue n'est pas mise à jour, une erreur est émise. Lorsque ce paramètre a la valeur « non », le nombre de mises à jour n'est pas vérifié. La valeur « non » doit être attribuée à ce paramètre lorsque des instructions sont redéfinies avant la logique de déclencheur dans une table ou à la place de cette logique dans une vue.
Avec le pilote BEA Weblogic jDriver pour Microsoft SQL Server 7/2000, il est sans doute préférable d'utiliser la valeur par défaut car les erreurs contenues dans la logique de déclencheur (qui peuvent entraîner la restauration d'une transaction) ne sont pas toujours répercutées sur le pilote.
Le tableau suivant liste les paramètres de l'objet Éditeur, avec leurs valeurs par défaut et des exemples de configuration :
Désactiver est un paramètre facultatif, sans distinction majuscules/minuscules, qui indique si le canal Éditeur doit rechercher des événements de base de données. Lorsque ce paramètre a la valeur « oui », le canal Éditeur n'établit pas de connexion avec une base de données et n'interroge pas la table de consignation des événements. Lorsque ce paramètre a la valeur « non » (par défaut), le canal Éditeur se connecte à la base de données et interroge la table de consignation des événements.
Le nom de la table de consignation est un paramètre obligatoire avec distinction possible majuscules/minuscules sur certaines bases de données. Ce paramètre indique le nom de la table dans laquelle les événements de base de données sont stockés en vue de leur acheminement via le canal Éditeur. Cette valeur ne peut pas être délimitée.
L'intervalle d'interrogation est un paramètre facultatif, sans distinction majuscules/minuscules, qui indique la fréquence en secondes à laquelle l'objet Éditeur doit rechercher des événements dans la table de consignation. La valeur par défaut est 10 secondes.
Il est recommandé de ne pas définir de valeur inférieure à dix secondes.
L'intervalle de reconnexion est un paramètre facultatif, sans distinction majuscules/minuscules, qui indique la fréquence en secondes à laquelle l'objet Éditeur doit tenter de se reconnecter à la base de données cible. La valeur par défaut est 30 secondes.
Il est recommandé de ne pas définir de valeur inférieure à dix secondes.
Ce paramètre facultatif, sans distinction majuscules/minuscules, indique si le canal Éditeur doit ou non ignorer les événements de type 2 qui contiennent les mêmes valeurs anciennes et nouvelles. Cette option est utile si les déclencheurs du canal Éditeur ne sont pas optimisés. L'égalité est déterminée par une opération de comparaison de chaînes avec distinction majuscules/minuscules. Les valeurs vides sont considérées comme égales. La valeur par défaut est « non ».
Ce paramètre facultatif, sans distinction majuscules/minuscules, indique si le canal Éditeur doit supprimer ou non les enregistrements traités de la table de consignation des événements. Lorsque ce paramètre a la valeur « non », le canal Éditeur ne supprime pas les lignes traitées de la table. En revanche, il traite le champ STATUS d'une ligne en y indiquant l'état « S » (Réussi). Les lignes dont le traitement échoue restent dans la table de consignation des événements quelle que soit la valeur de ce paramètre. La valeur par défaut est « oui ».
La valeur « oui » ne doit être attribuée à ce paramètre qu'à des fins de débogage. La valeur « oui » de ce paramètre entraîne un ralentissement des performances d'acheminement via le canal Éditeur. Si une fonction d'audit est souhaitée dans un environnement de production, les lignes insérées dans la table de consignation des événements en vue de leur acheminement via le canal Éditeur doivent être écrites dans une table miroir.
| |