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.
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.
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.
'connect to SALES_DB'
A partir de l'invite db2tx, tapez :
'enable database'
'enable text column order xvarchar function db2xml.varchartovarchar handle varcharhandle ccsid 850 language us_english format xml indextype precise indexproperty sections_enabled documentmodel (Order) updateindex update'
'enable text column order xclob function db2xml.clob handle clobhandle ccsid 850 language us_english indextype precise updateindex update'
;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
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.