IBM Tivoli Monitoring Agent Builder V6.3.0

为数据仓库表生成 SQL 语句

可以使用模式发布工具来生成创建数据库对象所需要的 SQL 语句，这些数据库对象是对 Tivoli Data Warehouse 进行初始设置所必需的。

开始之前

随 Summarization and Pruning Agent 一起安装了模式发布工具。您应当在安装产品之后并且在配置 Summarization and Pruning Agent 之后，然而是在首次启动 Warehouse Proxy Agent 和 Summarization and Pruning Agent 之前执行此任务。

关于此任务

缺省情况下，数据仓库所需要的数据库对象由安装程序、Warehouse Proxy Agent 和 Summarization and Pruning Agent 自动创建。模式发布工具使您能够手动创建数据仓库数据库对象，而不是允许自动创建这些对象。在多种情况下您可能想要手动创建数据仓库数据库对象：

您可能想要使用另外的数据库管理用户标识来创建表，而不对安装期间所指定的 Tivoli Data Warehouse 用户标识授予许可权。
您可能想要在创建表之前定制 SQL 语句，以便满足您所在环境特有的性能考虑事项、安全策略或者其他问题的要求。

模式发布工具是一个脚本，它将生成创建所选产品需要的数据仓库表、索引、函数、视图和标识表插入所必需的 SQL 语句。在使用所生成的 SQL 文件来创建表和索引之前，可以对这些文件进行修改。

过程

通过生成样本响应文件的副本来创建新的响应文件：
- itm_install_dir\TMAITM6\tdwschema.rsp
- itm_install_dir/arch/bin/tdwschema.rsp

使用 ASCII 文本编辑器来编辑此响应文件以指示您想要使用的选项。响应文件中的关键字会影响生成哪些 SQL 语句以及其他选项：

KSY_PRODUCT_SELECT=category

您想要为其生成 SQL 文件的产品所属的类别：

值	描述
`installed`	所有已安装的 Tivoli Enterprise Portal Server 产品。注：这可为大量表生成 DDL。
`configured`	所有已配置的门户网站服务器产品。定义了历史数据收集的产品。仅为定义了历史数据收集的属性组生成 DDL。根据汇总和修剪设置来生成汇总表的 DDL。例如，如果属性组启用了每小时汇总和每月汇总，那么将仅为每小时汇总表和每月汇总表生成 DDL。
`updated`	尚未将配置更改部署到数据库的已配置门户网站服务器产品。如果值为 updated，那么将捕获使 Tivoli® Data Warehouse 保持最新（采用当前配置）所需要进行的更改。如果您需要已配置的整个模式，那么使用的值必须为 configured。更新示例：为先前没有任何收集的属性组创建历史数据收集。对一个或多个属性组启用其他汇总。将更改现有属性组的软件更新。现有仓库表将需要添加列。在数据库中启用了数据库压缩，并且已将 Summarization and Pruning Agent 配置为使用数据库压缩。生成了 DDL 以对现有表和索引进行压缩。

该关键字是必需的。

KSY_PRODUCT_FILTER=product_filter

这是一个可选过滤器，指示仅包括某些特定产品。（如果您未指定过滤器，那么缺省情况下将包括所指定类别的所有产品。）请指定您想要包括的产品的三字母产品代码，产品代码之间用逗号分隔。可以使用 tacmd histListProduct 命令来查找这些代码（有关更多信息，请参阅 IBM® Tivoli Monitoring Command Reference）。

KSY_TABLE_FILTER=list_of_tables

除 KSY_PRODUCT_FILTER 外，您还可以使用此过滤器。使用以下命令可以获取可供给定产品使用的表的列表：

tacmd histListAttributeGroups -t <productcode>

请将属性组名称中的每个空格替换为下划线字符。

KSY_SUMMARIZATION_SELECTION=summarization_filter

这是一个可选过滤器，指示所生成的表中仅包括某些汇总选项：

值	描述
`H`	每小时
`D`	每天
`W`	每周
`M`	每月
`Q`	每季度
`Y`	每年

此关键字仅对于 KSY_PRODUCT_SELECT=installed 有效。

KSY_SQL_OUTPUT_FILE_PATH=path

要将所生成的 SQL 文件写入到的目录的可选路径。如果您不使用此关键字，那么将使用当前工作目录。

有关每个关键字的更多详细信息和完整语法，请参阅样本响应文件 tdwschema.rsp 中的注释。

请确保 Tivoli Enterprise Portal Server 已启动。
使用适合于您所使用操作系统的语法来运行模式发布工具。
- ```
tdwschema -rspfile response_file
```
- ```
tdwschema.sh -rspfile response_file
```
将生成此响应文件中所指定产品的 SQL 文件，并将此文件写入 KSY_SQL_OUTPUT_FILE_PATH 关键字所指示的目录（如果未指定输出目录，那么将写入当前工作目录）。
对所生成的 SQL 文件进行任何必需的更改。例如，您可能想要将表分区或者将表分配给表空间。
注：请勿更改所生成 SQL 文件中指定的任何表的名称。
使用适当的工具来运行 SQL 查询，以对关系数据库创建仓库表、索引、视图、插入和函数。请按以下顺序执行各个脚本：
1. tdw_schema_table.sql
2. tdw_schema_index.sql
3. tdw_schema_view.sql
4. tdw_schema_insert.sql
5. tdw_schema_function.sql
下面是针对 DB2® 命令的一些示例：
```
db2 -tvf tdw_schema_table.sql
db2 -tvf tdw_schema_index.sql
db2 -tvf tdw_schema_view.sql
db2 -tvf tdw_schema_insert.sql
db2 -td# -f tdw_schema_function.sql
```
注：对 tdw_schema_function.sql 的调用不同。

反馈