Assignation de schéma. Novell Pilote DirXML pour JDBC

PDF

Documento

Novell Confidential Manual (FRA) 28 October 2003

Configuration avancée du pilote

Après avoir installé un exemple de script de préconfiguration et de base de données, vous devez personnaliser le pilote pour une utilisation spécialisée. Cette section présente des concepts importants, des exemples de configurations et d’autres informations qui vous aideront à configurer le pilote.

« Assignation de schéma », page 47

« Table de consignation des événements », page 58

« Assignation d’événements », page 57

« Utilisation du langage SQL dans des événements XML », page 65

Assignation de schéma

Le tableau suivant présente une vue générale du mode d’assignation d’objets eDirectory Novell à des objets de base de données par le pilote.

Objet eDirectory

Arborescence

Classe

Attribut

Association

Objet Base de données

Schéma

Table/Vue

Colonne

Clé primaire

Classes de base de données logiques

Par classe de base de données logique, on entend l’ensemble des tables ou des vues utilisées pour représenter une classe eDirectory dans une base de données. Une classe de base de données logique peut se composer d’une vue unique ou d’une table parent et de zéro ou plusieurs tables enfant. Le nom de la classe de base de données logique est le nom de la table ou vue parent.

Synchronisation indirecte

Dans un modèle de synchronisation indirecte, le pilote procède aux assignations suivantes :

Objet eDirectory

Classes

Attributs

Objet Base de données

Tables

Colonnes

Configuration avancée du pilote

Novell Confidential Manual (FRA) 28 October 2003

Objet eDirectory

1 classe

Attribut à valeur unique

Attribut à valeurs multiples

Objet Base de données

1 table parent et

0 ou plus tables enfant

Colonne de la table parent

Colonne de la table parent ou

Colonne de la table enfant (préférée)

Assignation de classes eDirectory à des classes de base de données logiques

Dans l’exemple suivant, la classe de base de données logique emp

se compose d’une table parent emp

et d’une table enfant phone

. La classe logique emp

est assignée à la classe eDirectory

Utilisateur.

CREATE TABLE dirxml.emp

(

empno NUMERIC(8) NOT NULL,

fname VARCHAR(64),

lname VARCHAR(64),

pwdminlen NUMERIC(4),

CONSTRAINT pk_emp_empno PRIMARY KEY(empno)

);

CREATE TABLE dirxml.phone

(

empno NUMERIC(8) NOT NULL,

phone VARCHAR(64) NOT NULL,

CONSTRAINT fk_phone_empno FOREIGN KEY(empno) REFERENCES

emp(empno)

);

<attr-name-map>

<class-name>

<nds-name>User</nds-name>

<app-name>emp</app-name>

</class-name>

<attr-name class-name="User">

<nds-name>Given Name</nds-name>

<app-name>fname</app-name>

</attr-name>

<attr-name class-name="User">

<nds-name>Surname</nds-name>

<app-name>lname</app-name>

</attr-name>

<attr-name class-name="User">

<nds-name>Password Minimum Length</nds-name>

<app-name>pwdminlen</app-name>

</attr-name>

<attr-name class-name="User">

<nds-name>Telephone Number</nds-name>

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

Novell Confidential Manual (FRA) 28 October 2003

<app-name>phone.phoneno</app-name>

</attr-name>

</attr-name-map>

</rule>

Tables parent

Les tables parent sont des tables assorties d’une contrainte de clé primaire explicite qui contiennent une ou plusieurs colonnes. Dans une table parent, une contrainte de clé primaire explicite est requise pour indiquer au pilote les champs à inclure dans une valeur d’association.

CREATE TABLE dirxml.emp

(

empno NUMERIC(8) NOT NULL,

...

CONSTRAINT pk_emp_empno PRIMARY KEY(empno)

);

Le tableau suivant contient des exemples de données pour dirxml.emp

empno

fname

Jean

lname

Untel

L’association résultante pour cette ligne serait la suivante : empno=1,table=emp,schema=dirxml

Remarque : le sort des identificateurs de base de données dans les valeurs d’association est déterminé de manière dynamique lors de l’exécution, à partir des métadonnées de base de données.

