XML Extender

A descrição do parâmetro override para os procedimentos armazenados a seguir foi alterado:

Parâmetros

Tabela 42. Substituição de Parâmetros para os Procedimentos Armazenados dxxGenXML, dxxGenXMLClob, dxxRetrieveXML e dxxRetrieveXMLClob
Parâmetro	Descrição	Parâmetro IN/OUT
`override`	Substitui a condição no arquivo DAD. O valor de entrada é baseado no `overrideType`. NO_OVERRIDE: Uma string NULL. SQL_OVERRIDE: Uma instrução SQL válida. A utilização do `overrideType` requer que o mapeamento SQL seja utilizado no arquivo DAD. A instrução de entrada substitui o SQL_stmt no arquivo DAD. XML_OVERRIDE: Uma string que contenha uma ou mais expressões que sejam separadas pela palavra AND. A utilização do `overrideType` requer que o mapeamento de RDB_node seja utilizado no arquivo DAD.	IN

Decompondo Documentos XML em Dados do DB2 UDB

A decomposição utiliza mapeamento de RDB_node para especificar como um documento XML é decomposto nas tabelas DB2 UDB, extraindo o os valores do elemento e do atributo e armazenando-os nas linhas da tabela. Os valores de cada documento XML são armazenados em uma ou mais tabelas DB2 UDB. Cada tabela pode ter um máximo de 10240 linhas decompostas de cada documento.

Por exemplo, se um documento XML for decomposto em cinco tabelas, cada uma delas pode ter até 10240 linhas para cada documento particular. Se a tabela tiver linhas de documentos múltiplos, ela pode ter até 10240 linhas para cada documento.

A utilização de elementos com ocorrência múltipla (elementos com caminhos locais que podem ocorrer mais de uma vez na estrutura XML) afeta o número de linhas. Por exemplo, um documento que contenha um elemento <Part> que ocorra 20 vezes, pode ser decomposto como 20 linhas na tabela. Ao utilizar elementos com ocorrência múltipla, considere que o máximo de 10240 linhas pode ser decomposto em uma tabela a partir de um documento único.

Decompondo Documentos Maiores que 1 MB

Não é necessário eliminar e recriar o procedimento armazenado dxxShredXML para decompor documentos maiores que 1 MB. Para decompor documentos maiores que 1 MB, chame o procedimento armazenado dxxShredXML100MB, que pode compartilhar documentos até 100 MB. Embora dxxShredXML100MB possa manipular documentos grandes, pode ser necessário ampliar outros recursos para que o procedimento armazenado seja concluído com êxito. Para chamar o procedimento armazenado através do programa de amostra dxxshrd, utilize o novo sinalizador "-large". Por exemplo:

Se sua versão do DB2 Universal Database for anterior à Versão 8 FixPak 6, será necessário executar dxxMigv para migrar o XML Extender para o nível atual para executar o novo procedimento armazenado.

Configurando UDFs XML do MQ com o XML Extender

Você deve configurar e ativar UDFs (User-Defined Functions) XML do MQ antes de utilizá-las.

Pré-requisitos

Instale os UDFs seguindo o procedimento no tópico "Instalando funções do DB2 WebSphere MQ", que é encontrado no Centro de Informações ou no IBM DB2 Information Integrator Application Developer's Guide.

Procedimento

Para configurar e ativar UDFs XML do MQ com o XML Extender:

Abra uma janela do prompt de comandos do DB2.
Conecte-se ao banco de dados que utilizará as UDFs XML do MQ digitando o seguinte comando:
```
db2 connect to <banco de dados>
```
Mude para o diretório bnd no caminho em que foi instalado o DB2 Universal Database, como:
- SQLLIB/bnd (Linux e UNIX)
- C:\Arquivos de programas\IBM\SQLLIB\bnd (Windows)
Ligue o banco de dados ao XML Extender utilizando o seguinte comando:
```
db2 bind @dbxxbind.lst
```
Ligue o banco de dados para o XML Extender utilizar as UDFs XML do MQ utilizando o seguinte comando:
```
db2 bind mqxml.bnd
```
Ligue o banco de dados à CLI utilizando o seguinte comando:
```
db2 bind @db2cli.lst
```

Variável de Ambiente DB2DXX_MIN_TMPFILE_SIZE do XML Extender

O DB2 XML Extender pode colocar documentos grandes em arquivos temporários para evitar utilizar uma grande quantidade de memória durante o processamento. Em sistemas com grandes quantidades de memória física, você pode evitar mover documentos para arquivos temporários, reduzindo a quantidade de atividade de Entrada/Saída. A variável de ambiente DB2DXX_MIN_TMPFILE_SIZE instrui o XML Extender a utilizar buffers de memória, em vez de arquivos temporários, para processar documentos menores do que o valor especificado. A variável é aplicável apenas no servidor. Se vários nós físicos participarem de um ambiente particionado, a variável poderá ser definida de forma diferente em cada nó, refletindo com precisão a quantidade de memória instalada em cada computador. Se a variável de ambiente não estiver definida, documentos com mais de 128 KB serão colocados automaticamente nos arquivos temporários durante o processamento. Documentos com menos de 128 KB serão processados na memória.

Redefinição de UDT DB2XML.XMLVarchar

Você pode redefinir o UDT (User-Defined Type) DB2XML.XMLVarchar até 32 KB. Para alterar o tamanho de um UDT XMLVarchar, crie o UDT antes de ativar o banco de dados para o XML Extender.