XML Extender

参数

表 42. dxxGenXML、dxxGenXMLClob、dxxRetrieveXML 和 dxxRetrieveXMLClob 存储过程的 Override 参数
参数	描述	IN/OUT 参数
`override`	覆盖 DAD 文件中的条件。输入值基于 `overrideType`。 NO_OVERRIDE：空字符串。 SQL_OVERRIDE：有效 SQL 语句。使用此 `overrideType` 需要在 DAD 文件中使用 SQL 映射。输入 SQL 语句覆盖 DAD 文件中的 SQL_stmt。 XML_OVERRIDE：包含一个或多个表达式的字符串，这些表达式用字 AND 分隔。使用此 `overrideType` 需要在 DAD 文件中使用 RDB_node 映射。	IN

将 XML 文档分解成 DB2 UDB 数据

分解使用 RDB_node 映射来指定如何通过抽取元素和属性值并将它们存储在表行中来将 XML 文档分解成 DB2 UDB 表。将每个 XML 文档中的值存储在一个或多个 DB2 UDB 表中。每个表最多可以拥有从每个文档分解出来的 10240 行。

例如，如果一个 XML 文档分解成五个表，则这五个表中的每个表最多可以拥有该特定文档的 10240 行。如果该表拥有多个文档的行，则对于每个文档，它最多可以拥有 10240 行。

使用多次出现的元素（元素的位置路径在 XML 结构中可以多次出现）将影响行数。例如，如果一个文档包含出现 20 次的元素 <Part>，则该文档可以在一个表中分解为 20 行。使用多次出现的元素时，考虑从单个文档最多可以将 10240 行分解到一个表中。

分解大于 1 MB 的文档

不需要通过先废弃然后重新创建存储过程 dxxShredXML 来分解大于 1 MB 的文档。要分解大于 1 MB 的文档，只需调用存储过程 dxxShredXML100MB，它可以将文档分解成最大为 100 MB。尽管 dxxShredXML100MB 可以处理大型文档，但是可能需要增大其他资源才能成功地完成该存储过程。要通过样本程序 dxxshrd 来调用存储过程，使用新标志“-large”。例如：

如果 DB2 通用数据库^(TM)的版本早于版本 8 修订包 6，则必须运行 dxxMigv 来将 XML Extender 迁移至当前级别，这样才能运行新的存储过程。

使用 XML Extender 配置 MQ XML UDF

必须配置并启用 MQ XML 用户定义的函数（UDF）才能使用它们。

先决条件

通过遵循『安装 DB2^(R) WebSphere^(R) MQ 函数』主题中的过程来安装 UDF，可在信息中心或《IBM^(R) DB2 Information Integrator 应用程序开发者指南》中找到该主题。

过程

要使用 XML Extender 配置和启用 MQ XML UDF：

打开 DB2 命令提示符窗口。
通过输入以下命令连接至将使用 MQ XML UDF 的数据库：
```
db2 connect to <database>
```
切换至安装 DB2 通用数据库的路径中的 bnd 目录，例如：
- SQLLIB/bnd（Linux^(TM) 和 UNIX^(R)）
- C:\Program Files\IBM\SQLLIB\bnd（Windows^(R)）
使用以下命令将数据库绑定至 XML Extender：
```
db2 bind @dbxxbind.lst
```
使用以下命令绑定数据库以便 XML Extender 使用 MQ XML UDF：
```
db2 bind mqxml.bnd
```
使用以下命令将数据库绑定至 CLI：
```
db2 bind @db2cli.lst
```

XML Extender 环境变量 DB2DXX_MIN_TMPFILE_SIZE

DB2 XML Extender 可将大型文档将在临时文件中以避免在处理时使用大量内存。在带有大量物理内存的系统上，可避免将文档移至临时文件以降低输入／输出活动量。环境变量 DB2DXX_MIN_TMPFILE_SIZE 指示 XML Extender 使用内存缓冲区（而不是临时文件）来处理小于指定值的文档。该变量仅在服务器上适用。如果多个物理节点参与分区环境，可在每个节点上以不同方式设置该变量以反映安装在每台计算机上的内存量。如果未设置环境变量，则大于 128 KB 的文档在处理期间将自动放置在临时文件中。小于 128 KB 的文档将在内存中处理。

DB2XML.XMLVarchar UDT 重新定义