Colonnes de la table parent

Les colonnes de table parent ne peuvent contenir qu’une valeur. À ce titre, elles conviennent parfaitement pour l’assignation d’attributs eDirectory à valeur unique. Ainsi, l’attribut eDirectory

à valeur unique Password Minimum Length (longueur minimale du mot de passe) serait assigné à la colonne de table parent pwdminlen

Les colonnes de table parent sont préfixées, de manière implicite, avec le nom de la table parent.

Il n’est pas nécessaire de préfixer explicitement les colonnes de table parent. Ainsi, emp.fname

est l’équivalent de fname

à des fins d’assignation de schéma.

<attr-name-map>

<class-name>

<nds-name>User</nds-name>

<app-name>emp</app-name>

</class-name>

<attr-name class-name="User">

<nds-name>Given Name</nds-name>

<app-name>fname</app-name>

</attr-name>

</attr-name-map>

</rule>

Configuration avancée du pilote

Novell Confidential Manual (FRA) 28 October 2003

Tables enfant

Les données de type binaire et chaîne en grande quantité doivent en principe être assignées à des colonnes de table parent. Pour être assigné à une colonne de table enfant, un type de données doit pouvoir faire l’objet d’une comparaison dans une instruction SQL. Or, les types de données en grande quantité ne peuvent généralement pas être comparés dans des instructions SQL.

Les données de type binaire et chaîne en grande quantité peuvent être assignées à des colonnes de table enfant si les événements

<remove-value>

de ces types comprennent des éléments

<remove-all-values>

qui sont transformés dans les feuilles de style en éléments

, à raison d’un élément par valeur ajoutée.

Une table enfant est une table qui comporte une contrainte de clé étrangère sur la clé primaire de sa table parent, ce qui relie les deux tables entre elles. Les colonnes qui composent la clé étrangère de la table enfant doivent porter le même nom que les colonnes contenues dans la clé primaire de la table parent. Ce nom de colonne commun est utilisé par le canal Éditeur pour identifier toutes les lignes de la table de consignation des événements qui se rapportent à une classe de base de données logique unique.

L’exemple suivant illustre la relation qui existe entre la table parent emp

et sa table enfant phone

Notez que le même nom de colonne empno

est utilisé dans les deux tables.

CREATE TABLE dirxml.emp

(

empno NUMERIC(8) NOT NULL,

...

CONSTRAINT pk_emp_empno PRIMARY KEY(empno)

);

CREATE TABLE dirxml.phone

(

empno NUMERIC(8) NOT NULL,

phoneno VARCHAR(64) NOT NULL,

CONSTRAINT fk_phone_empno FOREIGN KEY(empno) REFERENCES

emp(empno)

);

La colonne contrainte dans une table enfant identifie la table parent. Dans l’exemple ci-dessus, la colonne contrainte dans la table enfant phone

est empno

. Le seul objectif de cette colonne est de relier les tables phone

et emp

. Dans la mesure où les colonnes contraintes ne contiennent pas d’informations utiles, elles doivent être omises des déclencheurs de publication et de la règle d’assignation de schéma.

La colonne non-contrainte est celle qui nous intéresse. Elle représente un seul attribut à valeurs multiples. Dans l’exemple ci-dessus, la colonne non-contrainte est phoneno

. Comme les colonnes non-contraintes peuvent contenir plusieurs valeurs, elles conviennent donc parfaitement

à l’assignation d’attributs eDirectory à valeurs multiples. Par exemple, l’assignation de l’attribut eDirectory à valeurs multiples Telephone Number à phone.phoneno

Toutes les colonnes d’une table enfant doivent être contraintes NOT NULL.

Remarque : différente. chaque attribut eDirectory à valeurs multiples doit être assigné à une colonne de table enfant

Le tableau suivant contient des exemples de données pour dirxml.phone

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

Novell Confidential Manual (FRA) 28 October 2003

empno

phoneno

111-1111

222-2222

