IBM Books

Extension XML Administration et programmation

Recherche structurelle avec l'Extension Texte

Lorsque Extension XML exécute une recherche sur la structure d'un document XML, elle parcourt les valeurs d'éléments et d'attributs converties en données de type général, mais n'examine pas le texte. DB2 UDB Extension Texte permet d'exécuter des recherches structurelles ou intégrales sur une colonne activée pour XML. L'Extension Texte accepte la recherche de documents XML à partir de DB2 UDB version 6.1.

Recherche structurelle
Examine les chaînes texte en fonction de l'arborescence du document XML. Par exemple, si la structure de votre document est /Order/Customer/Name et que vous voulez rechercher la chaîne de caractères "IBM" dans le sous-élément <Customer>, vous pouvez lancer une recherche structurelle. Le document peut contenir la chaîne IBM dans un sous-élément <Comment> ou dans un nom de produit, mais la recherche structurelle ne la recherche que dans les éléments indiqués. Dans cet exemple, vous n'obtenez que les documents pour lesquels la chaîne IBM est trouvée dans le sous-élément </Order/Customer/Name>. Ceux qui contiennent la chaîne IBM dans d'autres éléments ne sont pas renvoyés.

Recherche intégrale
Examine les chaînes texte dans toute la structure du document, indépendamment des éléments ou des attributs. Ainsi dans l'exemple précédent, tous les documents contenant la chaîne de caractères IBM sont renvoyés, quel que soit l'emplacement de l'occurrence trouvée.

Pour pouvoir utiliser la fonction recherche de l'Extension Texte, vous devez installer DB2 Extension Texte, puis activer votre base de données et vos tables conformément aux instructions ci-dessous. Pour apprendre à utiliser la fonction recherche de l'Extension Texte, reportez-vous au chapitre sur l'exécution de recherches avec les fonctions UDF de l'Extension Texte, dans le manuel DB2 UDB Extension Texte - Administration et programmation.

Activation d'une colonne XML pour l'Extension Texte

Supposons que vous ayez préparé la base de données en vue de son utilisation avec XML. Suivez les étapes ci-après pour activer l'Extension Texte afin d'examiner le contenu d'une colonne activée pour XML. Soient la base de données SALES_DB, la table ORDER et deux colonnes XML XVARCHAR et XCLOB.

  1. Dans le fichier install.txt figurant sur le CD des Extensions, consultez la procédure d'installation de l'Extension Texte.
  2. Entrez la commande txstart à partir de l'un des emplacements suivants :
  3. Ouvrez la fenêtre de ligne de commande de l'Extension Texte. Cette étape suppose que vous disposez d'une base de données SALES_DB et d'une table ORDER qui contient deux colonnes XML XVARCHAR et XCLOB. Vous devez exécuter les programmes exemples dans dxx\samples\c.
  4. Connectez-vous à la base de données. A l'invite db2tx, tapez :
    'connect to SALES_DB' 
    
  5. Activez la base de données pour l'Extension Texte.

    A partir de l'invite db2tx, tapez :

    'enable database'
    
  6. Pour activer les colonnes dans la table XML pour l'Extension Texte, définissez les types de données associés au document XML, la langue, les pages de codes, ainsi que d'autres informations relatives à la colonne.
  7. Vérifiez l'état de l'index.
  8. Définissez le modèle de document XML dans un fichier d'initialisation de modèles de documents desmodel.ini. Ce fichier se trouve dans /db2tx/txins000 sous UNIX et dans \instance\\db2tx\txins000 sous Windows NT. Par exemple, pour le fichier textmodel.ini :
    ;list of document models
    [MODELS]
    modelname=Order
     
    ; an 'Order' document model definition
    ; left side = section name identifier
    ; right side = section name tag
     
    [Order]
    Order = /Order
    Order/Customer/Name = /Order/Customer/Name
    Order/Customer/Email = /Order/Customer/Email
    Order/Part/@color = /Order/Part/@color
    Order/Part/Shipment/ShipMode = /Order/Part/Shipment/ShipMode
     
    

Recherche de texte avec l'Extension Texte

La fonction de recherche de l'Extension Texte est tout à fait compatible avec la fonction de recherche structurelle de l'Extension XML. La méthode recommandée consiste à créer une requête qui exécute une recherche sur les éléments ou les attributs du document et examine le contenu élémentaire ou les valeurs d'attributs avec l'Extension Texte.

Exemple : Les instructions ci-après examinent le texte d'un document XML avec l'Extension Texte. A l'invite DB2, tapez :

'connect to SALES_DB'   
'select xvarchar from order where db2tx.contains(varcharhandle, 
	 'model Order section(Order/Customer/Name) "Motors"')=1'   
'select xclob from order where db2tx.contains(clobhandle, 
	 'model Order section(Order/Customer/Name) "Motors"')=1'

L'Extension Texte contient () des fonctions de recherche UDF.

Cet exemple n'illustre pas toutes les étapes nécessaires pour exécuter des recherches dans des données de colonne avec l'Extension Texte. Pour plus d'informations, reportez-vous au chapitre sur l'exécution de recherches avec les fonctions UDF de l'Extension Texte, dans le manuel DB2 UDB Extension Texte - Administration et programmation.


[ Début de page | Page précédente | Page suivante | Table des matières | Index ]