XML Extender 管理向导帮助
连接至数据库
使用“XML Extender 管理 LaunchPad”
字段和控件任务
启用或禁用数据库
任务:启用数据库
任务:禁用数据库
导入 DTD
字段和控件
任务:导入 DTD
使用 DAD 文件
字段和控件
指定 DAD - 所有类型的第 1 步
选择验证 - 所有类型的第 2 步
辅助表 - XML 列类型的第 3 步
指定文本 - SQL 映射或 RDB 节点映射类型的第 3 步
指定 SQL 语句 - SQL 映射类型的第 4 步
映射 SQL - SQL 映射类型的第 5 步
映射 RDB 节点 - RDB 节点映射类型的第 4 步
保存 DAD - 所有类型的最后一步
任务
创建或编辑 XML 列的 DAD
创建或编辑 XML 集合的 DAD
使用 XML 列
字段和控件
选择任务(对于列)
添加 XML 列
启用 XML 列
禁用 XML 列
任务
添加 XML 列
启用 XML 列
禁用 XML 列
使用 XML 集合
字段和控件
选择任务(对于集合)
启用 XML 集合
禁用 XML 集合
任务
启用 XML 集合
禁用 XML 集合
从此向导,可连接至包含或将包含 XML 数据的数据库。
- 地址
- 输入想要连接至的 JDBC 数据库的名称或从列表中选择地址。该向导执行该数据库中的实时任务。如果从列表中进行选择,则上一个与此地址相关联的用户标识和 JDBC 驱动程序显示在下列字段中。
此字段是必需的。
该地址具有以下语法:
|对于单机配置(推荐):
jdbc:db2:database_name
其中:
- database_name
- 您正在连接至和存储 XML 文档的数据库。
示例:
jdbc:db2:sales_db
对于网络配置:
jdbc:db2://|host:port_number/database_name
其中:
- |host
- |为 XML Extender 所在的服务器的名称。
- port_number
- 用来连接至服务器的端口号。要确定该端口号,在服务器上的 DB2 命令行中输入下列命令:
db2jstrt port#
- database_name
- 您正在连接至和存储 XML 文档的数据库。
示例:
jdbc:db2://host1.ibm.com/sales_db
- 用户标识
- 输入或验证用来存取数据库的用户标识。此字段是必需的。
- 口令
- 输入用来存取数据库的口令。此字段是必需的。
- JDBC 驱动程序
- 输入或验证用于该数据库的驱动程序的位置。此字段是必需的。
该驱动程序应具有下列值之一:
|对于单机配置(缺省):
COM.ibm.db2.jdbc.app.DB2Driver
对于网络配置:
COM.ibm.db2.jdbc.net.DB2Driver
- 完成
- 完成注册至数据库的过程并打开 LaunchPad。
- 取消
- 取消向导。
启动“XML Extender 管理向导”时,“登陆”窗口打开并连接至数据库。
- 在地址字段中,将全限定 JDBC 地址输入至您正在连接的 IBM DB2 UDB 数据源中。
- 在用户标识 和口令字段中,输入或验证用于您正在连接的数据库的 DB2 用户标识和口令。
- 在 JDBC 驱动程序字段中,输入或验证指定地址的 JDBC 驱动程序名:
- 单击完成以连接至数据库并进至 LaunchPad。
- 从 LaunchPad,单击切换数据库。
- 在地址字段中,将全限定 JDBC 地址输入至您正在连接的 IBM DB2 UDB 数据源中。
- 在用户标识 和口令字段中,输入或验证用于您正在连接的数据库的 DB2 用户标识和口令。
- 在 JDBC 驱动程序字段中,输入或验证指定地址的 JDBC 驱动程序名:
- 单击完成来连接至新数据库并返回至 LaunchPad。XML Extender 断开您与原来的数据库的连接并连接至新数据库。
“XML Extender 管理向导 launchPad(即 launchPad)”
提供了帮助您完成管理任务(如启用数据库、编辑数据存取定义 (DAD)
文件和启用 XML 列或集合)的向导的存取权。选择一个任务名以启动该任务的向导。
- 切换数据库
- 打开用于注册至特定数据库的窗口。要存储或存取 XML 文档,必须连接至数据库。注册至数据库之后,可从 LaunchPad 切换至另一数据库。
- 启用数据库/禁用数据库
- 对 XML Extender 启用或禁用数据库。此按钮为双态按钮,根据是否启用了数据库而变化。为启用数据库,XML Extender 创建了 XML Extender UDT、UDF、用于存储 DTD 和有关每个 DTD 的信息的 DTD 参考表,以及用于存储每个已启用列的公共信息的用法表。为禁用数据库,XML Extender 卸下了 UDT、UDF、DTD 参考表和 XML 用法表。
在试图禁用数据库之前必须禁用所有 XML 列和集合。
- 导入 DTD
- 打开“导入 DTD”窗口,以将现存的“文档类型定义”(DTD) 文件导入到当前数据库的 DTD 资源库中。
DTD 允许您验证 XML 列中或 XML 集合中的 XML 数据。它对于 XML 列数据是可选的,但对于 XML 集合数据是必须的。
|
- |编辑 DAD
- |打开“指定 DAD”窗口,以编辑现存的“文档存取
|定义”(DAD) 文件或创建新的 DAD。DAD 定义在 DB2 中收集及存储 XML |数据的方式;它允许您定义数据的属性|和关键字元素,以便可搜索数据。
|XML 列 DAD 将 XML 列映射至辅助表以便建立索引。|XML 集合 DAD 将 DB2 数据映射至 XML 文档结构。
- 使用 XML 列
- |打开用于在表中添加 XML 列、启用列或|禁用列的窗口。|通过启用 XML 数据类型的 DB2 列来存储和存取 XML 数据。
- 使用 XML 集合
- 打开用于在数据库中启用或禁用 XML 集合的窗口。在集合中,通过使用一组关系表来存储和存取 XML 数据。
从 LaunchPad,可完成下列 XML Extender 任务:
从此向导,可启用或禁用数据库。启用数据库将创建使用 XML Extender 时所必需的 UDT、UDF、存储过程和管理支持表。必须启用数据库才能在该数据库中存储、
组成或分解 XML 文档。禁用数据库将卸下 UDT、UDF、存储过程和管理支持表。
从 LaunchPad 单击启用数据库以启用当前数据库。如果已启用数据库,则禁用数据库可用。
启用数据库时,您将返回至 LaunchPad。
从 LaunchPad 单击禁用数据库以禁用当前数据库。如果当前未启用数据库,则启用数据库可用。
禁用数据库时,您将返回至 LaunchPad。
从此向导,可导入 DTD 以验证存储在 XML 列中的 XML 文档或在 XML 集合中由 DB2 数据组成的 XML 文档。
- DTD 文件名
- 输入 DTD 文件名或单击 ... 以浏览可用 DTD 的列表。此字段是必需的。
- DTD ID
- 输入 DTD ID 的名称。该 ID 将 DTD 与 XML 文档 DAD 关联并指定其位置。DTD ID 是 DTD 的标识符,可为在本地系统上指定 DTD 位置的路径。该 DTD ID 必须与在 DAD 文件中对 <DTDID> 元素指定的值相匹配。此字段是必需的。
- 程序设计者
- 输入 DTD 程序设计者的姓名。如果在 DTD 资源库中指定了该名称,则它是自动显示的。此字段是可选的。
- 完成
- 将 DTD 插入 DTD 资源库并返回至 LaunchPad。
- 取消
- 取消向导并返回至 LaunchPad。
- 从 LaunchPad 单击导入 DTD 以将现存的 DTD 文件导入至当前数据库的 DTD 资源库中。显示“导入 DTD”向导。
- 在 DTD 文件名字段中输入 DTD 文件名,或单击 ... 以浏览现存的 DTD 文件。
- 在 DTD ID 字段中输入 DTD ID。
- 可选择在程序设计者字段中输入 DTD 程序设计者的姓名。
如果在 DTD 中指定程序设计者的姓名,则 XML Extender 将自动显示它。
- 单击完成以将 DTD 插入 DTD 资源库表 (DB2XML.DTD_REF),并返回至 LaunchPad。
从此向导,可创建或编辑 DAD 文件以定义 XML 文档与 DB2 配合使用的方式。DAD 文件用来:
- 将 XML 文档存储在列中并定义为进行快速结构搜索而索引的辅助表。
- 从在 XML 集合中定义的一个或多个 DB2 表组成 XML 文档。
- 从在 XML 集合中定义的一个或多个 DB2 表组成 XML 文档。
参考 DB2 XML Extender Administration and Programming 以了解有关这些技术的详情。
- 文件名
- 输入现存的 DAD 文件名或单击 ... 以浏览现存的 DAD 文件名。如果正在创建新 DAD,则将该字段留为空白。如果该 DAD 文件存在,则 DAD 文件的类型显示在类型中,且下一步是可选择的。
- 类型
- 如果正在创建新的 DAD,则选择下列 DAD 文件类型之一:
- XML 列,以指定对存储在列中的文档进行索引的方式
- XML 集合 SQL 映射,以提供通过单个 SQL 语句在关系数据与 XML 文档之间进行映射的方式
- XML 集合 RDB 节点映射,以提供表和列的节点定义,及提供用于定义 XML 数据存储方式的条件
- 下一步
- 转至下一步:选择验证。
- 完成
- 完成创建或修改 DAD 文件时启用。完成该过程并返回至 LaunchPad。
- 取消
- 取消向导并返回至 LaunchPad。
- 用 DTD 验证 XML 文档
- 选择此项以验证 XML 文档。借助于有效文档,可执行对数据的结构化搜索。对在 DAD 文件中指定的 DTD 验证文档。
应在将 XML 数据插入 DB2 之前验证数据,原因是不能验证已插入 DB2 的数据。
- DTD ID
- 输入 DTD 的名称或从现存 DTD 的列表中选择名称。如果尚未将任何 DTD 插入到数据库的 DTD 资源库中,则不能验证 XML 文档。
- |不验证
- 选择继续而不验证 XML 文档。
- 上一步
- 转至前一步:指定 DAD 窗口。
- 下一步
- 转至下一步。打开“管理辅助表”窗口(如果正在使用 XML 列)、“指定 SQL 语句”窗口(如果正在使用 XML 集合 SQL 映射)或“指定文本”窗口(如果正在使用 XML 集合 RDB 节点映射)。
- 完成
- 完成创建或修改 DAD 文件时启用。完成该过程并返回至 LaunchPad。
- 取消
- 取消向导并返回至 LaunchPad。
- |列示现存的表和列
- |该表包含使用该 DAD 文件创建 XML 列时|要创建的辅助表的列表。可以选择|想更改或除去的表和列的名称,或|在下面的字段中输入一名称。
- 表名
- 输入包含该列的新辅助表的名称。如果从列表中选择了列,则出现它的表的名称,以供您修改。此字段是必需的。
示例:
ORDER_SIDE_TAB
- 列名
- 输入列的名称。如果从列的列表中选择了名称,则出现该列名,以供您修改。此字段是必需的。
示例:
CUSTOMER_NAME
- 类型
- 选择或更改列的类型,如 DATE、CHAR、INTEGER 或 VARCHAR。此字段是必需的。
- 长度
- 如果选择了 VARCHAR,则输入或更改列长度的最大字符数。仅当类型为 VARCHAR 时才启用此字段。示例:
30
- 路径
- 输入或更改元素或属性的位置路径。此字段是必需的。
示例:
/ORDER/CUSTOMER/NAME
- 多次出现
- 选择此校验框以指示元素或列属性可在一个文档中使用多次,还是仅可使用一次。选择该框表示可多次出现;使该框处于未选择状态指示不能多次出现。
- 添加
- 保存带有指定详细信息的表或列,并允许您继续添加、修改或删除表或列。
- 更改
- 保存对表名、列名、类型、长度、路径或多次出现字段所作的更改。更改表或列的名称时,在列表中卸下旧对象并添加新对象。
- 除去
- 从列表中除去当前突出显示的项。
- 上一步
- 转至前一步:选择验证。
- 下一步
- 转至下一步:保存 DAD。
- 完成
- 完成创建或修改 DAD 文件时启用。完成该过程并返回至 LaunchPad。
- 取消
- 取消向导并返回至 LaunchPad。
- Prolog
- 输入 prolog 名。如果正在编辑现存的 DAD,则显示该名称。该名称的格式应为
<?xml version="1.0" ?>
此字段是必需的。
- Doctype
- 输入 XML 文档的类型。如果正在编辑现存 DAD,则显示文档类型。此字段是必需的。
示例:
<!DOCTYPE Order SYSTEM "C:\dxx\samples\dtd\getstart.dtd">
- 上一步
- 转至前一步:选择验证。
- 下一步
- 转至下一步:映射 RDB 节点(如果类型为 RDB 节点映射的话),或指定 SQL 语句(如果类型为 SQL 映射的话)
- 完成
- 完成创建或修改 DAD 文件时启用。完成该过程并返回至 LaunchPad。
- 取消
- 取消向导并返回至 LaunchPad。
- SQL 语句
- 输入 SQL SELECT 语句。如果正在编辑现存的 DAD 文件,则显示该 SQL 语句。该语句将 SELECT 子句的列映射至 XML 文档中的 XML 元素或属性。
FROM 子句定义包含数据的表。WHERE 子句指示连接和搜索条件。集合中的所有表必须能够由一个 SELECT 语句连接起来。此字段是必需的。
示例:
SELECT o.order_key, customer_name, customer_email, p.part_key, color, quantity,
price, tax, ship_id, date, mode from order_tab o, part_tab p,
table (select substr(char(timestamp(generate_unique())),16)
as ship_id, date, mode, part_key from ship_tab) s
WHERE o.order_key = 1 and
p.price > 20000 and
p.order_key = o.order_key and
s.part_key = p.part_key
ORDER BY order_key, part_key, ship_id
SQL 语句使用下列基准:
- 列是按照 XML 文档结构的层次以自顶向下的次序来指定的。
- 实体的各列被分在一起,每一组都具有一个对象 ID 列。
- 在每一组中,对象 ID 列都为第一列。
- 对于未使用单个关键字条件列的表,使用生成唯一的 DB2 内部功能来生成该列。
- 然后,对象 ID 列在 ORDER BY 语句中以自顶向下的次序列示。ORDER BY 中的列不应以任何模式和表名限定,且应与 SELECT 子句中的列名相匹配。
- 测试 SQL
- 测试 SQL 语句的有效性。如果该语句有效,则样本结果显示在样本结果字段中。如果该语句无效,则出错信息要求您校正该语句并再试。
- 样本结果
- 如果语句有效,则显示测试 SQL 语句的样本结果。此字段是只读的。
- 上一步
- 转至前一步:选择验证。
- 下一步
- 转至下一步:映射 SQL。
- 完成
- 完成创建或修改 DAD 文件时启用。完成该过程并返回至 LaunchPad。
- 取消
- 取消向导并返回至 LaunchPad。
- DAD 映象
- 从显示的 DAD 映象中选择一个节点以自其进行映射。可将 XML 文档中的元素和属性映射至对应于 DB2 数据的元素和属性节点。这些节点提供从 XML 数据至 DB2 数据的路径。选择一个节点来启用新元素。选择节点会使详细信息组框中出现适当的字段。
- 节点类型
- 从在映象中的此位置有效的类型的列表中选择节点类型。
详细信息组框中显示的字段随选择的节点类型的不同而有所不同。此字段是必需的。
- 元素
- 表示在与 XML 文档相关联的 DTD 中定义的 XML 元素,并用来将 XML 元素与 DB2 表中的某列相关联。元素节点可具有属性节点、子代元素节点或文本节点。 底级节点在树视图中具有与其相关联的文本节点和列名。
- 属性
- 表示在与 XML 文档相关联的 DTD 中定义的 XML 属性,并用来将 XML 属性与 DB2 表中的某列相关联。属性节点可具有文本节点及在树视图中与其相关联的列名。
- 文本
- 指定元素节点的文本内容。文本节点在树视图中具有与其相关联的列名。
- 节点名
- 输入节点名。此字段是必需的。
示例:
Order
- 列
- 如果选择了属性、元素或文本作为节点类型,则选择一列名。此字段是必需的。
如果将列指定为节点类型,则您仅可选择已经存在于 DB2 数据库中的列。示例:
Customer_Name
- 添加
- 将适当的标号添加至当前在树结构中添加的空元素。
- 更改
- 对突出显示的节点进行更改。可再次选择该节点或另一个节点,并作进一步的修改。
- 除去
- 除去当前突出显示的元素或属性。
- 新元素
- 通过清除详细信息组框中的字段来创建新节点,在树结构中当前突出显示的元素下面追加空元素,并突出显示新的空元素。
- 上一步
- 转至前一步:指定 SQL 语句。
- 下一步
- 转至下一步:保存 DAD。
- 完成
- 完成创建或修改 DAD 文件时启用。完成该过程并返回至 LaunchPad。
- 取消
- 取消向导并返回至 LaunchPad。
- DAD 映象
- 从显示的 DAD 映象中选择一个节点以自其进行映射。将 XML 文档中的元素和属性映射至对应于 DB2 数据的元素和属性节点。这些节点提供从 XML 数据至 DB2 数据的路径。它们指示哪个表和哪一列具有数据,及在哪种情况下可获取数据。选择一个节点来启用新元素。选择节点会使详细信息组框中出现适当的字段。
- 节点类型
- 从在映象中的此位置有效的类型的列表中选择节点类型。
详细信息组框中显示的字段随选择的节点类型的不同而有所不同。字段可表示元素、
属性、文本、表、
列或条件,这要视您在 DAD 映象中的选择而定。此字段是必需的。
- 元素
- 表示在与 XML 文档相关联的 DTD 中定义的 XML 元素,并用来将 XML 元素与 DB2 表中的某列相关联。元素节点可具有属性节点、子代元素节点、文本节点、或条件节点。根元素具有可指定用于生成 XML 文档的所有表的表节点和用于连接这些表的条件节点。此字段是必需的。
示例:
element_node name="Order"
- 属性
- 表示在与 XML 文档相关联的 DTD 中定义的 XML 属性节点,并用来将 XML 属性与 DB2 表中的列相关联。属性节点可具有文本节点及在 DAD 映象中与其相关联的列名。数据驻留在每个元素的属性节点和文本节点中。此字段是必需的。
示例:
attribute_node name="key"
|
- |表
- |表示与文本节点或属性|节点内容相关联的表。它指定一 DB2 表名,将会在其中存储或从中检索|文本节点或属性节点的内容|。示例:
|table_node name=order_tab
|
- |列
- |表示包含文本节点或|属性节点内容的列。它指定一 DB2 表列名,将会在其中存储或从中检索|文本节点或属性节点的内容|。示例:
|column name="order_key"
- 节点名
- 输入元素或属性的名称。此字段是必需的。
示例:
element_node name="Price"
- 文本
- 指示底层元素节点的关系表中的元素的文本内容和列数据。包含表元素、列元素,而对于根节点,包含条件元素。
- 表名
- 包含该列的表的名称。示例:
table name="order_tab"
table name="part_tab"
table name="ship_tab"
- 表关键字
- 表的主关键字,由一列或多列组成(组合关键字)。该关键字用来在集合中将表连在一起。组合关键字的示例:
table name="part_tab" key="part_key, price"
- 列
- 包含元素文本的数据且该元素和属性被映射至的列的名称。
示例:
column name="order_key" type="integer"
- 条件
- 在根元素中,指示连接 XML 集合表的方式。在低级别的元素中,指示用于选择 XML 数据的带有 "="、"<"、">" 或 "LIKE" 值的条件。rootl 元素的条件示例:
order_tab.order_key = part_tab.order_key AND
part_tabe.part_key = ship_tab.part._key
用于选择 XML 数据的标准的示例:
price > 2500.00
- 添加
- 将适当的标号添加至当前在树结构中添加的空元素。
- 更改
- 对突出显示的节点进行更改。可再次选择该节点或另一个节点,并作进一步的修改。
- 除去
- 除去当前突出显示的元素。
- 新元素
- 通过清除详细信息组框中的字段来创建新节点,在树结构中当前突出显示的元素下面追加空元素,并突出显示新的空元素。
- 上一步
- 转至前一步:指定文本。
- 下一步
- 转至下一个窗口:保存 DAD。
- 完成
- 完成创建或修改 DAD 文件时启用。完成该过程并返回至 LaunchPad。
- 取消
- 取消向导并返回至 LaunchPad。
- 文件名
- 输入想要保存的修改过的或新 DAD 的文件名,或单击 ... 以打开本地文件浏览器窗口,以选择 DAD 的保存位置。此字段是必需的。
- 上一步
- 转至前一步。
- 完成
- 保存 DAD 文件并返回至 LaunchPad。
- 取消
- 取消向导并返回至 LaunchPad。
创建 XML 列的 DAD 时,指定 XML 文档的数据类型并定义用于索引的辅助表。
- |从 LaunchPad 单击编辑 DAD以编辑或创建 |XML DAD 文件。“使用 DAD 文件”向导打开并显示|“指定 DAD”窗口。
- 选择是编辑现存的 DAD 文件还是创建新 DAD 文件。
- 要编辑现存的 DAD:
- 单击 ... 以浏览列表中现存的 DAD 文件,或在文件名字段中输入 DAD 文件名。
- 验证向导是否识别指定的 DAD 文件。
- 如果向导识别指定的 DAD 文件,则下一步是可选择的,且 XML 列显示在类型字段中。
- 如果向导不识别指定的 DAD 文件,则下一步不可选择。在文件名字段中重新输入 DAD 文件名,或单击 ... 以再次浏览现存的 DAD 文件。继续进行,直到下一步可选择为止。
- 单击下一步。
- 要创建新 DAD:
- 将文件名字段留为空白。
- 从类型列表中,单击 XML 列。
- 单击下一步。
- 选择是否要从“选择验证”窗口使用 DTD 来验证 XML 文档。
- 单击下一步。
- 选择是添加新辅助表、编辑现存辅助表,还是从“辅助表”窗口中除去现存的辅助表。
- 在“指定 DAD”窗口的文件名字段中输入修改过的 DAD 文件的输出文件名。
- 单击完成以保存 DAD 文件并返回至 LaunchPad。
创建 XML 集合的 DAD 时,使用下列其中一种技术来将 XML 文档映射至 DB2 数据源:
- 从 LaunchPad 单击|编辑 DAD。显示“指定 DAD”窗口。
- 选择是编辑现存的 DAD 文件还是创建新 DAD 文件。
要创建新的 DAD 文件:
- 将文件名字段留为空白。
- 从类型列表中,选择 XML 集合 SQL 映射。
- 单击下一步打开“选择验证”窗口。
要编辑现存的 DAD 文件:
- 在文件名字段中输入 DAD 文件名,或单击 ... 以浏览现存的 DAD 文件。
- 验证向导是否识别指定的 DAD 文件。
- 如果向导识别指定的 DAD 文件,则下一步是可选择的,且 XML 集合 SQL 映射显示在类型字段中。
- 如果向导不识别指定的 DAD 文件,则下一步不可选择。重新输入 DAD 文件名,或单击 ... 以再次浏览现存的 DAD 文件。重复上述步骤,直到下一步可选择为止。
- 单击下一步打开“选择验证”窗口。
- 在“选择验证”窗口中,选择是否要用 DTD 来验证 XML 文档。
- 单击下一步打开“指定文本”窗口。
- 在 Prolog 字段中输入 prolog,以指定要组成的 XML 文档的 prolog。
<?xml version="1.0"?>
如果正在编辑现存的 DAD,则 prolog 自动显示在 Prolog 字段中。
- 在“指定文本”窗口的 Doctype 字段中输入 XML 文档的文档类型,并指向 XML 文档的 DTD。
示例:
|<!DOCTYPE Order SYSTEM "C:\dxx\samples\dtd\getstart.dtd">
如果正在编辑现存的 DAD,则文档类型自动显示在 Doctype 字段中。
- 单击下一步打开“指定 SQL 语句”窗口。
- 在 SQL 语句字段中输入有效的 SQL SELECT 语句。
如果正在编辑现存的 DAD,则 SQL 语句自动显示在 SQL 语句字段中。
- 单击测试 SQL 以测试 SQL 语句的有效性。
- 如果 SQL 语句有效,则样本结果显示在样本结果字段中。
- 如果 SQL 语句无效,则错误信息显示在样本结果字段中。错误信息指导您校正 SQL SELECT 语句并再试。
- |单击下一步打开“映射 SQL”窗口。
- 通过在|“映射 SQL”窗口左边的字段中单击要从其进行映射的元素或属性节点来选择它。
将 XML 文档中的元素和属性映射至对应于 DB2 数据的元素和属性节点。这些节点提供了从 XML 数据至 DB2 数据的路径。
- 在“指定 DAD”窗口的文件名字段中输入修改过的 DAD 文件的输出文件名。
- 单击完成返回至 LaunchPad。
- 从 LaunchPad 单击|编辑 DAD。显示“指定 DAD”窗口。
- 选择是编辑现存的 DAD 文件还是创建新 DAD。
要编辑现存的 DAD:
- 在文件名字段中输入 DAD 文件名,或单击 ... 以浏览现存的 DAD。
- 验证向导是否识别指定的 DAD 文件。
- 如果向导识别指定的 DAD 文件,则下一步是可选择的,且 XML 集合 RDB 节点映射显示在类型字段中。
- 如果向导不识别指定的 DAD 文件,则下一步不可选择。在文件名字段中重新输入 DAD 文件名,或单击 ... 以再次浏览现存的 DAD 文件。继续进行这些步骤,直到下一步可选择为止。
- 单击下一步打开“选择验证”窗口。
要创建新 DAD:
- 将文件名字段留为空白。
- 从类型列表中选择 XML 集合 RDB 节点映射。
- 单击下一步打开“选择验证”窗口。
- 在“选择验证”窗口中,选择是否要用 DTD 来验证 XML 文档。
- 单击下一步打开“指定文本”窗口。
- 在“指定文本”窗口的 Prolog 字段中输入 prolog 名。
<?xml version="1.0"?>
如果正在编辑现存的 DAD,则 prolog 自动显示在 Prolog 字段中。
- 在 Doctype 字段中输入 XML 文档的文档类型。
示例:
|<!DOCTYPE Order SYSTEM "C:\dxx\samples\dtd\getstart.dtd">
如果正在编辑现存的 DAD,则文档类型自动显示在 Doctype 字段中。
- |单击下一步打开“映射 RDB 节点”窗口。
- 通过在|“映射 RDB 节点”窗口左边的字段中单击要从其进行映射的元素或属性节点来选择它。
将 XML 文档中的元素和属性映射至对应于 DB2 数据的元素和属性节点。这些节点提供了从 XML 数据至 DB2 数据的路径。
- 要添加根节点:
- 选择根图符。
- 单击新元素以定义新节点。
- 在详细信息框中,将节点类型指定为元素。
- 在节点名字段中输入根节点的名称。
- 单击添加以创建新节点。
创建了根节点或元素,它是映象中的所有其他元素和属性节点的父代。根节点具有表子代元素和连接条件。
为作为集合的一部分的每个表添加表节点。
- 突出显示根节点名并选择新元素。
- 在详细信息框中,将节点类型指定为表。
- 从表名列表选择表名。该表必须已经存在。
- 单击添加以添加表节点。
- 对每个表重复这些步骤。
为表节点添加连接条件。
- 突出显示根节点名并选择新元素。
- 在详细信息框中,将节点类型指定为条件。
- 在条件字段中,使用以下语法来输入连接条件:
table_name.table_column = table_name.table_column AND
table_name.table_column = table_name.table_column ...
包括创建连接条件所需数目的条件(由 AND 连接)。
- 单击添加以添加条件。
现在,可将子代元素和属性添加至此节点。
- 要添加子代元素或属性节点:
- 单击字段中左边的父代节点,以添加子代元素或属性。
- 单击新元素。
如果尚未选择父代节点,则新元素是不可选择的。
- 从详细信息框的节点类型列表中选择节点类型。
节点类型列表仅显示在映象中该位置处有效的节点类型,
(元素或属性)。
- 在节点名字段中输入元素或属性的名称。
- 如果将属性指定为“节点”类型,或对底级元素指定元素,
则从详细信息框的列字段中选择列。
限制:不能使用管理向导来创建新列。如果将“列”指定为节点类型,则您仅可选择已经存在于 DB2 数据库中的列。
- 单击添加以添加新节点。
通过单击字段中左边的节点并在详细信息框中对其进行任何所需的修改,可在以后修改该节点。单击更改来更新该元素。
还可通过突出显示重复添加过程的节点来将子代元素或属性添加至节点。
- 要将元素或属性节点的内容映射至关系表:
- 指定文本节点。
- 单击父代节点。
- 单击新元素。
- 在节点类型字段中,选择文本。
- 选择添加以添加节点。
- 添加表节点。
- 选择刚刚创建的文本节点并单击新元素。
- 在节点类型字段中,选择表并对该元素指定表名。
- 单击添加以添加节点。
- 添加列节点。
- 再次选择该文本节点并单击新元素。
- 在节点类型字段中,选择列并对该元素指定列名。
- 单击添加以添加节点。
限制:不能使用管理向导来创建新列。如果将“列”指定为节点类型,则您仅可选择已经存在于 DB2 数据库中的列。
- 可选择为该列添加条件。
- 再次选择该文本节点并单击新元素。
- 在节点类型字段中,选择条件并以下列语法选择条件:
operator LIKE|<|>|= value
- 单击添加以添加节点。
- 继续编辑 RDB 节点映象,或单击下一步来打开“指定 DAD”窗口。
- 要除去节点:
- 单击字段中左边的节点。
- 单击除去。
- 继续编辑 RDB 节点映象,或单击下一步来打开“指定 DAD”窗口。
- 在“指定 DAD”窗口的文件名字段中输入修改过的 DAD 的输出文件名。
- 单击完成以除去该节点并返回至 LaunchPad。
- 从 LaunchPad 单击|编辑 DAD。显示“指定 DAD”窗口。
- 选择是编辑现存的 DAD 文件还是创建新 DAD。
要编辑现存的 DAD:
- 在文件名字段中输入 DAD 文件名,或单击 ... 以浏览现存的 DAD。
- 验证向导是否识别指定的 DAD 文件。
- 如果向导识别指定的 DAD 文件,则下一步是可选择的,且 XML 集合 RDB 节点映射显示在类型字段中。
- 如果向导不识别指定的 DAD 文件,则下一步不可选择。在文件名字段中重新输入 DAD 文件名,或单击 ... 以再次浏览现存的 DAD 文件。继续进行这些步骤,直到下一步可选择为止。
- 单击下一步打开“选择验证”窗口。
要创建新 DAD:
- 将文件名字段留为空白。
- 从类型列表中选择 XML 集合 RDB 节点映射。
- 单击下一步打开“选择验证”窗口。
- 在“选择验证”窗口中,选择是否要用 DTD 来验证 XML 文档。
- 单击下一步打开“指定文本”窗口。
- 如果只是在分解 XML 文档,则忽略 Prolog 字段。如果将 DAD 文件同时用于组合和分解,则在“指定文本”窗口的 Prolog 字段中输入 prolog 名。如果正在将 XML 文档分解为 DB2 数据,则该 prolog 不是必需的。
<?xml version="1.0"?>
如果正在编辑现存的 DAD,则 prolog 自动显示在 Prolog 字段中。
- 如果只是在分解 XML 文档,则忽略 Doctype 字段。如果将 DAD 文件同时用于组合和分解,则在 Doctype 字段中输入 XML 文档的文档类型
如果正在编辑现存的 DAD,则文档类型自动显示在 Doctype 字段中。
示例:
|<!DOCTYPE Order SYSTEM "C:\dxx\samples\dtd\getstart.dtd">
- 单击下一步打开“RDB 映射”窗口。
- 通过在“RDB 映射”窗口左边的字段中单击要从其进行映射的元素或属性节点来选择它。
将 XML 文档中的元素和属性映射至对应于 DB2 数据的元素和属性节点。这些节点提供了从 XML 数据至 DB2 数据的路径。
- 要添加根节点:
- 选择根图符。
- 单击新元素以定义新节点。
- 在详细信息框中,将节点类型指定为元素。
- 在节点名字段中输入根节点的名称。
- 单击添加以创建新节点。
创建了根节点或元素,它是映象中的所有其他元素和属性节点的父代。根节点具有表子代元素和连接条件。
为作为集合的一部分的每个表添加表节点。
- 突出显示根节点名并选择新元素。
- 在详细信息框中,将节点类型指定为表。
- 从表名列表选择表名。该表必须已经存在。
- 对表关键字字段中的表指定关键字列。
- 单击添加以添加表节点。
- 对每个表重复这些步骤。
为表节点添加连接条件。
- 突出显示根节点名并选择新元素。
- 在详细信息框中,将节点类型指定为条件。
- 在条件字段中,使用以下语法来输入连接条件:
table_name.table_column = table_name.table_column AND
table_name.table_column = table_name.table_column ...
- 单击添加以添加条件。
现在,可将子代元素和属性添加至此节点。
- 要添加子代元素或属性节点:
- 单击字段中左边的父代节点,以添加子代元素或属性。
如果尚未选择父代节点,则新建是不可选择的。
- 单击新元素。
- 从详细信息框的节点类型列表中选择节点类型。
节点类型列表仅显示在映象中该位置处有效的节点类型,
(元素或属性)。
- 单击添加以添加新节点。可在以后通过单击左边字段中的节点并在详细信息框中对其进行任何所需的修改,以修改该节点。单击更改来更新该元素。
- 要将元素或属性节点的内容映射至关系表:
- 指定文本节点。
- 单击父代节点。
- 单击新元素。
- 在节点类型字段中,选择文本。
- 选择添加以添加节点。
- 添加表节点。
- 选择刚刚创建的文本节点并单击新元素。
- 在节点类型字段中,选择表并对该元素指定表名。
- 单击添加以添加节点。
- 添加列节点。
- 再次选择该文本节点并单击新元素。
- 在节点类型字段中,选择列并对该元素指定列名。
- 对类型字段中的列指定基本数据类型,以指定该列必须为哪种类型才能存储未标记的数据。
- 单击添加以添加节点。
限制:不能使用管理向导来创建新列。如果将“列”指定为节点类型,则您仅可选择已经存在于 DB2 数据库中的列。
- 可选择为该列添加条件。
- 再次选择该文本节点并单击新元素。
- 在节点类型字段中,选择条件并以下列语法选择条件:
operator LIKE|<|>|= value
- 单击添加以添加节点。
- 继续编辑 RDB 节点映象,或单击下一步来打开“指定 DAD”窗口。
- 要除去节点:
- 单击字段中左边的节点。
- 单击除去。
- 继续编辑 RDB 节点映象,或单击下一步来打开“指定 DAD”窗口。
- 在“指定 DAD”窗口的文件名字段中输入修改过的 DAD 的输出文件名。
- 单击完成以除去该节点并返回至 LaunchPad。
从此向导,可添加、启用或禁用 XML Extender 的 XML 列。
- 添加 XML 列
- 选择此项以打开“添加 XML 列”窗口,以将列添加至表。此列将包含完整的 XML 文档。此选项仅当启用了数据库时才可用。
- |启用 XML 列
- 选择此项打开|“启用 XML 列”窗口,以连接数据库并启用 XML 列,以使其可包含 XML Extender UDT。仅当为 XML 文档启用了数据库并创建了列时,此选项才可用。
- |禁用 XML 列
- 选择此项打开|“禁用 XML 列”窗口,以禁用现存的列。如果未启用数据库或启用的 XML 列不存在,则此选项不可用。禁用的列不能再包含 XML 文档。必须在卸下 XML 表之前禁用 XML 列。如果表被卸下而其 XML 列未被禁用,则 XML Extender 将所创建的辅助表和 XML 列项保存在 XML 用法表中。
- 下一步
- 打开已选择的窗口以添加、启用或禁用 XML 列。
- 完成
- 当结束使用该列时可用。
- 取消
- 取消向导并返回至 LaunchPad。
- 表名
- 输入表名或从可用表的列表中选择名称。必须定义该表才能添加 XML 列。
示例:
SALES_DB
- 列名
- 输入想要用于 XML 列的名称。
示例:
ORDER
- |数据类型
- 从可用类型(如,XMLCLOB、XMLVARCHAR 或 XMLFILE)的列表中选择数据类型。示例:
XMLVARCHAR
- 上一步
- 打开用来使用 XML 列的“选择任务”窗口。
- 完成
- 添加 XML 列并返回至 LaunchPad。
- 取消
- 取消向导并返回至 LaunchPad。
- 表名
- 输入具有 XML 列的表的名称,或从可用表名的列表中选择名称。示例
SALES_TAB
- 列名
- 输入表中现存 XML 列的名称,或从可用列的列表中选择名称。示例:
ORDER
- DAD 文件名
- 输入将 XML 文档映射至 XML 列和辅助表的 DAD 文件的位置,或单击 ... 以浏览现存的 DAD 文件。示例:
c:\dxx\samples\dad\getstart.dad
- 表空间
- 可选:输入先前为与 XML 列相关联的辅助表创建的表空间的名称。如果未指定该表空间,则使用缺省表空间。
- 缺省视图
- 可选:输入连接 XML 表和所有相关辅助表的缺省视图的名称。
- |Root 用户标识
- 建议这样做,但是可选的:在表中输入主关键字的列名以将所有辅助表与应用程序表相关联。如果未指定 ROOT 用户标识,则 XML Extender 将 DXXROOT_ID 列添加至表并生成标识符。
- 上一步
- 打开用来使用 XML 列的“选择任务”窗口。
- 完成
- 启用 XML 列并返回至 LaunchPad。要启用该列 XML Extender 确定 XML 表是否具有主关键字,创建在 DAD 文件中指定的辅助表,并创建 XML 表和辅助表的缺省视图。
- 取消
- 取消向导并返回至 LaunchPad
- 表名
- 输入包含 XML 列的表的名称,或从可用表的列表中选择名称。
- 列名
- 输入表中现存列的名称,或从列名列表中选择名称。
- 上一步
- 打开用来使用 XML 列的“选择任务”窗口。
- 完成
- 禁用 XML 列并返回至 LaunchPad。禁用的 XML 列不再包含 XML 文档。
- 取消
- 取消向导并返回至 LaunchPad。
- 从 LaunchPad 单击使用 XML 列。“选择任务”窗口打开。
- 单击添加 XML 列。“添加 XML 列”窗口打开。
- 从表名列表中选择表名,或输入想要改变的表名。
- 在列名字段中输入要添加至表的列的名称。
- 从|数据类型列表中选择该列的 UDT。
- 单击完成以添加 XML 类型的列。
- 从 LaunchPad 单击使用 XML 列以查看与 XML Extender 列相关的任务。“选择任务”窗口打开。
- 单击|启用 XML 列并单击下一步以启用数据库中的现存表列。
- 从表名字段中选择包含 XML 列的表。
- 从列名字段中选择所启用的列。该列必须存在且为 XML 类型。
- 在 DAD 文件名字段中输入 DAD 路径和文件名,或单击 ... 以浏览现存的 DAD 文件。
- 可选择在表空间字段中输入现存表空间的名称。
该表空间包含 XML Extender 创建的辅助表。如果指定了表空间,则这些辅助表是在指定的表空间中创建的。如果未指定表空间,则这些辅助表是在缺省表空间中创建的。
- 可选择在缺省视图字段中输入缺省视图的名称。
如果指定了缺省视图,则缺省视图在启用列时自动创建,且连接 XML 表和所有相关的辅助表。
- 可选择在 Root 用户标识字段中输入应用程序表中主关键字的列名。建议这样做。
XML Extender 将 Root 用户标识的值用作唯一标识符,以将所有辅助表与应用程序表相关联。如果未指定 Root 用户标识,则 XML Extender 将 DXXROOT_ID 列添加至应用程序表并生成标识符。
- 单击完成以启用 XML 列,创建辅助表,并返回至 LaunchPad。
- 如果该列被成功启用,则显示启用列成功信息。
- 如果该列未成功启用,则显示一个错误框。校正输入字段中的值,直到成功启用该列为止。
- 从 LaunchPad 单击使用 XML 列以查看与 XML Extender 列相关的任务。 “选择任务”窗口打开。
- 从“选择任务”窗口单击|禁用 XML 列并单击下一步以禁用数据库中的现存表列。
- 从表名字段中选择包含 XML 列的表。
- 从列名字段中选择所禁用的列。
- 单击完成。
- 如果该列被成功禁用,则显示禁用列成功信息。
- 如果未成功禁用该列,则显示一个错误框。校正输入字段中的值,直到成功禁用该列为止。
从此向导,可启用或禁用 XML 集合。
- 启用 XML 集合
- 选择此项以打开“启用 XML 集合”窗口。启用 XML 集合将分析 DAD 文件以标识与 XML 文档相关的表和列,并记录控制信息。此选项仅当启用了数据库且 DAD 文件存在时才可用。
- 禁用 XML 集合
- 选择此项打开“禁用集合”窗口,以除去将表和列标识为 XML 集合的一部分的标记符。如果该集合未启用,则此选项不可用。
- 下一步
- 打开已选择的窗口以启用或禁用 XML 集合。
- 完成
- 当结束使用该集合时可用。
- 取消
- 取消向导并返回至 LaunchPad。
- 集合名
- 输入想要启用的 XML 集合的名称。
- DAD 文件名
- 输入将 XML 文档结构映射至 DB2 表(可在其中组成或分解文档)的 DAD 文件的名称,或单击 ... 以浏览现存的 DAD 文件。
- ...
- 打开“查找”窗口,以选择现存的 DAD 文件名。
- 表空间
- 输入先前创建的表空间(如果存在的话)的名称。该表空间将包含为进行组成或分解而生成的新 DB2 表。
- 上一步
- 打开用来使用 XML 集合的“选择任务”窗口。
- 完成
- 启用 XML 集合并返回至 LaunchPad。为启用该集合,XML Extender 使用 DAD 文件来标识 XML 文档的表和列,并在 XML_USAGE 表中记录控制信息。
- 取消
- 取消向导并返回至 LaunchPad。
- 集合名
- 从集合列表中选择想要禁用的 XML 集合的名称。
- 上一步
- 打开用来使用 XML 集合的“选择任务”窗口。
- 完成
- 禁用 XML 集合并返回至 LaunchPad。要禁用集合,XML Extender 除去将表和列标识为 XML 集合的一部分的标记符。
- 取消
- 取消向导并返回至 LaunchPad。
- 从 LaunchPad 单击使用 XML 集合。显示“选择任务”窗口。
- 单击|启用 XML 集合,然后单击下一步。显示“启用集合”窗口。
- 从列表中选择想要在集合名字段中启用的集合的名称。
- 在 DAD 文件名字段中输入 DAD 文件名,或单击 ... 以浏览现存的 DAD 文件。
- 可选择在表空间字段中输入先前创建的表空间的名称。
该表空间将包含为进行分解而生成的新 DB2 表。
- 单击完成以启用该集合并返回至 LaunchPad。
- 如果该集合成功启用,则显示启用集合成功信息。
- 如果未成功启用该集合,则显示一条错误信息。校正输入字段中的值,直到成功启用该集合为止。
- 从 LaunchPad 单击使用 XML 集合以查看与 XML Extender 集合相关的任务。显示“选择任务”窗口。
- 单击禁用 XML 集合,然后单击下一步以禁用 XML 集合。显示“禁用集合”窗口。
- 在集合名字段中输入想要禁用的集合的名称。
- 单击完成以禁用该集合并返回至 LaunchPad。
- 如果成功禁用了该集合,则显示禁用集合成功信息。
- 如果未成功禁用该集合,则显示一个错误框。校正输入字段中的值,直到成功禁用该集合为止。