En cas d’assignation d’un attribut eDirectory à valeurs multiples à une colonne de table enfant, le nom de cette dernière doit être précédé de manière explicite du nom de la table enfant (par exemple, phone.phoneno

). Sinon, le pilote interprétera implicitement phoneno

en tant que emp.phoneno

, et pas phone.phoneno

<attr-name-map>

<class-name>

<nds-name>User</nds-name>

<app-name>emp</app-name>

</class-name>

<attr-name class-name="User">

<nds-name>Telephone Number</nds-name>

<app-name>phone.phoneno</app-name>

</attr-name>

</attr-name-map>

</rule>

Attributs référentiels

L’endiguement référentiel peut être représenté dans la base de données grâce à l’utilisation de contraintes de clé étrangère. Les attributs référentiels sont des colonnes au sein d’une classe de base de données logique qui font référence aux colonnes de clé primaire des tables parent d’autres classes de base de données logiques.

Attributs référentiels à valeur unique

Deux tables parent peuvent être mises en relation grâce à une colonne unique de table parent. Cette colonne doit avoir une contrainte de clé étrangère qui pointe sur la clé primaire de l’autre table parent. L’exemple suivant met en relation une table parent unique utilisateur

avec elle-même.

CREATE TABLE user

(

idu NUMBER(8) NOT NULL,

manager NUMBER(8),

CONSTRAINT pk_user_idu PRIMARY KEY(idu),

CONSTRAINT fk_user_idu FOREIGN KEY(manager)REFERENCES

user(idu)

);

<attr-name-map>

<class-name>

<nds-name>User</nds-name>

<app-name>user</app-name>

</class-name>

<attr-name class-name="User">

<nds-name>manager</nds-name>

Configuration avancée du pilote

Novell Confidential Manual (FRA) 28 October 2003

<app-name>manager</app-name>

</attr-name>

</attr-name-map>

</rule>

Les colonnes référentielles à valeur unique doivent pouvoir être égales à NULL.

Attributs référentiels à valeurs multiples

Deux tables parent peuvent être mises en relation grâce à une table enfant commune. Cette table enfant doit avoir une contrainte de clé étrangère qui pointe sur la clé primaire de chaque table parent. L’exemple suivant met en relation deux tables parent utilisateur

et groupe

par l’intermédiaire d’une table enfant commune membre

CREATE TABLE user

(

idu NUMBER(8) NOT NULL,

lname VARCHAR(64) NOT NULL,

CONSTRAINT pk_user_idu PRIMARY KEY(idu)

);

CREATE TABLE group

(

idg NUMBER(8) NOT NULL,

CONSTRAINT pk_group_idg PRIMARY KEY(idg)

);

CREATE TABLE member

(

idg NUMBER(8)NOT NULL,

idu NUMBER(8)NOT NULL,

CONSTRAINT fk_member_idg FOREIGN KEY(idg) REFERENCES

group(idg),

CONSTRAINT fk_member_idu FOREIGN KEY(idu) REFERENCES

user(idu)

);

<attr-name-map>

<class-name>

<nds-name>User</nds-name>

<app-name>user</app-name>

</class-name>

<attr-name class-name="User">

<nds-name>Surname</nds-name>

<app-name>lname</app-name>

</attr-name>

<class-name>

<nds-name>Group</nds-name>

<app-name>group</app-name>

</class-name>

<attr-name class-name="Group">

<nds-name>Member</nds-name>

<app-name>member.idu</app-name>

</attr-name>

</attr-name-map>

</rule>

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

Novell Confidential Manual (FRA) 28 October 2003

La première colonne contrainte dans une table enfant détermine la propriété. Dans l’exemple ci-dessus, membre

est considéré comme faisant partie de la classe groupe

. membre

est considéré comme étant un enfant propre de groupe

. La deuxième colonne contrainte dans une table enfant est l’attribut référentiel à valeurs multiples. Les deux colonnes doivent être contraintes

NOT NULL.

Dans l’exemple suivant, l’ordre des colonnes contraintes a été inversé pour que membre

soit une partie d’ utilisateur

. Pour mieux refléter cette relation, membre

a été renommée membre_de

CREATE TABLE user

