Paramètres du pilote. Novell Pilote DirXML pour JDBC

Novell Confidential Manual (FRA) 28 October 2003

Paramètres du pilote

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 catégories :

Š Pilote

Š Abonné

Š Éditeur

Configuration du pilote

1

2

3

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 :

Nom du paramètre

Nom de classe du pilote JDBC tiers

Synchroniser le schéma

Synchroniser la ou les tables

Réutiliser les instructions ?

Utiliser les transactions manuelles ?

Utiliser la connexion simple ?

Niveau d’isolation de transaction par défaut

Nom de classe du testeur de connexion

Instruction de test de la connexion

Exemple de valeur de configuration Valeur par défaut Obligatoire Balise

oracle.jdbc.driver.OracleDriver

dirxml oui oui

<jdbc-class>

<sync-schema> emp oui oui non lecture validée com.novell.nds.dirxml.driver.jdbc

.util.JDBCConnectionTester

Récupérer les métadonnées minimales ?

Gérer les résultats des instructions ?

oui

SELECT empno FROM dirxml.emp where -1 = 0 non

Chaîne d’initialisation de la connexion USE dirxml

Enable Referential Support (Activer la prise en charge des référentiels) ?

oui oui

(déterminée dynamiquement) non

(idem)

(idem) non oui oui oui non non non non non non non non non non

<sync-tables>

<reusestatements>

<use-manualtransactions>

<use-singleconnection>

<transactionisolation-level>

<connectiontester-class>

<connection-teststmt>

<minimalmetadata>

<handle-stmtresults>

<connection-init>

<enable-refs>

Configuration du pilote

37

Novell Confidential Manual (FRA) 28 October 2003

Nom de classe du pilote JDBC tiers

Le nom de classe du pilote JDBC tiers est un paramètre obligatoire avec distinction majuscules/ minuscules. Ce nom fait référence au nom qualifié complet de la classe de votre pilote tiers. Le tableau suivant répertorie le nom de classe pour les pilotes de fabricants tiers testés.

Pilote de fabricant tiers

Pilotes JDBC Oracle8i, 9i

Valeur

oracle.jdbc.driver.OracleDriver

Pilote JDBC IBM DB2 UDB

BEA Weblogic jDriver pour MSSQL

Server 7/2000

COM.ibm.db2.jdbc.net.DB2Driver

weblogic.jdbc.mssqlserver4.Driver

Pilote Microsoft SQL Server 2000 pour

JDBC com.microsoft.jdbc.sqlserver.SQLServerDriver

Sybase jConnect 5.5

MySQL Connector/J

Pilote JDBC Informix

Pilote JDBC-ODBC Sun com.sybase.jdbc2.jdbc.SybDriver

org.gjt.mm.mysql.Driver

com.informix.jdbc.IfxDriver

sun.jdbc.odbc.JdbcOdbcDriver

Synchroniser le schéma

Synchroniser le schéma est un paramètre obligatoire avec distinction possible majuscules/ minuscules. Ce paramètre identifie le 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

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 classes de base de données logiques à synchroniser. Les noms de classes de base de données logiques sont les noms des tables et des vues parent. C’est une erreur de lister les noms de tables enfant. 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. Si vous synchronisez deux tables ou vues avec les mêmes noms dans différents schémas, assurez-vous de préfixer la table avec le schéma ou d’afficher les noms dans la règle d’assignation de schéma. Le pilote ne préfixe pas la table avec le schéma ou n’affiche pas les noms renvoyés par l’opération getSchema() par défaut. 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.

38

DirXML Driver for JDBC Implementation Guide (Guide d’implémentation du pilote DirXML pour JDBC)

Novell Confidential Manual (FRA) 28 October 2003

Réutiliser les instructions ?

Réutiliser les instructions est un paramètre sans distinction majuscules/minuscules qui peut être obligatoire pour certains pilotes tiers. 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.

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.

Utiliser les transactions manuelles ?

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, nous vous recommandons d’omettre ce paramètre de la plupart des configurations de pilote.

Utiliser la connexion simple ?

Utiliser la connexion simple est un paramètre sans distinction majuscules/minuscules qui peut être obligatoire pour certains pilotes tiers. 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 définition de ce paramètre sur oui réduit les performances du pilote. Ce paramètre ne doit être défini sur oui que lorsque les deux 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.

Niveau d’isolation de transaction par défaut

Niveau d’isolation de transaction par défaut est un paramètre facultatif sans distinction majuscules/minuscules. Ce paramètre définit le niveau d’isolation de transaction par défaut pour les connexions utilisées par le pilote. Il existe cinq valeurs possibles, dont quatre correspondent aux constantes publiques définies dans l’interface java.sql.Connection :

Š aucune

Š lecture non validée

Š lecture validée

Š lecture renouvelée

Š sérialisable

Configuration du pilote

39

Novell Confidential Manual (FRA) 28 October 2003

La valeur par défaut est lecture validée

