Extension XML

La description du paramètre substitution pour les procédures mémorisées a été modifiée :

Paramètres

Tableau 42. Paramètre de substitution pour les procédures mémorisées dxxGenXML, dxxGenXMLClob, dxxRetrieveXML et dxxRetrieveXMLClob
Paramètre	Description	Paramètre IN/OUT
`substitution`	Se substitue à la condition du fichier de définition d'accès au document (DAD). La valeur saisie se base sur le paramètre `TypeDeSubstitution`. NO_OVERRIDE : chaîne vide. SQL_OVERRIDE : instruction SQL valide. L'utilisation de ce paramètre `TypeDeSubstitution` repose sur l'utilisation de la mise en correspondance SQL dans le fichier DAD. L'instruction SQL d'entrée se substitue au paramètre SQL_stmt du fichier DAD. XML_OVERRIDE : chaîne qui contient une ou plusieurs expressions qui sont séparées par le mot ET. L'utilisation de ce paramètre `TypeDeSubstitution` repose sur l'utilisation de la mise en correspondance du noeud_RDB dans le fichier DAD.	IN

Décomposition des documents XML en données DB2 UDB

La décomposition utilise la mise en correspondance du noeud_RDB pour indiquer la façon dont un document XML est décomposé en tables DB2 par l'extraction des valeurs d'attribut et d'élément et leur stockage dans des lignes de table. Les valeurs de chaque document XML sont enregistrées dans une ou plusieurs tables DB2 UDB. Chaque table peut contenir un maximum de 10240 lignes décomposées de chaque document.

Par exemple, si un document XML est décomposé en cinq tables, chacune des cinq tables peut comprendre jusqu'à 10 240 lignes pour ce document donné. Si la table contient des lignes pour de multiples documents, elle peut contenir jusqu'à 10 240 lignes pour chaque document.

L'utilisation d'éléments à occurrences multiples (éléments avec des chemins d'emplacement qui peuvent se produire plusieurs fois dans la structure XML) a une incidence sur le nombre de lignes. Par exemple, un document qui contient un élément <Part> qui se produit 20 fois, peut se décomposer en 20 lignes dans une table. Lorsque vous utilisez des éléments à occurrences multiples, vous devez considérer qu'un maximum de 10 240 lignes peut être décomposé dans une table à partir d'un seul document.

Décomposition de documents de plus de 1 Mo

Il n'est pas nécessaire de supprimer et de recréer la procédure mémorisée dxxShredXML pour décomposer des documents de plus de 1 Mo. Il suffit d'appeler la procédure mémorisée dxxShredXML100MB, capable de diviser des documents de 100 Mo au maximum. Bien que dxxShredXML100MB puisse traiter des documents volumineux, vous devrez peut-être augmenter les autres ressources pour permettre l'exécution correcte de cette procédure mémorisée. Pour appeler la procédure mémorisée via le programme exemple dxxshrd, utilisez le nouveau marqueur "-large". Par exemple :

Si votre version de DB2 Universal Database est antérieure à la version 8 FixPack 6, exécutez dxxMigv pour faire migrer XML Extender vers le niveau actuel et permettre l'exécution de la procédure mémorisée.

Configuration des fonctions UDF MQ XML avec Extension XML

Vous devez configurer et activer l'utilisateur XML MQ -Fonctions UDF avant de pouvoir les utiliser.

Conditions préalables

Installez les fonctions UDF en suivant la procédure décrite dans la rubrique "Installation des fonctions UDF DB2 WebSphere MQ", accessible via le Centre de documentation ou dans le guide IBM DB2 Information Integrator Application Developer.

Procédure

Pour configurer et activer les fonctions UDF avec Extension XML :

Ouvrez une fenêtre d'invite dans DB2.
Connectez-vous à la base de données utilisant les fonctions UDF MQ XML en entrant la commande suivante :
```
db2 connect to <database>
```
Affichez le répertoire bnd dans le chemin d'installation de DB2 Universal Database, par exemple :
- SQLLIB/bnd (Linux et UNIX)
- C:\Program Files\IBM\SQLLIB\bnd (Windows)
Associez la base de donénes à Extension Spatiale à l'aide de la commande suivante :
```
db2 bind @dbxxbind.lst
```
Associez la base de données pour qu'Extension spatiale utiliser les fonctions UDF MQ XML à l'aide de la commande suivante :
```
db2 bind mqxml.bnd
```
Associez la base de donénes à CLI à l'aide de la commande suivante :
```
db2 bind @db2cli.lst
```

Variable d'environnement DB2DXX_MIN_TMPFILE_SIZE Extension Spatiale

L'Extension XML de DB2 peut placer des documents volumineux dans des fichiers temporaires pour éviter d'utiliser trop de mémoire au cours du traitement. Sur les systèmes dotés de beaucoup de mémoire physique, il est possible d'éviter de déplacer des documents dans des fichiers temporaires, ce qui réduit l'activité d'entrée-sortie. La variable d'environnement variable DB2DXX_MIN_TMPFILE_SIZE indique à l'Extension XML d'utiliser des tampons de mémoire plutôt que des fichiers temporaires, pour le traitement de documents plus petits que la valeur spécifiée. Cette variable est applicable uniquement sur le serveur. Si plusieurs noeuds physiques participent à un environnement partitionné, cette variable peut être définie différemment sur chaque noeud, reflétant précisément la quantité de mémoire installée sur chacun d'entre eux. Si cette variable d'environnement n'est pas définie, les documents dont la taille est supérieure à 128 ko seront automatiquement placés dans des fichiers temporaires au cours du traitement et deux inférieurs à 128 ko seront traités en mémoire.

Redéfinition UDT DB2XML.XMLVarchar

Vous pouvez redéfinir le type UDT (UDT) DB2XML.XMLVarchar jusqu'à 32 ko. Pour changer la taille du type UDT XMLVarchar, créez l'UDT avant d'activer la base de données pour l'Extension XML.