(

idu NUMBER(8) NOT NULL,

lname VARCHAR(64) NOT NULL,

CONSTRAINT pk_user_idu PRIMARY KEY(idu)

);

CREATE TABLE group

(

idg NUMBER(8) NOT NULL,

CONSTRAINT pk_group_idg PRIMARY KEY(idg)

);

CREATE TABLE member_of

(

idu NUMBER(8)NOT NULL,

idg NUMBER(8)NOT NULL,

CONSTRAINT fk_member_idg FOREIGN KEY(idg) REFERENCES

group(idg),

CONSTRAINT fk_member_idu FOREIGN KEY(idu) REFERENCES

user(idu)

);

<attr-name-map>

<class-name>

<nds-name>User</nds-name>

<app-name>user</app-name>

</class-name>

<attr-name class-name="User">

<nds-name>Surname</nds-name>

<app-name>lname</app-name>

</attr-name>

<attr-name class-name="User">

<nds-name>Group Membership</nds-name>

<app-name>member_of.idg</app-name>

</attr-name>

<class-name>

<nds-name>Group</nds-name>

<app-name>group</app-name>

</class-name>

</attr-name-map>

</rule>

Configuration avancée du pilote

Novell Confidential Manual (FRA) 28 October 2003

Dans les bases de données dans lesquelles la position n’a aucune importance, l’ordre est déterminé par comparaison lexicographique.

En général, il est seulement nécessaire de synchroniser les attributs référentiels à valeurs multiples dans l’une ou l’autre classe, pas dans les deux. Pour synchroniser les attributs référentiels des deux classes, il faudrait construire deux tables enfant, une par classe. Si par exemple vous souhaitiez synchroniser Adhésion au groupe et Membre, vous auriez besoin de deux tables enfant : membre_de

et membre

En pratique, pour la synchronisation des objets Utilisateur et Groupe, nous vous recommandons de synchroniser l’attribut Adhésion au groupe de la classe Utilisateur au lieu de l’attribut Membre de la classe Groupe. Lorsque vous synchronisez Membre, des événements sont générés pour les utilisateurs non associés qui sont ajoutés à des groupes associés. Lorsque vous synchronisez

Adhésion au groupe, des événements ne sont générés que pour les utilisateurs associés qui sont ajoutés à des groupes associés.

Synchronisation directe

Dans un modèle de synchronisation directe, le pilote procède aux assignations suivantes :

Objet eDirectory

Classes

Attributs

1 classe

Attribut à valeur unique

Attribut à valeurs multiples

Objet Base de données

Vues

Afficher les colonnes

Vue

Afficher la colonne

Une vue est une table logique. Contrairement aux tables parent ou enfant, elle n’existe pas physiquement dans la base de données. En tant que telles, les vues ne peuvent pas comporter de contraintes de clé primaire/clé étrangère. Pour indiquer au pilote les champs à utiliser lors de la génération de valeurs d’association, une ou plusieurs colonnes de vue doivent porter le préfixe pk_

(sans distinction majuscules/minuscules).

Remarque : les vues doivent être construites de telle sorte que les colonnes dotées du préfixe pk_

identifient une ligne de façon unique.

Les fonctionnalités de mise à jour des vues sont très variables selon les bases de données. La plupart des bases permettent une mise à jour des vues dans certaines conditions. Si les vues sont strictement en lecture seule, il est impossible de les utiliser pour l’acheminement des données via le canal Abonné. Sous Microsoft SQL Server 2000 et Oracle 8i et 9i, il est possible de définir une logique de mise à jour sur les vues dans instead-of-triggers, ce qui permet à une vue de joindre plusieurs tables tout en restant modifiable.

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

Novell Confidential Manual (FRA) 28 October 2003

CREATE TABLE dirxml.emp

(

empno NUMERIC(8) NOT NULL UNIQUE,

fname VARCHAR(64),

lname VARCHAR(64),

pwdminlen NUMERIC(4),

phoneno VARCHAR(64)

);

CREATE VIEW dirxml.view_emp

(pk_empno, fname, lname, pwdminlen, phoneno)