. Nous vous recommandons 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 (http://java.sun.com) .

É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

.

Instruction de test de la connexion

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.

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 ?

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. 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. Reportez-vous à

Annexe D, « Méthodes java.sql.DatabaseMetaData », page 91 pour

consulter une liste supplémentaire de 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.

Définissez cette valeur sur oui pour améliorer le temps de démarrage du pilote au détriment de son fonctionnement.

40

DirXML Driver for JDBC Implementation Guide (Guide d’implémentation du pilote DirXML pour JDBC)

Novell Confidential Manual (FRA) 28 October 2003

Gérer les résultats des instructions ?

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 arbitraire. Trois valeurs sont possibles :

Š aucune

Š unique

Š multiple

La valeur par défaut est multiple

. Pour la compatibilité en amont, oui

est égal à multiplenon

est égal à aucune

.

Pour le pilote ODBC de Microsoft, Oracle ou Informix, vous devez attribuer la valeur single

à ce paramètre. Pour les autres pilotes tiers, nous vous recommandons d’utiliser la valeur par défaut ou d’omettre ce paramètre de la plupart des configurations de pilote.

Chaîne d’initialisation de la connexion

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. Vous devez 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.

Enable Referential Support (Activer la prise en charge des référentiels) ?

Enable referential support (Activer la prise en charge des référentiels) est un paramètre facultatif sans distinction majuscules/minuscules. Ce paramètre indique au pilote d’interpréter les contraintes de clé étrangère qui font référence aux tables parent d’autres classes de base de données en tant qu’attributs référentiels. Les attributs référentiels servent généralement à désigner un endiguement (par exemple, l’appartenance à un groupe). Lorsque la valeur oui (par défaut) est définie pour ce paramètre, le pilote interprète lesdites colonnes en tant que référentiels. Lorsque la valeur non est définie pour ce paramètre, le pilote interprète lesdites colonnes en tant que non-référentiels. L’objectif de ce paramètre est de garantir la compatibilité en amont avec la version 1.0 de ce pilote. Pour une compatibilité avec la version 1.0, ce paramètre doit avoir la valeur non.

Configuration de l’objet Abonné

Le tableau suivant dresse la liste des paramètres avec des exemples de valeurs.

Nom du paramètre Exemple de valeur de configuration Valeur par défaut

Obligatoire Balise

non non non

<disable>

<key-gen>

Désactiver

Génération de clé primaire

Moment choisi pour la génération de la clé

Vérifier le nombre de mises à jour ?

oui emp("sp_empno(empno,fname)") après oui avant oui non non

<key-gentiming>

<checkupdatecount>

Configuration du pilote

41

Novell Confidential Manual (FRA) 28 October 2003

Désactiver

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.

Génération de clé primaire

La génération de clé primaire est un paramètre facultatif et complexe 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 d’

<ajout>

, le canal Abonné utilise des valeurs de clé primaire pour créer des associations. Ce paramètre indique comment le canal Abonné obtient les valeurs de clé primaire nécessaires pour générer des valeurs d’association. Il existe trois possibilités :

1. Les valeurs de clé primaire nécessaires sont déjà présentes dans l’événement XML.

2. Le canal Abonné doit générer les valeurs de clé primaire nécessaires.

3. Le canal Abonné doit se procurer ces valeurs en appelant une procédure stockée ou une fonction définie par l’utilisateur dans la base de données.

Méthode 1 : 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 la méthode 1 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 ou une fonction soit disponible. Cette méthode peut également être utilisée avec des bases de données qui ne prennent pas en charge les procédures ou les fonctions stockées. Pour les colonnes de type numérique, le pilote utilise une fonction simple (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, . . .).

42

DirXML Driver for JDBC Implementation Guide (Guide d’implémentation du pilote DirXML pour JDBC)

Novell Confidential Manual (FRA) 28 October 2003

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-

fonction"), où signature-fonction = nom-fonction(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 ou fonction. 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.

Remarques supplémentaires sur la génération de la clé primaire

Š Dans le cas de la première méthode, il convient d’assigner au schéma d’une colonne de clé primaire le GUID au lieu du CN.

Š Avec la troisième méthode, les colonnes de clé primaire ne doivent pas être assignées au schéma, ni incluses dans les filtres Abonné ou Éditeur.

Š Lors de la synchronisation de plusieurs classes, une méthode de génération de clé primaire doit être déclarée pour chaque classe de base de données logique. Les valeurs doivent être séparées par des espaces ou des virgules.

Moment choisi pour la génération de la clé

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.

Deux valeurs sont possibles :

Š avant

Š après

La valeur par défaut est avant

.

Méthode 1 de génération de clé primaire : ce paramètre est ignoré.

Méthode 2 de génération de clé primaire : 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 de génération de clé primaire : avec la valeur avant, les procédures ou 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 ou 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.

Configuration du pilote

43

Novell Confidential Manual (FRA) 28 October 2003

Vérifier le nombre de mises à jour ?

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 lors de l’insertion, la mise à jour ou la suppression de lignes dans une table ou une vue, l’opération en question a bien été effectuée. Si ce paramètre a la valeur oui

et que des lignes ne sont pas mises à 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.

Lorsque vous effectuez une synchronisation avec Microsoft SQL Server, il est 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 l’abonné.

Configuration de l’objet Éditeur

Le tableau suivant répertorie les paramètres de l’objet Éditeur, avec leurs valeurs par défaut et des exemples de configuration :

Nom du paramètre

Désactiver

Nom de la table de consignation

Intervalle d’interrogation (en secondes)

Intervalle de reconnexion (en secondes)

Exemple de valeur de configuration

Valeur par défaut

oui non eventlog

1-604800

(1 semaine)

Optimiser les mises à jour

Supprimer du journal oui oui

Autoriser le retour en boucle ?

oui

10

1-3600 (1 heure) 30 non oui non

Obligatoi re

Balise

non oui

<disable>

<log-table> non non non non non

<polling-interval>

<reconnect-interval>

<optimize-update>

<delete-from-log>

<check-updatecount>

Désactiver

Désactiver est un paramètre facultatif, sans distinction majuscules/minuscules, qui indique si le canal Éditeur doit ouvrir une connexion à la base de données et rechercher des événements de base de données dans la table de consignation des événements. 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.

Nom de la table de consignation

Le nom de la table de consignation est un paramètre obligatoire avec distinction possible majuscules/minuscules. 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 doit pas être délimitée.

44

DirXML Driver for JDBC Implementation Guide (Guide d’implémentation du pilote DirXML pour JDBC)