XML Extender

La descripción del parámetro override ha cambiado para los procedimientos almacenados siguientes:

Parámetros

Tabla 42. Parámetro override de los procedimientos almacenados dxxGenXML, dxxGenXMLClob, dxxRetrieveXML y dxxRetrieveXMLClob
Parámetro	Descripción	Parámetro de entrada/salida
`override`	Anula la condición especificada en el archivo DAD. El valor de entrada está basado en `overrideType`. NO_OVERRIDE: una cadena de caracteres nula. SQL_OVERRIDE: una sentencia de SQL válida. Si se utiliza este `overrideType`, es necesario utilizar la correlación SQL en el archivo DAD. La sentencia de SQL de entrada prevalece sobre la sentencia SQL_stmt especificada en el archivo DAD. XML_OVERRIDE: cadena de caracteres que contiene una o más expresiones separadas por la palabra AND. Si se utiliza este `overrideType`, es necesario utilizar la correlación de nodo RDB en el archivo DAD.	Entrada

Descomposición de documentos XML en datos de DB2 UDB

La descomposición utiliza la correlación de nodo RDB para especificar cómo se descompone un documento XML en tablas de DB2 UDB mediante la extracción de valores de elementos y atributos y su almacenamiento en filas de tabla. Los valores procedentes de cada documento XML se almacenan en una o más tablas de DB2 UDB. Cada tabla puede tener un máximo de 10240 filas descompuestas de cada documento.

Por ejemplo, si un documento XML se descompone en cinco tablas, cada tabla puede tener un máximo de 10240 filas para ese documento concreto. Si la tabla tiene filas correspondientes a varios documentos, puede tener un máximo de 10240 filas para cada documento.

La utilización de elementos de aparición múltiple (elementos cuyas vías de ubicación pueden aparecer más de una vez en la estructura XML) afecta al número de filas. Por ejemplo, un documento que contenga un elemento <Part> que aparece 20 veces, se podría descomponer en forma de 20 filas de una tabla. Si utiliza elementos de aparición múltiple, tenga en cuenta que se puede descomponer un máximo de 10240 filas de una tabla para un documento individual.

Descomposición de documentos más grandes de 1 MB

No es necesario descartar y volver a crear el procedimiento almacenado dxxShredXML para descomponer documentos de más de 1 MB. Para descomponer documentos de más de 1 MB, invoque el procedimiento almacenado dxxShredXML100MB, que puede fragmentar documentos de un máximo de 100 MB. Aunque dxxShredXML100MB puede manejar documentos grandes, puede que deba aumentar otros recursos para que el procedimiento almacenado se complete satisfactoriamente. Para invocar el procedimiento almacenado mediante el programa de ejemplo dxxshrd, utilice el nuevo distintivo "-large". Por ejemplo:

Si la versión de DB2 Universal Database es anterior a la Versión 8 FixPak 6, debe ejecutar dxxMigv para migrar XML Extender al nivel actual para ejecutar el nuevo procedimiento almacenado.

Configuración de las UDF XML de MQ con XML Extender

Debe configurar y habilitar funciones definidas por el usuario (UDF) XML de MQ para poderlas utilizar.

Requisitos previos

Instale las UDF siguiendo el procedimiento del tema "Instalación de funciones de DB2 WebSphere MQ", que puede encontrar en el Centro de información o en el manual IBM DB2 Information Integrator Application Developer's Guide.

Procedimiento

Para configurar y habilitar las UDF XML de MQ con XML Extender:

Abra una ventana de indicador de mandatos de DB2.
Conecte con la base de datos que utilizará las UDF XML de MQ entrando el siguiente mandato:
```
db2 connect to <basedatos>
```
Cambie al directorio bnd dentro de la vía de acceso en la que ha instalado DB2 Universal Database, como por ejemplo:
- SQLLIB/bnd (Linux y UNIX)
- C:\Archivos de programa\IBM\SQLLIB\bnd (Windows)
Vincule la base de datos a XML Extender mediante el siguiente mandato:
```
db2 bind @dbxxbind.lst
```
Vincule la base de datos para que XML Extender utilice las UDF XML de MQ mediante el siguiente mandato:
```
db2 bind mqxml.bnd
```
Vincule la base de datos a la CLI mediante el siguiente mandato:
```
db2 bind @db2cli.lst
```

Variable de entorno de XML Extender DB2DXX_MIN_TMPFILE_SIZE

DB2 XML Extender puede colocar documentos grandes en archivos temporales para evitar que se utilice una gran cantidad de memoria durante su proceso. En los sistemas con una elevada cantidad de memoria física, puede evitar que los documentos se muevan a archivos temporales, lo que reduce el número de actividades de Entrada/Salida. La variable de entorno DB2DXX_MIN_TMPFILE_SIZE indica a XML Extender que utilice almacenamientos intermedios de memoria, en lugar de archivos temporales, para procesar los documentos de tamaño inferior al valor especificado. La variable sólo tiene aplicación en el servidor. Si diversos nodos físicos participan en un entorno particionado, la variable puede establecerse de manera distinta en cada nodo, a fin de reflejar exactamente la cantidad de memoria instalada en cada sistema. Si no se establece la variable de entorno, los documentos que superen los 128 KB se colocarán automáticamente en archivos temporales durante el proceso. Los documentos de menos de 128 KB se procesarán en memoria.

Redefinición del UDT DB2XML.XMLVarchar

Puede redefinir el tipo definido por el usuario (UDT) DB2XML.XMLVarchar hasta un máximo de 32 KB. Para cambiar el tamaño de un UDT XMLVarchar, cree el UDT antes de habilitar la base de datos para XML Extender.