SELECT empno, fname, lname, pwdminlen, phoneno FROM dirxml.emp;

<attr-name-map>

<class-name>

<nds-name>User</nds-name>

<app-name>view_emp</app-name>

</class-name>

<attr-name class-name="User">

<nds-name>Given Name</nds-name>

<app-name>fname</app-name>

</attr-name>

<attr-name class-name="User">

<nds-name>Surname</nds-name>

<app-name>lname</app-name>

</attr-name>

<attr-name class-name="User">

<nds-name>Password Minimum Length</nds-name>

<app-name>pwdminlen</app-name>

</attr-name>

<attr-name class-name="User">

<nds-name>Telephone Number</nds-name>

<app-name>phoneno</app-name>

</attr-name>

</attr-name-map>

</rule>

Synchronisation des colonnes de clé primaire

Quand la base de données est la source experte de colonnes de clé primaire, celles-ci doivent généralement être omises des filtres Éditeur et Abonné, de la règle d’assignation de schéma et des déclencheurs de publication.

Quand eDirectory est la source experte de colonnes de clé primaire, celles-ci doivent généralement

être incluses dans le filtre Abonné et la règle d’assignation de schéma et omises du filtre Éditeur et des déclencheurs de publication. Il est également recommandé d’utiliser GUID plutôt que CN comme clé primaire. CN est à valeurs multiples et peut être modifié. GUID est à valeur unique et statique.

Configuration avancée du pilote

Novell Confidential Manual (FRA) 28 October 2003

Synchronisation de plusieurs classes

Lors de la synchronisation de plusieurs classes eDirectory, il est nécessaire de synchroniser chaque classe avec une table ou une vue parent différente. Chaque classe de base de données logique doit avoir un nom de colonne de clé primaire unique. Ce nom de colonne commun est utilisé par le canal Éditeur pour identifier toutes les lignes de la table de consignation des événements qui se rapportent à une classe de base de données logique unique. Ainsi, les classes de base de données logique utilisateur

et groupe

ont chacune un nom de colonne de clé primaire unique.

CREATE TABLE user

(

idu NUMBER(8) NOT NULL,

lname VARCHAR(64) NOT NULL,

CONSTRAINT pk_user_idu PRIMARY KEY(idu)

);

CREATE TABLE group

(

idg NUMBER(8) NOT NULL,

CONSTRAINT pk_group_idg PRIMARY KEY(idg)

);

Assignation d’attributs à valeurs multiples à des champs de base de données à valeur unique

Par défaut, le pilote suppose que tous les attributs eDirectory assignés aux colonnes d’une table parent ou d’une vue sont à valeur unique. Comme le pilote ne reconnaît pas le schéma eDirectory, il n’a aucun moyen de savoir si un attribut eDirectory est à valeur unique ou à valeurs multiples.

Par conséquent, les assignations d’attributs à valeur unique et à valeurs multiples sont traitées de la même manière.

Le pilote met en oeuvre l’algorithme MRT (Most Recently Touched - Modifié en dernier) vis-àvis des colonnes de table parent ou de vue à valeur unique. Un algorithme MRT garantit le stockage dans la base de données de la valeur d’attribut ajoutée ou supprimée en dernier. Cet algorithme fonctionne si l’attribut en question est à valeur unique et a des effets indésirables si l’attribut comporte plusieurs valeurs.

Lorsqu’une valeur est supprimée d’un attribut à valeurs multiples, le champ de base de données auquel elle est assignée sera défini comme vide (NULL) et le restera jusqu’à l’ajout d’une nouvelle valeur. Plusieurs solutions à ce comportement indésirable sont exposées ci-après.

La solution préférée consiste à élargir le schéma eDirectory afin que seuls des attributs à valeur unique soient assignés aux colonnes de table parent ou de vue.

Pour une synchronisation indirecte, assignez chaque attribut à valeurs multiples à sa propre table enfant.

Pour la synchronisation directe ou indirecte, utilisez des feuilles de style pour déterminer plusieurs valeurs avant de les insérer dans une colonne de table parent ou de vue.

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