Extension XML - Assistant d'administration - Aide
Connexion à une base de données
Utilisation du tableau de bord Administration de l'Extension XML
Zones et éléments de contrôle
Tâches
Activation ou désactivation d'une base de données
Tâche : Activation d'une base de données
Tâche : Désactivation d'une base de données
Importation de DTD
Zones et éléments de contrôle
Tâche : Importation d'une DTD
Utilisation des fichiers DAD
Zones et éléments de contrôle
Spécification d'une DAD - Etape 1 pour tous les types
Sélection de la validation - Etape 2 pour tous les types
Tables annexes - Etape 3 pour le type colonne XML
Spécification de texte- Etape 3 pour le type mappage du noeud RDB ou mappage SQL
Spécification d'une instruction SQL - Etape 4 pour le type mappage SQL
Mappage de SQL- Etape 5 pour le type mappage SQL
Mappage de noeuds RDB - Etape 4 pour le type mappage du noeud RDB
Sauvegarde d'une DAD - Dernière étape pour tous les types
Tâches
Création ou édition d'une DAD pour colonnes XML
Création ou édition d'une DAD pour collections XML
Utilisation des colonnes XML
Zones et éléments de contrôle
Sélection d'une tâche (pour les colonnes)
Ajout d'une colonne XML
Activation d'une colonne XML
Désactivation d'une colonne XML
Tâches
Ajout d'une colonne XML
Activation d'une colonne XML
Désactivation d'une colonne XML
Utilisation des collections XML
Zones et éléments de contrôle
Sélection d'une tâche (pour les collections)
Activation d'une collection XML
Désactivation d'une collection XML
Tâches
Activation d'une collection XML
Désactivation d'une collection XML
A partir de cet assistant, vous pouvez vous connecter à la base de données
qui contient ou contiendra des données XML.
- Adresse
- Tapez le nom de la base de données JDBC à laquelle vous voulez vous
connecter, ou sélectionnez une adresse dans la liste. Dans cette base de
données, l'assistant exécute des tâches en temps réel. Si
vous avez recours à la liste, les derniers ID utilisateur et pilote JDBC
associés à l'adresse sélectionnée s'affichent dans les zones ci-après.
Cette zone est
obligatoire. La syntaxe de cette adresse est la suivante :
|Pour les configurations autonomes (recommandé) :
jdbc:db2:nom_bd
Où :
- nom_bd
- Représente le nom de la base de données à
laquelle vous vous connectez et qui contient les documents XML.
Par exemple :
jdbc:db2:sales_db
Pour les configurations de réseau :
jdbc:db2://|hôte:numéro_port/nom_bd
Où :
- |hôte
- |Représente le nom du serveur sur lequel se situe l'Extension XML.
- numéro_port
- Représente le numéro de port utilisé
pour la connexion au serveur.
Pour le connaître, tapez la commande suivante sur la ligne de commande DB2
du poste serveur :
db2jstrt port#
- nom_bd
- Représente le nom de la base de données à
laquelle vous vous connectez et qui contient les documents XML.
Par exemple :
jdbc:db2://host1.ibm.com/sales_db
- ID utilisateur
- Tapez ou confirmez l'ID utilisateur sous lequel vous avez accédé à la base de données. Cette zone est
obligatoire.
- Mot de passe
- Tapez le mot de passe sous lequel vous avez accédé à la base de données. Cette zone est
obligatoire.
- Pilote JDBC
- Tapez ou confirmez l'emplacement du pilote associé à la base de données. Cette zone est
obligatoire. Le pilote doit correspondre à l'une des valeurs suivantes :
|Pour les configurations autonomes (par défaut) :
COM.ibm.db2.jdbc.app.DB2Driver
Pour les configurations de réseau :
COM.ibm.db2.jdbc.net.DB2Driver
- Fin
- Termine l'opération de connexion à une base de données et ouvre le tableau de bord.
- Annulation
- Annule l'assistant.
Lorsque vous démarrez l'assistant d'administration de l'Extension XML,
la fenêtre d'ouverture de session s'affiche et vous vous connectez à une base de données.
- Dans la zone Adresse, entrez l'adresse JDBC qualifiée
complète de la source de données IBM DB2 UDB à laquelle vous voulez vous
connecter.
- Dans les zones ID util et Mot de passe, entrez ou
confirmez l'ID utilisateur et le mot de passe DB2 d'accès à la base de
données à laquelle vous voulez vous connecter.
- Dans la zone Pilote JDBC, tapez ou confirmez le nom du pilote JDBC pour l'adresse indiquée.
- Cliquez sur Fin pour vous connecter à la base de données et passer au tableau de bord.
- A partir du tableau de bord, cliquez sur Changement de base de données.
- Dans la zone Adresse, entrez l'adresse JDBC qualifiée
complète de la source de données IBM DB2 UDB à laquelle vous voulez vous
connecter.
- Dans les zones ID util et Mot de passe, tapez ou
confirmez l'ID utilisateur et le mot de passe DB2 d'accès à la base de
données à laquelle vous voulez vous connecter.
- Dans la zone Pilote JDBC, tapez ou confirmez le nom du pilote JDBC pour l'adresse indiquée.
- Cliquez sur Fin pour vous connecter à la nouvelle base de
données et revenir au tableau de bord. L'Extension XML vous déconnecte de la
base de données initiale et vous connecte à la nouvelle base de données.
Le tableau de bord Administration de l'Extension XML permet d'accéder à
des assistants qui facilitent la réalisation des tâches d'administration,
telles que l'activation d'une base de données, l'édition d'une définition
d'accès au document (DAD) et l'activation de colonnes ou de collections XML.
Pour lancer un assistant, sélectionnez la tâche correspondante.
- Changement de base de données
- Ouvre une fenêtre de connexion à une base de données déterminée.
Pour accéder à des documents XML ou les stocker, vous devez être connecté à
une base de données. Cette opération effectuée, vous pouvez passer à une
autre base de données à partir du tableau de bord.
- Activation de la base de données/Désactivation de la base de données
- Active ou désactive une base de données pour l'Extension XML. Il
s'agit d'un bouton bascule qui varie selon que la base de données est déjà
désactivée ou activée. Pour activer la base de données, l'Extension XML crée
des types UDT, des fonctions UDF, une table de référence des DTD pour stocker
des DTD et les informations associées, ainsi qu'une table d'usage contenant
des informations communes pour chaque colonne activée. Pour désactiver une base
de données, l'Extension XML retire les types UDT, les fonctions UDF, la table
de référence DTD et la table d'usage XML. Pour désactiver une base de
données, vous devez d'abord désactiver toutes les colonnes et collections XML
associées.
- Importation d'une DTD
- Ouvre la fenêtre Importation d'une DTD qui permet d'importer un
fichier DTD dans le référentiel des DTD de la base de données en cours.
La définition du type de document (DTD) permet de valider les données XML
dans une colonne ou une collection XML. Elle est facultative pour les données
de colonne XML mais obligatoire pour les données de collection XML.
|
- |Edition d'une DAD
- |Ouvre la fenêtre Spécification d'une DAD qui permet d'éditer un fichier DAD |existant ou d'en créer un nouveau. La définition d'accès au
document (DAD) définit le |mode de collecte des données XML et leur stockage
dans DB2. Elle précise également les |attributs et les éléments clés associés
qui permettent de rechercher ces données.
|Pour l'indexation, la DAD de colonne XML mappe la colonne XML vers des tables
annexes. La |DAD de collection XML mappe les données DB2 vers la structure de
document XML.
- Utilisation des colonnes XML
- |Ouvre une fenêtre qui permet d'ajouter, d'activer ou de |désactiver
une colonne XML dans une table. Pour accéder aux données XML et les
stocker, |activez une colonne DB2 pour données de type XML.
- Utilisation des collections XML
- Ouvre une fenêtre qui permet d'activer ou de désactiver une
collection XML dans une base de données. Une collection permet d'accéder aux
données XML et de les stocker à l'aide d'un ensemble de tables relationnelles.
A partir du tableau de bord, vous pouvez réaliser les tâches Extension XML suivantes :
A partir de cet assistant, vous pouvez activer ou désactiver une base de données.
L'activation d'une base de données entraîne la création des éléments requis
pour l'utilisation de l'Extension XML (types UDT, fonctions UDF,
procédures mémorisées et tables de prise en charge de la gestion). Vous devez
activer la base de données pour pouvoir y stocker, composer ou décomposer des
documents XML. La désactivation d'une base de données entraîne le retrait des
types UDT, des fonctions UDF, des procédures mémorisées et des tables de
prise en charge de la gestion.
A partir du tableau de bord, cliquez sur Activation de la base de
données pour activer la base de données en cours. Si celle-ci est déjà
activée, seule l'option Désactivation de la base de données est
disponible.
Une fois la base de données activée, vous revenez au tableau de bord.
A partir du tableau de bord, cliquez sur Désactivation de la base de
données pour désactiver la base de données en cours. Si celle-ci est déjà
désactivée, seule l'option Activation de la base de données est
disponible.
Une fois la base de données désactivée, vous revenez au tableau de bord.
Cet assistant permet d'importer une DTD pour valider un document XML
stocké dans une colonne XML ou en cours de composition à partir de données
DB2 d'une collection XML.
- Nom de fichier DTD
- Tapez le nom du fichier DTD ou cliquez sur ... pour parcourir
la liste des DTD disponibles. Cette zone est
obligatoire.
- ID DTD
- Tapez le nom de la DTD. Cet identificateur associe la DTD à
la DAD de document XML et précise son emplacement. Cette valeur identifie la DTD et peut correspondre à son chemin dans le
système local. L'identificateur de DTD doit être identique à la valeur
figurant dans le fichier DAD pour l'<ID DTD>. Cette zone est
obligatoire.
- Auteur
- Tapez le nom de l'auteur de la DTD. Ce nom s'affiche automatiquement
lorsqu'il est précisé dans le référentiel des DTD. Cette zone est
facultative.
- Fin
- Insère la DTD dans le référentiel des DTD et revient au tableau de bord.
- Annulation
- Annule l'assistant et revient au tableau de
bord.
- A partir du tableau de bord, cliquez sur Importation d'une DTD
pour importer un fichier DTD dans le référentiel des DTD de la base de
données en cours. L'assistant Importation d'une DTD s'affiche.
- Tapez le nom du fichier DTD dans la zone Nom de fichier DTD,
ou cliquez sur ... pour parcourir la liste des DTD disponibles.
- Tapez l'identificateur de la DTD dans la zone ID DTD.
- Vous pouvez également indiquer l'auteur de la DTD dans la zone
Auteur.
L'Extension XML affiche automatiquement le nom de l'auteur si ce dernier
est précisé dans la DTD.
- Cliquez sur Fin pour insérer la DTD dans le référentiel des
DTD (table DB2XML.DTD_REF) et revenir au tableau de bord.
Cet assistant permet de créer ou d'éditer des fichiers DAD pour définir le
mode d'utilisation des documents XML avec DB2. Les fichiers DAD permettent de
:
- Stocker des documents XML dans des colonnes et de définir des tables
annexes indexées pour la recherche structurelle rapide.
- Composer des documents XML à partir d'une ou plusieurs tables DB2
définies dans une collection XML.
- Décomposer des documents XML en une ou plusieurs tables DB2 définies
dans une collection XML.
Pour plus de détails sur ces techniques, reportez-vous au Guide de
programmation et d'administration de l'Extension XML DB2.
- Nom de fichier
- Tapez un nom de fichier existant ou cliquez sur ... pour
parcourir la liste des DAD disponibles. Si vous créez une DAD, laissez cette
zone à blanc. Si le fichier DAD existe déjà, son type s'affiche dans la zone
Type et le bouton Suivant devient disponible.
- Type
- Si vous créez une DAD, sélectionnez l'un des types de fichiers DAD ci-après :
- Colonne XML, pour indiquer le mode d'indexation des documents stockés dans une colonne.
- Mappage SQL d'une collection XML, pour mapper les données
relationnelles et les documents XML par une seule instruction SQL.
- Mappage du noeud RDB d'une collection XML, pour indiquer des
définitions de noeud pour les tables, les colonnes et les conditions en vue
de définir le mode de stockage des données XML.
- Suivant
- Permet d'atteindre l'étape suivante (Sélection de la validation).
- Fin
- Vous activez ce bouton lorsque vous terminez la
création ou la modification d'un fichier DAD. Termine l'opération et revient
au tableau de bord.
- Annulation
- Annule l'assistant et revient au tableau de
bord.
- Validation des documents XML avec la DTD
- Sélectionnez cette option pour valider les documents XML. Les
documents valides permettent d'effectuer des recherches structurées sur les
données. Vos documents sont validés conformément à la DTD indiquée dans le
fichier DAD. Vous devez valider les données XML avant de les insérer dans DB2
car vous ne pouvez pas le faire lorsque celles-ci y figurent déjà.
- ID DTD
- Tapez le nom de la DTD ou sélectionnez-le dans la liste des DTD disponibles. Si vous n'avez importé aucune DTD dans le référentiel des DTD de votre
base de données, vous ne pouvez pas valider vos documents XML.
- |Pas de validation
- Sélectionnez cette option pour poursuivre la procédure sans valider les documents XML.
- Précédent
- Permet d'atteindre l'étape précédente (fenêtre Spécification d'une DAD).
- Suivant
- Permet d'atteindre l'étape suivante. Ouvre la fenêtre Gestion des
tables annexes, Spécification d'une instruction SQL ou Spécification de texte
selon que vous utilisez respectivement les colonnes XML, le mappage SQL d'une
collection XML ou le mappage du noeud RDB d'une collection XML.
- Fin
- Vous activez ce bouton lorsque vous terminez la
création ou la modification d'un fichier DAD. Termine l'opération et revient
au tableau de bord.
- Annulation
- Annule l'assistant et revient au tableau de
bord.
- |Liste des tables et colonnes existantes
- |Ce tableau contient la liste des tables annexes qui doivent être créées lorsqu'une colonne |XML utilisant ce fichier DAD est créée. Vous pouvez sélectionner le |nom d'une table ou d'une colonne existante que vous souhaitez modifier ou supprimer ou |taper un nouveau nom dans les zones qui suivent.
- Nom de la table
- Tapez le nom d'une nouvelle table annexe devant contenir la colonne. Si
vous avez sélectionné une colonne dans la liste, le nom de la table annexe
s'affiche pour que vous le modifiez. Cette zone est
obligatoire. Par exemple :
ORDER_SIDE_TAB
- Nom de la colonne
- Tapez le nom de la colonne. Si vous avez sélectionné un nom dans la
liste des colonnes, celui-ci s'affiche pour que vous le modifiez. Cette zone est
obligatoire. Par exemple :
CUSTOMER_NAME
- Type
- Sélectionnez ou modifiez le type de la colonne, tel que DATE, CHAR,
INTEGER ou VARCHAR. Cette zone est
obligatoire.
- Longueur
- Si vous avez sélectionné VARCHAR, tapez ou modifiez le nombre maximal
de caractères indiquant la longueur de la colonne. Cette zone n'est disponible que
pour le type VARCHAR. Par exemple :
30
- Chemin d'accès
- Tapez ou modifiez le chemin d'emplacement d'un élément ou d'un attribut. Cette zone est
obligatoire. Par exemple :
/ORDER/CUSTOMER/NAME
- Occurrences multiples
- Cochez cette case pour indiquer si l'élément ou l'attribut de colonne
peut être utilisé plusieurs fois ou non dans un même document. Cochez la case
pour permettre des occurrences multiples, sinon laissez-la désélectionnée.
- Ajout
- Sauvegarde la table ou la colonne avec les détails précisés et permet
de poursuivre les opérations d'ajout, de modification ou de suppression de
tables ou de colonnes.
- Modification
- Sauvegarde les modifications apportées dans les zones Nom de la
table, Nom de la colonne, Type, Longueur, Chemin d'accès ou
Occurrences multiples. Lorsque vous modifiez le nom d'une table ou d'une colonne,
l'ancien objet est retiré de la liste et le nouvel objet y est ajouté.
- Retrait
- Retire de la liste l'élément mis en évidence.
- Précédent
- Permet d'atteindre l'étape précédente (Sélection de la validation).
- Suivant
- Permet d'atteindre l'étape
suivante (Sauvegarde d'une DAD).
- Fin
- Vous activez ce bouton lorsque vous terminez la
création ou la modification d'un fichier DAD. Termine l'opération et revient
au tableau de bord.
- Annulation
- Annule l'assistant et revient au tableau de
bord.
- Prologue
- Tapez un nom de prologue. Si vous éditez une DAD existante, son nom
s'affiche. Le nom doit avoir le format suivant :
<?xml version="1.0" ?>
Cette zone est
obligatoire.
- Doctype
- Tapez le type de document XML. Si vous éditez une DAD existante, le
type de document s'affiche. Cette zone est
obligatoire. Par exemple :
<!DOCTYPE Order SYSTEM "C:\dxx\samples\dtd\getstart.dtd">
- Précédent
- Permet d'atteindre l'étape précédente (Sélection de la validation).
- Suivant
- Permet d'atteindre l'étape suivante (Mappage de noeuds RDB ou
Spécification d'une instruction SQL, selon qu'il s'agit respectivement du
type mappage du noeud RDB ou mappage SQL).
- Fin
- Vous activez ce bouton lorsque vous terminez la
création ou la modification d'un fichier DAD. Termine l'opération et revient
au tableau de bord.
- Annulation
- Annule l'assistant et revient au tableau de
bord.
- Instruction SQL
- Tapez une instruction SQL SELECT. Si vous éditez un fichier DAD
existant, l'instruction SQL s'affiche. Elle mappe les colonnes de la clause
SELECT vers les attributs ou les éléments du document XML.
La clause FROM définit les tables qui contiennent les données. La clause WHERE
indique les conditions de jointure et de recherche. Toutes les tables de la
collection doivent pouvoir faire l'objet d'une jointure par une seule
instruction SELECT. Cette zone est
obligatoire. Par exemple :
SELECT o.order_key, customer_name, customer_email, p.part_key, color, quantity,
price, tax, ship_id, date, mode from order_tab o, part_tab p,
table (select substr(char(timestamp(generate_unique())),16)
as ship_id, date, mode, part_key from ship_tab) s
WHERE o.order_key = 1 and
p.price > 20000 and
p.order_key = o.order_key and
s.part_key = p.part_key
ORDER BY order_key, part_key, ship_id
L'instruction SQL respecte les instructions suivantes :
- Les colonnes sont indiquées dans l'ordre descendant, en fonction de la
hiérarchie de la structure du document XML.
- Les colonnes d'une même entité sont regroupées et chaque groupe
comporte une colonne ID objet.
- La colonne ID objet est la première colonne de chaque groupe.
- Lorsque les tables n'utilisent pas de colonne conditionnelle à clé
unique, générez cette colonne à l'aide de la fonction intégrée DB2 generate_unique.
- Les colonnes ID objet sont indiquées dans l'ordre descendant dans
l'instruction ORDER BY. Les noms de colonnes de l'instruction ORDER BY ne
doivent être qualifiés par aucun nom de schéma et de table et doivent être
identiques au noms de colonnes indiqués dans la clause SELECT.
- Test SQL
- Vérifie si l'instruction SQL est valide. Dans l'affirmative,
l'exemple de résultats s'affiche dans la zone Exemple de résultats. Dans la
négative, un message d'erreur vous demande de corriger l'instruction et de
réessayer.
- Exemple de résultats
- Affiche l'exemple de résultats du test auquel votre instruction SQL a
été soumise, dans la mesure où celle-ci est valide. Cette zone est accessible en lecture uniquement.
- Précédent
- Permet d'atteindre l'étape précédente (Sélection de la validation).
- Suivant
- Permet d'atteindre l'étape suivante (Mappage SQL).
- Fin
- Vous activez ce bouton lorsque vous terminez la
création ou la modification d'un fichier DAD. Termine l'opération et revient
au tableau de bord.
- Annulation
- Annule l'assistant et revient au tableau de
bord.
- Mappe DAD
- Sur la mappe DAD affichée, sélectionnez le noeud
à partir duquel le mappage doit être établi. Vous pouvez mapper les éléments
et les attributs du document XML vers les noeuds d'éléments et d'attributs
correspondant aux données DB2. Les noeuds indiquent le chemin des données XML
aux données DB2. Sélectionnez un noeud
pour activer l'option Nouvel élément. La sélection d'un noeud entraîne
l'affichage des zones correspondantes dans la boîte d'options Détails.
- Type du noeud
- Sélectionnez un type de noeud dans la liste des types valides pour ce
point de la mappe. Les zones qui s'affichent dans la boîte d'options
Détails dépendent du type de noeud sélectionné. Cette zone est
obligatoire.
- Elément
- Représente un élément XML défini dans la DTD du document XML. Permet
d'associer l'élément XML à une colonne dans une table DB2. Un noeud
d'élément peut être doté de noeuds d'attributs, de noeuds d'éléments enfants
ou de noeuds de texte. Un noeud de niveau inférieur est associé à un noeud de
texte et à un nom de colonne dans l'arborescence.
- Attribut
- Représente un attribut XML défini dans la DTD du document XML. Permet
d'associer l'attribut XML à une colonne dans une table DB2.
Un noeud d'attribut peut être doté d'un noeud de texte. Il est associé à un
nom de colonne dans l'arborescence.
- Texte
- Indique le contenu textuel d'un noeud d'élément. Un noeud de texte est
associé à un nom de colonne dans l'arborescence.
- Nom du noeud
- Tapez le nom du noeud. Cette zone est
obligatoire. Par exemple :
Order
- Colonne
- Si vous avez choisi Attribut, Elément
ou Texte pour le type de noeud, sélectionnez un nom de colonne. Cette zone est
obligatoire.
Si vous indiquez le type de noeud Colonne, vous ne pouvez sélectionner
qu'une colonne existant déjà dans votre base de données DB2.
Par exemple :
Customer_Name
- Ajout
- Ajoute l'intitulé approprié à l'élément vide que vous
créez dans l'arborescence.
- Modification
- Modifie le noeud mis en évidence. Vous pouvez
sélectionner le même noeud ou un noeud différent et apporter des
modifications supplémentaires.
- Retrait
- Retire l'élément ou l'attribut mis en évidence.
- Nouvel élément
- Crée un noeud par l'effacement des zones de la boîte
d'options Détails, ajoute un élément vide au-dessous de l'élément mis
en évidence dans l'arborescence, puis met en évidence le nouvel élément vide.
- Précédent
- Permet d'atteindre l'étape précédente (Spécification d'une instruction SQL).
- Suivant
- Permet d'atteindre l'étape
suivante (Sauvegarde d'une DAD).
- Fin
- Vous activez ce bouton lorsque vous terminez la
création ou la modification d'un fichier DAD. Termine l'opération et revient
au tableau de bord.
- Annulation
- Annule l'assistant et revient au tableau de
bord.
- Mappe DAD
- Sur la mappe DAD affichée, sélectionnez le noeud
à partir duquel le mappage doit être établi. Vous mappez les éléments et les
attributs du document XML vers les noeuds d'éléments et d'attributs
correspondant aux données DB2. Les noeuds indiquent le chemin des données XML
aux données DB2. Ils précisent la table et la colonne qui contiennent les
données et la condition d'extraction de celles-ci. Sélectionnez un noeud
pour activer l'option Nouvel élément. La sélection d'un noeud entraîne
l'affichage des zones correspondantes dans la boîte d'options Détails.
- Type du noeud
- Sélectionnez un type de noeud dans la liste des types valides pour ce
point de la mappe. Les zones qui s'affichent dans la boîte d'options
Détails dépendent du type de noeud sélectionné. Il peut s'agir des
zones Elément, Attribut, Texte, Table,
Colonne ou Condition, en fonction du choix effectué sur la
mappe DAD. Cette zone est
obligatoire.
- Elément
- Représente un élément XML défini dans la DTD du document XML. Permet
d'associer l'élément XML à une colonne dans une table DB2. Un noeud
d'élément être doté de noeuds d'attributs, de noeuds d'éléments enfants, de
noeuds de texte, de noeuds de tables ou de noeuds de conditions. Un élément racine comporte des noeuds de tables pour
indiquer l'utilisation de toutes les tables lors de la génération de
documents XML et leur connexion via un noeud de condition. Cette zone est
obligatoire. Par exemple :
element_node name="Order"
- Attribut
- Représente un noeud d'attribut XML défini dans la DTD du document
XML. Permet d'associer l'attribut XML à une colonne dans une table DB2. Un
noeud d'attribut peut être doté d'un noeud de texte. Il est associé à un nom
de colonne dans la mappe DAD. Les données résident sur le noeud d'attribut et
de texte de chaque élément. Cette zone est
obligatoire. Par exemple :
attribute_node name="key"
|
- |Table
- |Représente la table associée au contenu du noeud de texte ou du |noeud d'attribut. Indique le nom d'une table DB2 dans laquelle le contenu|du noeud de texte ou du noeud d'attribut sera stocké ou de laquelle il sera
|retiré. Par exemple :
|table_node name=order_tab
|
- |Colonne
- |Représente la colonne dans laquelle se trouve le contenu de noeud de texte ou du |noeud d'attribut. Indique le nom d'une colonne de table DB2 dans laquelle le contenu|du noeud de texte ou du noeud d'attribut sera stocké ou de laquelle il sera
|retiré. Par exemple :
|column name="order_key"
- Nom du noeud
- Tapez le nom d'un élément ou d'un attribut. Cette zone est
obligatoire. Par exemple :
element_node name="Price"
- Texte
- Indique le contenu textuel d'un élément et les données de colonne d'une
table relationnelle pour les noeuds d'éléments de niveau inférieur. Contient
un élément table, un élément colonne et, pour le noeud racine (root), un
élément condition.
- Nom de la table
- Nom de la table qui contient la colonne. Par exemple :
table name="order_tab"
table name="part_tab"
table name="ship_tab"
- Clé de la table
- Clé primaire de la table, correspondant à une ou plusieurs colonnes (clé composée).
Cette clé permet de relier les tables entre elles dans une collection. Exemple de
clé composée :
table name="part_tab" key="part_key, price"
- Colonne
- Nom de la colonne qui contient les données pour le
texte de l'élément et vers laquelle l'élément et l'attribut sont mappés. Par exemple :
column name="order_key" type="integer"
- Condition
- Dans les éléments racines (root), indique le mode de jointure des
tables de collection XML.
Dans les éléments de niveau inférieur, indique les critères de sélection des
données XML à l'aide des valeurs "=", "<", ">" ou "LIKE". Exemple de
condition pour un élément racine :
order_tab.order_key = part_tab.order_key AND
part_tab.part_key = ship_tab.part_key
Exemple de critère de sélection de données XML :
price > 2500.00
- Ajout
- Ajoute l'intitulé approprié à l'élément vide que vous
créez dans l'arborescence.
- Modification
- Modifie le noeud mis en évidence. Vous pouvez
sélectionner le même noeud ou un noeud différent et apporter des
modifications supplémentaires.
- Retrait
- Retire l'élément mis en évidence.
- Nouvel élément
- Crée un noeud par l'effacement des zones de la boîte
d'options Détails, ajoute un élément vide au-dessous de l'élément mis
en évidence dans l'arborescence, puis met en évidence le nouvel élément vide.
- Précédent
- Permet d'atteindre l'étape précédente (Spécification de texte).
- Suivant
- Permet d'atteindre la fenêtre suivante (Sauvegarde d'une DAD).
- Fin
- Vous activez ce bouton lorsque vous terminez la
création ou la modification d'un fichier DAD. Termine l'opération et revient
au tableau de bord.
- Annulation
- Annule l'assistant et revient au tableau de
bord.
- Nom de fichier
- Tapez le nom de la DAD (nouvelle ou
modifiée) à sauvegarder. Vous pouvez également cliquer sur ... pour
ouvrir la fenêtre de l'explorateur de fichiers locaux qui permet de
sélectionner l'emplacement de sauvegarde de la DAD. Cette zone est
obligatoire.
- Précédent
- Permet d'atteindre l'étape précédente.
- Fin
- Sauvegarde le fichier DAD et revient au tableau de bord.
- Annulation
- Annule l'assistant et revient au tableau de
bord.
Lorsque vous créez une DAD de colonne XML, vous indiquez le type de
données du document XML et définissez des tables annexes pour l'indexation.
- A partir du tableau de bord, |cliquez sur Edition d'une DAD pour éditer ou créer un |fichier DAD XML. L'assistant Utilisation des fichiers DAD s'ouvre et affiche la fenêtre |Spécification d'une DAD.
- Vous pouvez éditer un fichier DAD existant ou en créer
un nouveau.
- Pour éditer une DAD existante, procédez comme suit :
- Cliquez sur ... pour parcourir la liste des DAD disponibles, ou
tapez le nom de fichier DAD voulu dans la zone Nom de fichier.
- Vérifiez que l'assistant reconnaît le fichier DAD indiqué.
- Dans l'affirmative, le bouton Suivant devient disponible et
Colonne XML s'affiche dans la zone Type.
- Dans la négative, vous ne pouvez pas cliquer sur Suivant.
Tapez un autre nom de fichier DAD existant dans la zone Nom de
fichier, ou cliquez sur ... pour parcourir à nouveau la liste des
DAD disponibles. Réessayez jusqu'à ce que le
bouton Suivant devienne disponible.
- Cliquez sur Suivant.
- Pour créer une DAD, procédez comme suit :
- Laissez la zone Nom de fichier à blanc.
- Dans la liste Type, cliquez sur Colonne XML.
- Cliquez sur Suivant.
- Dans la fenêtre Sélection de la validation, vous pouvez choisir de
valider vos documents XML avec une DTD.
- Cliquez sur Suivant.
- Vous pouvez ajouter, éditer ou retirer une table
annexe dans la fenêtre Tables annexes.
- Pour ajouter une table annexe ou une colonne de table annexe, procédez comme suit :
Pour ajouter une table annexe, vous devez définir ses colonnes.
Procédez comme suit pour chaque colonne de la table annexe.
- Remplissez les zones de la boîte d'options Détails dans la fenêtre Tables annexes.
- Nom de la table : Tapez le nom de la table qui doit contenir la colonne.
- Nom de la colonne : Tapez le nom de la colonne.
- Type : Sélectionnez un type de colonne dans la liste.
- Longueur (type VARCHAR uniquement) : Tapez le nombre maximal de caractères VARCHAR.
- Chemin d'accès : Tapez le chemin de l'élément ou de l'attribut.
- Occurrences multiples : Sélectionnez Oui ou Non dans la liste.
Cette option indique si l'élément ou l'attribut de colonne peut être
utilisé plusieurs fois dans un même document. Important : Si vous
cochez la case Occurrences multiples pour une colonne, vous ne pouvez
indiquer qu'une seule colonne dans la table annexe qui la contient.
- Cliquez sur Ajout pour ajouter une colonne.
- Poursuivez les opérations d'ajout, d'édition ou de retrait de
colonnes pour la table annexe, ou cliquez sur Suivant.
- Pour éditer une colonne de table annexe existante, procédez comme suit :
Pour mettre à jour une table annexe, modifiez les définitions des colonnes existantes.
- Dans la table annexe, cliquez sur le nom de la colonne à éditer.
- Editez les zones de la boîte d'options Détails.
- Cliquez sur Modification pour sauvegarder vos modifications.
- Poursuivez les opérations d'ajout, d'édition ou de retrait de
colonnes pour chaque table annexe, ou cliquez sur Suivant.
- Pour retirer une colonne de table annexe existante, procédez comme suit :
- Dans la table annexe, cliquez sur la colonne à retirer.
- Cliquez sur Retrait.
- Poursuivez les opérations d'ajout, d'édition ou de retrait de
colonnes de table annexe, ou cliquez sur Suivant.
- Pour retirer une table annexe existante, procédez comme suit :
Pour retirer la table annexe, supprimez chacune de ses colonnes.
- Cliquez sur chaque colonne de la table annexe à retirer.
- Cliquez sur Retrait.
- Poursuivez les opérations d'ajout, d'édition ou de retrait de
colonnes de tables annexes, ou cliquez sur Suivant.
- Dans la zone Nom de fichier de la fenêtre Spécification d'une
DAD, tapez un nom de fichier de sortie pour la DAD modifiée.
- Cliquez sur Fin pour sauvegarder le fichier DAD et revenir au
tableau de bord.
Lorsque vous créez la DAD de collection XML, vous mappez le document XML
vers la source de données DB2 à l'aide de l'une des méthodes suivantes :
- A partir du tableau de bord, cliquez sur |Edition d'une DAD.
La fenêtre Spécification d'une DAD s'affiche.
- Vous pouvez éditer un fichier DAD existant ou en créer
un nouveau.
Pour créer un fichier DAD, procédez comme suit :
- Laissez la zone Nom de fichier à blanc.
- Dans la liste Type, cliquez sur Mappage SQL d'une collection XML.
- Cliquez sur Suivant pour ouvrir la fenêtre
Sélection de la validation.
Pour éditer un fichier DAD existant, procédez comme suit :
- Tapez le nom du fichier DAD dans la zone Nom de fichier, ou
cliquez sur ... pour parcourir la liste des DAD disponibles.
- Vérifiez que l'assistant reconnaît le fichier DAD indiqué.
- Dans l'affirmative, le bouton Suivant devient disponible et
Mappage SQL d'une collection XML s'affiche dans la zone Type.
- Dans la négative, vous ne pouvez pas cliquer sur Suivant.
Tapez un autre nom de fichier existant, ou cliquez sur ... pour
parcourir à nouveau la liste des DAD disponibles. Réessayez jusqu'à ce que le
bouton Suivant devienne disponible.
- Cliquez sur Suivant pour ouvrir la fenêtre
Sélection de la validation.
- Dans la fenêtre Sélection de la validation, vous pouvez choisir de
valider vos documents XML avec une DTD.
- Cliquez sur Suivant pour ouvrir la fenêtre
Spécification de texte.
- Dans la zone Prologue, tapez le prologue du document XML à composer.
<?xml version="1.0"?>
Si vous éditez une DAD existante, le prologue s'affiche automatiquement
dans la zone Prologue.
- Dans la zone Doctype de la fenêtre Spécification de texte,
tapez le type du document XML en désignant la DTD associée.
Par exemple :
|<!DOCTYPE Order SYSTEM "C:\dxx\samples\dtd\getstart.dtd">
Si vous éditez une DAD existante, le type de document s'affiche
automatiquement dans la zone Doctype.
- Cliquez sur Suivant pour ouvrir la fenêtre Spécification d'une instruction SQL.
- Tapez une instruction SQL SELECT valide dans la zone Instruction SQL.
Si vous éditez une DAD existante, l'instruction SQL s'affiche
automatiquement dans la zone Instruction SQL.
- Cliquez sur Test SQL pour vérifier la validité de l'instruction SQL.
- Dans l'affirmative, l'exemple de résultats s'affiche dans la zone
Exemple de résultats.
- Dans la négative, cette zone contient un message d'erreur qui vous
demande de corriger l'instruction SQL SELECT et de réessayer.
- |Cliquez sur Suivant pour ouvrir la fenêtre Mappage SQL.
- Pour sélectionner un noeud d'élément ou d'attribut de départ pour le
mappage, cliquez sur celui-ci dans la zone
située à gauche de la fenêtre |Mappage SQL.
Mappez les éléments et les attributs du document XML vers les noeuds
d'éléments et d'attributs correspondant aux données DB2. Ces noeuds indiquent le chemin
des données XML aux données DB2.
- Pour ajouter le noeud racine (root), procédez comme suit :
- Sélectionnez l'icône Root.
- Cliquez sur Nouvel élément pour définir un nouveau noeud.
- Dans la boîte d'options Détails, indiquez Elément
pour Type du noeud.
- Entrez le nom du noeud racine dans la zone Nom du noeud.
- Cliquez sur Ajout pour créer le noeud.
Vous avez créé le noeud ou l'élément racine, parent de tous les autres
noeuds d'éléments et d'attributs de la mappe. Vous pouvez à présent lui ajouter des éléments enfants et des attributs.
- Pour ajouter un élément enfant ou un noeud
d'attribut, procédez comme suit :
- Pour ajouter un élément enfant ou un attribut, cliquez sur un noeud
parent dans la zone située à gauche.
Si vous n'avez sélectionné aucun noeud parent, l'option Nouvel Elément n'est pas disponible.
- Cliquez sur Nouvel élément.
- Sélectionnez un type de noeud dans la liste Type du noeud de
la boîte d'options Détails.
La liste Type du noeud n'affiche que les types de noeuds valides pour ce point de la mappe.
- Renseignez la zone Nom du noeud dans la boîte d'options
Détails.
- Si vous avez indiqué le type de noeud Attribut,
Elément ou Texte pour un élément de niveau inférieur,
sélectionnez une colonne dans la zone Colonne de la boîte d'options
Détails.
Restriction : Vous ne pouvez pas créer de colonne à l'aide de
l'assistant d'administration.
Si vous indiquez le type de noeud Colonne, vous ne pouvez sélectionner
qu'une colonne existant déjà dans votre base de données DB2.
- Cliquez sur Ajout pour ajouter le noeud.
Vous pouvez modifier un noeud ultérieurement. Pour ce faire, cliquez sur
celui-ci dans la zone située à gauche et apportez toutes les modifications
souhaitées dans la zone de groupe Détails.
Cliquez sur Modification pour mettre à jour l'élément.
Vous pouvez également ajouter des éléments enfants ou des attributs au
noeud. Pour ce faire, mettez-le en évidence et répétez la procédure d'ajout.
- Poursuivez l'édition de la mappe SQL, ou cliquez sur Suivant
pour ouvrir la fenêtre Spécification d'une DAD.
- Pour retirer un noeud, procédez comme suit :
- Cliquez sur un noeud figurant dans la zone située à gauche.
- Cliquez sur Retrait.
- Poursuivez l'édition de la mappe SQL, ou cliquez sur Suivant
pour ouvrir la fenêtre Spécification d'une DAD.
Si vous avez retiré un noeud de niveau inférieur, un autre élément,
pouvant nécessiter la définition d'un nom de colonne, le remplace dans
l'arborescence.
- Dans la zone Nom de fichier de la fenêtre Spécification d'une
DAD, tapez un nom de fichier de sortie pour la DAD modifiée.
- Cliquez sur Fin pour revenir au tableau de bord.
- A partir du tableau de bord, cliquez sur |Edition d'une DAD.
La fenêtre Spécification d'une DAD s'affiche.
- Vous pouvez éditer un fichier DAD existant ou en créer
un nouveau.
Pour éditer une DAD existante, procédez comme suit :
- Tapez le nom du fichier DAD dans la zone Nom de fichier,
ou cliquez sur ... pour parcourir la liste des DAD disponibles.
- Vérifiez que l'assistant reconnaît le fichier DAD indiqué.
- Dans l'affirmative, le bouton Suivant devient disponible et
Mappage du noeud RDB d'une collection XML s'affiche dans la zone Type.
- Dans la négative, vous ne pouvez pas cliquer sur Suivant.
Tapez un autre nom de fichier DAD existant dans la zone Nom de
fichier, ou cliquez sur ... pour parcourir à nouveau la liste des
DAD disponibles. Réessayez jusqu'à ce que le bouton Suivant
devienne disponible.
- Cliquez sur Suivant pour ouvrir la fenêtre
Sélection de la validation.
Pour créer une DAD, procédez comme suit :
- Laissez la zone Nom de fichier à blanc.
- Sélectionnez Mappage du noeud RDB d'une collection XML dans
la liste Type.
- Cliquez sur Suivant pour ouvrir la fenêtre
Sélection de la validation.
- Dans la fenêtre Sélection de la validation, vous pouvez choisir de
valider vos documents XML avec une DTD.
- Cliquez sur Suivant pour ouvrir la fenêtre
Spécification de texte.
- Tapez le nom de prologue dans la zone Prologue de la fenêtre
Spécification de texte.
<?xml version="1.0"?>
Si vous éditez une DAD existante, le prologue s'affiche automatiquement
dans la zone Prologue.
- Entrez le type du document XML dans la zone Doctype.
Par exemple :
|<!DOCTYPE Order SYSTEM "C:\dxx\samples\dtd\getstart.dtd">
Si vous éditez une DAD existante, le type de document s'affiche
automatiquement dans la zone Doctype.
- |Cliquez sur Suivant pour ouvrir la fenêtre Mappage de noeuds RDB.
- Pour sélectionner un noeud d'élément ou d'attribut de départ pour le
mappage, cliquez sur celui-ci dans la zone
située à gauche de la fenêtre |Mappage de noeuds RDB.
Mappez les éléments et les attributs du document XML vers les noeuds
d'éléments et d'attributs correspondant aux données DB2. Ces noeuds indiquent le chemin
des données XML aux données DB2.
- Pour ajouter le noeud racine (root), procédez comme suit :
- Sélectionnez l'icône Root.
- Cliquez sur Nouvel élément pour définir un nouveau noeud.
- Dans la boîte d'options Détails, indiquez Elément
pour Type du noeud.
- Entrez le nom du noeud racine dans la zone Nom du noeud.
- Cliquez sur Ajout pour créer le noeud.
Vous avez créé le noeud ou l'élément racine, parent de tous les autres
noeuds d'éléments et d'attributs de la mappe. Le noeud racine comporte des
éléments enfants de table et une condition de jointure.
Ajoutez des noeuds de tables pour chaque table faisant partie
de la collection.
- Mettez le nom de noeud racine en évidence et
sélectionnez Nouvel élément.
- Dans la boîte d'options Détails, indiquez Table
pour Type du noeud.
- Sélectionnez le nom de la table dans la liste Nom
de la table. La table doit déjà exister.
- Cliquez sur Ajout pour ajouter le noeud de table.
- Répétez ces étapes pour chaque table.
Ajoutez une condition de jointure pour les noeuds de tables.
- Mettez le nom de noeud racine en évidence et
sélectionnez Nouvel élément.
- Dans la boîte d'options Détails, indiquez Condition
pour Type du noeud.
- Dans la zone Condition, entrez la condition de jointure en
respectant la syntaxe suivante :
table_name.table_column = table_name.table_column AND
table_name.table_column = table_name.table_column ...
Incluez toutes les conditions nécessaires pour créer la condition
de jointure, en les réunissant par AND.
- Cliquez sur Ajout pour ajouter la condition.
Vous pouvez à présent lui ajouter des éléments enfants et des attributs.
- Pour ajouter un élément enfant ou un noeud
d'attribut, procédez comme suit :
- Pour ajouter un élément enfant ou un attribut, cliquez sur un noeud
parent dans la zone située à gauche.
- Cliquez sur Nouvel élément. Si vous n'avez sélectionné aucun noeud parent, l'option Nouvel Elément n'est pas disponible.
- Sélectionnez un type de noeud dans la liste Type du noeud
de la boîte d'options Détails.
La liste Type du noeud n'affiche que les types de noeuds valides
pour ce point de la mappe, c'est-à-dire Elément ou Attribut.
- Entrez le nom de l'élément ou de l'attribut dans la zone Nom du noeud.
- Si vous avez indiqué le type de noeud Attribut
ou Elément pour un élément de niveau inférieur, sélectionnez
une colonne dans la zone Colonne de la boîte d'options Détails.
Restriction : Vous ne pouvez pas créer de colonne à l'aide de
l'assistant d'administration. Si vous indiquez le type de noeud Colonne, vous
ne pouvez sélectionner qu'une colonne existant déjà dans votre
base de données DB2.
- Cliquez sur Ajout pour ajouter le noeud.
Vous pouvez modifier un noeud ultérieurement. Pour ce faire, cliquez sur
celui-ci dans la zone située à gauche et apportez toutes les modifications
souhaitées dans la zone de groupe Détails.
Cliquez sur Modification pour mettre à jour l'élément.
Vous pouvez également ajouter des éléments enfants ou des attributs au
noeud. Pour ce faire, mettez-le en évidence et répétez la procédure d'ajout.
- Pour mapper le contenu d'un noeud d'élément ou d'attribut vers
une table relationnelle, procédez comme suit :
- Indiquez un noeud de texte.
- Cliquez sur le noeud parent.
- Cliquez sur Nouvel élément.
- Dans la zone Type du noeud, sélectionnez Texte.
- Sélectionnez Ajout pour ajouter le noeud.
- Ajoutez un noeud de table.
- Sélectionnez le noeud de texte que vous venez de créer et cliquez sur
Nouvel élément.
- Dans la zone Type du noeud, sélectionnez Table et
indiquez un nom de table pour l'élément.
- Cliquez sur Ajout pour ajouter le noeud.
- Ajoutez un noeud de colonne.
- Resélectionnez le noeud de texte et cliquez sur Nouvel élément.
- Dans la zone Type du noeud, sélectionnez Colonne et
indiquez un nom de colonne pour l'élément.
- Cliquez sur Ajout pour ajouter le noeud.
Restriction : Vous ne pouvez pas créer de colonne à l'aide de
l'assistant d'administration. Si vous indiquez le type de noeud Colonne, vous
ne pouvez sélectionner qu'une colonne existant déjà dans votre
base de données DB2.
- Vous pouvez ajouter une condition pour la colonne.
- Resélectionnez le noeud de texte et cliquez sur Nouvel élément.
- Dans la zone Type du noeud, sélectionnez Condition et
indiquez une condition en respectant avec sa syntaxe :
operator LIKE|<|>|= value
- Cliquez sur Ajout pour ajouter le noeud.
- Poursuivez l'édition de la mappe du noeud RDB, ou cliquez sur
Suivant pour ouvrir la fenêtre Spécification d'une DAD.
- Pour retirer un noeud, procédez comme suit :
- Cliquez sur un noeud figurant dans la zone située à gauche.
- Cliquez sur Retrait.
- Poursuivez l'édition de la mappe du noeud RDB, ou cliquez sur
Suivant pour ouvrir la fenêtre Spécification d'une DAD.
- Dans la zone Nom de fichier de la fenêtre Spécification
d'une DAD, tapez un nom de fichier de sortie pour la DAD modifiée.
- Cliquez sur Fin pour retirer le noeud et revenir au tableau
de bord.
- A partir du tableau de bord, cliquez sur |Edition d'une DAD. La fenêtre Spécification d'une DAD
s'affiche.
- Vous pouvez éditer un fichier DAD existant ou en créer
un nouveau.
Pour éditer une DAD existante, procédez comme suit :
- Tapez le nom du fichier DAD dans la zone Nom de fichier,
ou cliquez sur ... pour parcourir la liste des DAD disponibles.
- Vérifiez que l'assistant reconnaît le fichier DAD indiqué.
- Dans l'affirmative, le bouton Suivant devient disponible et
Mappage du noeud RDB d'une collection XML s'affiche dans la zone Type.
- Dans la négative, vous ne pouvez pas cliquer sur Suivant.
Tapez un autre nom de fichier DAD existant dans la zone Nom de
fichier, ou cliquez sur ... pour parcourir à nouveau la liste des
DAD disponibles. Réessayez jusqu'à ce que le bouton Suivant
devienne disponible.
- Cliquez sur Suivant pour ouvrir la fenêtre
Sélection de la validation.
Pour créer une DAD, procédez comme suit :
- Laissez la zone Nom de fichier à blanc.
- Sélectionnez Mappage du noeud RDB d'une collection XML dans
la liste Type.
- Cliquez sur Suivant pour ouvrir la fenêtre
Sélection de la validation.
- Dans la fenêtre Sélection de la validation, vous pouvez choisir de
valider vos documents XML avec une DTD.
- Cliquez sur Suivant pour ouvrir la fenêtre
Spécification de texte.
- Si vous décomposez uniquement un document XML, ignorez la zone Prologue.
Si vous utilisez le fichier DAD pour des opérations de composition et de
décomposition, tapez le nom de prologue dans la zone Prologue de la
fenêtre Spécification de texte. Le prologue est facultatif lorsque vous
décomposez des documents XML en données DB2.
<?xml version="1.0"?>
Si vous éditez une DAD existante, le prologue s'affiche automatiquement
dans la zone Prologue.
- Si vous décomposez uniquement un document XML, ignorez la zone Doctype.
Si vous utilisez le fichier DAD pour des opérations de composition et de
décomposition, entrez le type de document XML dans la zone Doctype.
Si vous éditez une DAD existante, le type de document s'affiche
automatiquement dans la zone Doctype.
Par exemple :
|<!DOCTYPE Order SYSTEM "C:\dxx\samples\dtd\getstart.dtd">
- Cliquez sur Suivant pour ouvrir la fenêtre Mappage RDB.
- Pour sélectionner un noeud d'élément ou d'attribut de départ pour le
mappage, cliquez sur celui-ci dans la zone
située à gauche de la fenêtre Mappage RDB.
Mappez les éléments et les attributs du document XML vers les noeuds
d'éléments et d'attributs correspondant aux données DB2. Ces noeuds indiquent le chemin
des données XML aux données DB2.
- Pour ajouter le noeud racine (root), procédez comme suit :
- Sélectionnez l'icône Root.
- Cliquez sur Nouvel élément pour définir un nouveau noeud.
- Dans la boîte d'options Détails, indiquez Elément
pour Type du noeud.
- Entrez le nom du noeud racine dans la zone Nom du noeud.
- Cliquez sur Ajout pour créer le noeud.
Vous avez créé le noeud ou l'élément racine, parent de tous les autres
noeuds d'éléments et d'attributs de la mappe. Le noeud racine comporte des
éléments enfants de table et une condition de jointure.
Ajoutez des noeuds de tables pour chaque table faisant partie
de la collection.
- Mettez le nom de noeud racine en évidence et
sélectionnez Nouvel élément.
- Dans la boîte d'options Détails, indiquez Table
pour Type du noeud.
- Sélectionnez le nom de la table dans la liste Nom
de la table. La table doit déjà exister.
- Dans la zone Clé de la table, indiquez une colonne de clé pour la table.
- Cliquez sur Ajout pour ajouter le noeud de table.
- Répétez ces étapes pour chaque table.
Ajoutez une condition de jointure pour les noeuds de tables.
- Mettez le nom de noeud racine en évidence et
sélectionnez Nouvel élément.
- Dans la boîte d'options Détails, indiquez Condition
pour Type du noeud.
- Dans la zone Condition, entrez la condition de jointure en
respectant la syntaxe suivante :
table_name.table_column = table_name.table_column AND
table_name.table_column = table_name.table_column ...
- Cliquez sur Ajout pour ajouter la condition.
Vous pouvez à présent lui ajouter des éléments enfants et des attributs.
- Pour ajouter un élément enfant ou un noeud
d'attribut, procédez comme suit :
- Pour ajouter un élément enfant ou un attribut, cliquez sur un noeud
parent dans la zone située à gauche.
Si vous n'avez sélectionné aucun noeud parent, l'option Nouvel élément n'est pas disponible.
- Cliquez sur Nouvel élément.
- Sélectionnez un type de noeud dans la liste Type du noeud
de la boîte d'options Détails.
La liste Type du noeud n'affiche que les types de noeuds valides
pour ce point de la mappe, c'est-à-dire Elément ou Attribut.
- Cliquez sur Ajout pour ajouter le noeud. Vous pouvez modifier
un noeud ultérieurement. Pour ce faire, cliquez sur celui-ci dans la zone
située à gauche et apportez toutes les modifications souhaitées dans la boîte
d'options Détails. Cliquez sur Modification pour mettre à jour l'élément.
- Pour mapper le contenu d'un noeud d'élément ou d'attribut vers
une table relationnelle, procédez comme suit :
- Indiquez un noeud de texte.
- Cliquez sur le noeud parent.
- Cliquez sur Nouvel élément.
- Dans la zone Type du noeud, sélectionnez Texte.
- Sélectionnez Ajout pour ajouter le noeud.
- Ajoutez un noeud de table.
- Sélectionnez le noeud de texte que vous venez de créer et cliquez sur
Nouvel élément.
- Dans la zone Type du noeud, sélectionnez Table et
indiquez un nom de table pour l'élément.
- Cliquez sur Ajout pour ajouter le noeud.
- Ajoutez un noeud de colonne.
- Resélectionnez le noeud de texte et cliquez sur Nouvel élément.
- Dans la zone Type du noeud, sélectionnez Colonne et
indiquez un nom de colonne pour l'élément.
- Dans la zone Type, indiquez le type de base à affecter à la
colonne pour que celle-ci puisse stocker les données non balisées.
- Cliquez sur Ajout pour ajouter le noeud.
Restriction : Vous ne pouvez pas créer de colonne à l'aide de
l'assistant d'administration. Si vous indiquez le type de noeud Colonne, vous
ne pouvez sélectionner qu'une colonne existant déjà dans votre
base de données DB2.
- Vous pouvez ajouter une condition pour la colonne.
- Resélectionnez le noeud de texte et cliquez sur Nouvel élément.
- Dans la zone Type du noeud, sélectionnez Condition et
indiquez une condition en respectant avec sa syntaxe :
operator LIKE|<|>|= value
- Cliquez sur Ajout pour ajouter le noeud.
- Poursuivez l'édition de la mappe du noeud RDB, ou cliquez sur
Suivant pour ouvrir la fenêtre Spécification d'une DAD.
- Pour retirer un noeud, procédez comme suit :
- Cliquez sur un noeud figurant dans la zone située à gauche.
- Cliquez sur Retrait.
- Poursuivez l'édition de la mappe du noeud RDB, ou cliquez sur
Suivant pour ouvrir la fenêtre Spécification d'une DAD.
- Dans la zone Nom de fichier de la fenêtre Spécification
d'une DAD, tapez un nom de fichier de sortie pour la DAD modifiée.
- Cliquez sur Fin pour retirer le noeud et revenir au tableau
de bord.
A partir de cet assistant, vous pouvez ajouter, activer ou désactiver des
colonnes XML pour l'Extension XML.
- Ajout d'une colonne XML
- Sélectionnez cette option pour ouvrir la fenêtre Ajout d'une colonne
XML qui permet d'ajouter une colonne dans une table. Cette colonne contiendra un
document XML entier. Cette option n'est disponible que si la base de données
est activée.
- |Activation d'une colonne XML
- Sélectionnez cette option pour ouvrir la fenêtre |Activation d'une
colonne XML qui permet de vous connecter à une base de données et d'activer une
colonne XML pour qu'elle puisse contenir des types UDT Extension XML. Cette
option n'est disponible que si la base de données est activée et que des
colonnes sont créées pour des documents XML.
- |Désactivation d'une colonne XML
- Sélectionnez cette option pour ouvrir la fenêtre |Désactivation d'une
colonne XML qui permet de désactiver une colonne existante. Si la base de données
n'est pas activée ou qu'une colonne XML activée n'existe pas, cette option
n'est pas disponible. Une colonne désactivée ne peut plus contenir de
documents XML. Pour pouvoir retirer une table XML, vous devez d'abord
désactiver la colonne XML qu'elle contient. Si vous ne le faites pas,
l'Extension XML conserve les tables annexes qu'elle a créées et l'entrée de
colonne XML dans la table d'usage XML.
- Suivant
- Ouvre la fenêtre sélectionnée pour ajouter, activer ou désactiver une
colonne XML.
- Fin
- Disponible lorsque vous avez fini d'utiliser la
colonne.
- Annulation
- Annule l'assistant et revient au tableau de
bord.
- Nom de la table
- Tapez le nom de la table ou sélectionnez-le
dans la liste des DTD disponibles. La table doit être définie pour pouvoir
ajouter une colonne XML.
Par exemple :
SALES_DB
- Nom de la colonne
- Tapez le nom à utiliser pour la colonne XML.
Par exemple :
ORDER
- |Type de données
- Sélectionnez un type de données dans la liste des types disponibles
(par exemple, XMLCLOB, XMLVARCHAR ou XMLFILE). Par exemple :
XMLVARCHAR
- Précédent
- Ouvre la fenêtre Sélection d'une tâche que vous
avez affichée pour utiliser les colonnes XML.
- Fin
- Ajoute la colonne XML et revient au tableau de bord.
- Annulation
- Annule l'assistant et revient au tableau de
bord.
- Nom de la table
- Tapez le nom de la table contenant une
colonne XML ou sélectionnez-le dans la liste des tables disponibles. Par exemple :
SALES_TAB
- Nom de la colonne
- Tapez le nom d'une colonne XML de
la table ou sélectionnez-le dans la liste des colonnes disponibles. Par exemple :
ORDER
- Nom de fichier DAD
- Tapez l'emplacement du fichier DAD qui mappe le document XML vers la
colonne et les tables annexes XML, ou cliquez sur ... pour parcourir
la liste des DAD disponibles. Par exemple :
c:\dxx\samples\dad\getstart.dad
- Espace table
- Vous pouvez taper le nom d'un espace table existant pour les tables
annexes associées à la colonne XML. Si vous laissez cette zone à blanc,
l'Extension XML utilise un espace table par défaut.
- Vue par défaut
- Vous pouvez taper le nom d'une vue par défaut qui permet d'effectuer
la jointure de la table XML et de toutes ses tables annexes.
- |ID racine
- Action recommandée, mais facultative : Tapez le nom de colonne de la
clé primaire pour associer toutes les tables annexes à la table
d'application. Si vous n'indiquez aucun ID racine (ROOT ID), l'Extension XML
ajoute une colonne DXXROOT_ID dans la table et génère un identificateur par
défaut.
- Précédent
- Ouvre la fenêtre Sélection d'une tâche que vous
avez affichée pour utiliser les colonnes XML.
- Fin
- Ajoute la colonne XML et revient au tableau de bord.
Pour activer la colonne, l'Extension XML détermine si la table XML est
associée à une clé primaire, crée les tables annexes indiquées dans le
fichier DAD et génère une vue par défaut de la table XML et des tables
annexes.
- Annulation
- Annule l'assistant et revient au tableau de bord.
- Nom de la table
- Tapez le nom de la table contenant la
colonne XML ou sélectionnez-le dans la liste des tables disponibles.
- Nom de la colonne
- Tapez le nom d'une colonne de la table ou
sélectionnez-le dans la liste des colonnes disponibles.
- Précédent
- Ouvre la fenêtre Sélection d'une tâche que vous
avez affichée pour utiliser les colonnes XML.
- Fin
- Désactive la colonne XML et revient au tableau de bord.
Une colonne XML désactivée ne peut plus contenir de documents XML.
- Annulation
- Annule l'assistant et revient au tableau de
bord.
- A partir du tableau de bord, cliquez sur Utilisation des colonnes XML.
La fenêtre Sélection d'une tâche s'affiche.
- Cliquez sur Ajout d'une colonne XML. La fenêtre Ajout d'une colonne XML s'affiche.
- Tapez le nom de la table à modifier ou sélectionnez-le dans la liste Nom de la table.
- Dans la zone Nom de la colonne, tapez le nom de la colonne à
ajouter.
- Dans la liste |Type de données, sélectionnez un type UDT pour la colonne.
- Cliquez sur Fin pour ajouter la colonne de type XML.
- A partir du tableau de bord, cliquez sur Utilisation des colonnes
XML pour afficher les tâches liées aux colonnes de l'Extension XML. La fenêtre Sélection d'une
tâche s'affiche.
- Cliquez sur |Activation d'une colonne XML puis sur Suivant,
pour activer une colonne de table existant dans la base de données.
- Dans la zone Nom de la table, sélectionnez la table qui
contient la colonne XML.
- Dans la zone Nom de la colonne, sélectionnez la colonne à activer. Il doit s'agir d'une colonne existante de type XML.
- Tapez le chemin et le nom du fichier DAD dans la zone Nom de
fichier DAD, ou cliquez sur ... pour parcourir la liste des DAD
disponibles.
- Vous pouvez également indiquer dans la zone Espace table le
nom d'un espace table existant.
L'espace table contient les tables annexes générées par l'Extension XML.
Les tables annexes sont créées dans l'espace table que vous précisez, ou dans
l'espace table par défaut, si vous n'en indiquez aucun.
- Vous pouvez également indiquer dans la zone Vue par défaut le
nom de la vue par défaut.
Si vous l'indiquez, la vue par défaut est automatiquement générée lors de
la création de la colonne. Elle effectue la jointure de la table XML et de
toutes ses tables annexes.
- Vous pouvez également indiquer dans la zone ID racine le nom
de colonne de la clé primaire figurant dans la table d'application. Cette
méthode est recommandée.
L'Extension XML utilise l'ID racine en tant qu'identificateur unique pour
associer toutes les tables annexes à la table d'application. Si
vous n'indiquez aucun ID racine (root), l'Extension XML ajoute une colonne
DXXROOT_ID dans la table d'application et génère un identificateur par
défaut.
- Cliquez sur Fin pour activer la colonne XML, créer les tables
annexes et revenir au tableau de bord.
- Si l'activation de la colonne aboutit, un message d'information l'indique.
- Si l'activation de la colonne échoue, un message d'erreur
s'affiche. Corrigez les valeurs dans les zones d'entrée jusqu'à
l'aboutissement de l'opération.
- A partir du tableau de bord, cliquez sur Utilisation des colonnes
XML pour afficher les tâches liées aux colonnes de l'Extension XML. La fenêtre Sélection d'une
tâche s'affiche.
- Cliquez sur | Désactivation d'une colonne puis sur
Suivant dans la fenêtre Sélection d'une tâche, pour désactiver une
colonne de table existant dans la base de données.
- Dans la zone Nom de la table, sélectionnez la table qui
contient la colonne XML.
- Dans la zone Nom de la colonne, sélectionnez la colonne à désactiver.
- Cliquez sur Fin.
- Si la désactivation de la colonne aboutit, un message d'information l'indique.
- Si la désactivation de la colonne échoue, un message d'erreur s'affiche.
Corrigez les valeurs dans les zones d'entrée jusqu'à l'aboutissement de
l'opération.
A partir de cet assistant, vous pouvez activer ou désactiver des
collections XML.
- Activation d'une collection XML
- Sélectionnez cette option pour ouvrir la fenêtre Activation d'une
collection XML. L'activation d'une colonne XML lance l'analyse du fichier DAD
pour identifier les tables et les colonnes liées aux documents XML. Elle
déclenche également l'enregistrement des données de contrôle. Cette option n'est disponible que
si la base de données est activée et qu'il existe un fichier DAD.
- Désactivation d'une collection XML
- Sélectionnez cette option pour ouvrir la fenêtre Désactivation d'une
collection qui permet de retirer les marqueurs identifiant les tables et les
colonnes au sein d'une collection XML. Si la collection n'est pas activée,
cette option n'est pas disponible.
- Suivant
- Ouvre la fenêtre sélectionnée pour activer ou
désactiver une collection XML.
- Fin
- Disponible lorsque vous avez terminé d'utiliser la collection.
- Annulation
- Annule l'assistant et revient au tableau de
bord.
- Nom de la collection
- Tapez le nom de la collection XML à activer.
- Nom de fichier DAD
- Tapez le nom du fichier DAD qui mappe la structure du document XML
vers les tables DB2 utilisées pour les opérations de composition ou de
décomposition, ou cliquez sur ... pour parcourir la liste des DAD
disponibles.
- ...
- Ouvre une fenêtre Recherche dans laquelle vous pouvez
sélectionner un nom de fichier DAD existant.
- Espace table
- Tapez le nom d'un espace table déjà créé, s'il en existe un. Cet espace table contiendra
les nouvelles tables DB2 générées pour les opérations de composition ou de
décomposition.
- Précédent
- Ouvre la fenêtre Sélection d'une tâche affichée
pour utiliser les collections XML.
- Fin
- Active la collection XML et revient au tableau de bord.
Pour activer la collection, l'Extension XML identifie les tables et les
colonnes du document XML à l'aide du fichier DAD et enregistre les données de
contrôle dans la table XML_USAGE.
- Annulation
- Annule l'assistant et revient au tableau de
bord.
- Nom de la collection
- Sélectionnez dans la liste des collections le nom de la collection XML à désactiver.
- Précédent
- Ouvre la fenêtre Sélection d'une tâche affichée
pour utiliser les collections XML.
- Fin
- Désactive la collection XML et revient au tableau de bord.
Pour désactiver une collection, l'Extension XML retire les marqueurs
identifiant les tables et les colonnes au sein d'une collection XML.
- Annulation
- Annule l'assistant et revient au tableau de
bord.
- A partir du tableau de bord, cliquez sur Utilisation des collections XML. La
fenêtre Sélection d'une tâche s'affiche.
- Cliquez sur |Activation d'une collection XML puis sur Suivant. La fenêtre
Activation d'une collection s'affiche.
- Dans la zone Nom de la collection, sélectionnez le nom de la
collection à activer.
- Tapez le nom du fichier DAD dans la zone Nom de fichier DAD,
ou cliquez sur ... pour parcourir la liste des DAD disponibles.
- Vous pouvez également indiquer dans la zone Espace table le
nom d'un espace table existant.
Cet espace table contiendra les nouvelles tables DB2 générées pour les
opérations de décomposition.
- Cliquez sur Fin pour activer la collection et revenir au
tableau de bord.
- Si l'activation de la collection aboutit, un message d'information
l'indique.
- Si l'activation de la collection échoue, un message d'erreur
s'affiche. Corrigez les valeurs dans les zones d'entrée jusqu'à
l'aboutissement de l'opération.
- A partir du tableau de bord, cliquez sur Utilisation des collections
XML pour afficher les tâches liées aux collections de l'Extension XML. La
fenêtre Sélection d'une tâche s'affiche.
- Cliquez sur Désactivation d'une collection XML puis sur
Suivant pour désactiver une collection XML. La fenêtre
Désactivation d'une collection s'affiche.
- Dans la zone Nom de la collection, tapez le nom de la collection à désactiver.
- Cliquez sur Fin pour désactiver la collection et revenir au tableau de bord.
- Si la désactivation de la collection aboutit, un message d'information
l'indique.
- Si la désactivation de la collection échoue, un message d'erreur
s'affiche. Corrigez les valeurs dans les zones d'entrée jusqu'à
l'aboutissement de l'opération.