sibDDLGenerator 命令
消息传递引擎需要数据定义语言 (DDL) 语句来创建 DBMS(数据库管理系统)资源。这些 DBMS 资源是由 sibDDLGenerator 命令生成的。
语法
>>-sibDDLGenerator--+---------------------+---------------------> '- -system--DBMS name-' >--+-------------------------+--+---------------------------+---> '- -version--DBMS version-' '- -platform--DBMS platform-' >--+-----------------------+--+-------------------+-------------> '- -schema--schema name-' '- -user--user name-' >--+----------+--+----------------------+-----------------------> +- -create-+ '- -database--database-' '- -drop---' >--+-------------------------------+----------------------------> '- -storagegroup--storage group-' >--+---------------------------------+--------------------------> '- -catalog--high level qualifier-' >--+---------------------------+--------------------------------> '- -bufferpool--buffer pool-' >--+-------------------------------+--+----------------+--------> '- -statementend--statement end-' '- -nolinebreaks-' >--+----------------+--+-------------------------+--------------> '- -noblanklines-' '- -firstline--first line-' >--+-----------------------+--+---------------------+-----------> '- -lastline--last line-' '- -permanent--number-' >--+---------------------+------------------------------------->< '- -temporary--number-'
用途
消息传递引擎需要可以在启动时创建的 DBMS 资源(例如数据库表)。如果您的安装具有仅数据库管理员才有权限创建数据库表的策略,那么使用 sibDDLGenerator 命令使您的数据库管理员能创建消息传递引擎需要的 DBMS 资源。sibDDLGenerator 命令生成您的数据库管理员可保存的并在稍后进行处理的 DDL 语句,以创建在数据存储器表中列示的 DBMS 资源。
该命令还生成一些 DDL 语句,它们授予适当的权限以允许消息传递引擎使用这些表。
要访问
IBM® i
命令行,请使用 STRQSH 命令启动 Qshell 会话。
有关更多信息,请参阅 使用 wsadmin 脚本编制配置 Qshell 以运行 WebSphere 脚本.
注: sibDDLGenerator
命令能够生成用于创建或删除所有数据存储器表的 DDL 语句。将更多的项表添加到现有的数据存储器并不合适。但是,可以重新发出 DDL 语句以便在不损害数据存储器的情况下创建现有的表。
可选参数
提示: sibDDLGenerator 命令是区分大小写的。例如,参数值
Oracle 与参数值 oracle 不同。
某些参数仅适用于特定 DBMS,就像参数列表中指示的那样;例如:-database [仅适用于 DB2® z/OS 版]
- -system
- 标识 DBMS 的类型,管理员将在 DBMS 上处理 DDL 语句。有效值为:
- db2
- oracle
- sqlserver
- sybase
- informix
- derby
- -version
- -system 参数标识的 DBMS 的版本号。下表显示未提供 -version 参数时使用的缺省值。
如果运行工具时接收到 CWSIS1595E 或 CWSIS1503E 错误,请查阅该表之后的注释来确定能否对数据库版本使用备用 -version 参数值。
表 1. -version 参数的值. 此表的第一列列示 -system 参数值。此表的第二列列示 -platform 参数值。此表的第三列列示 -version 参数的缺省值。此表的第四列列示 -version 参数的其他可接受值。 -system 参数值 -platform 参数值 -version 参数的缺省值 其他可接受的 -version 参数值 db2 zos 7.1 8.1 和 9.1(请参阅注释 1) db2 unix 和 windows 8.1 9.1(请参阅注释 1) db2 iseries 5.2(请参阅注释 2) 5.3(请参阅注释 2) oracle 8i 10g 和 11g(请参阅注释 3) sqlserver 2000 2005 sybase 12.0 12.5 和 15.0 informix 9.3 7.3、9.4、10.0 和 11.0(请参阅注释 4) derby 10.1 注意:- 使用 -version 参数值 8.1 和 9.1 为 DB2 UNIX 版或 Windows 版生成的 DDL 完全相同。 使用 -version 参数值 7.1、8.1 和 9.1 为 DB2 z/OS® 版生成的 DDL 完全相同。
- 对于 IBM i,DB2 数据库是操作系统的一部分,所以给出的版本号对应 OS/400® 版本。
- 使用 -version 参数值 10g 和 11g 为 Oracle 生成的 DDL 完全相同。
- 使用 -version 参数值 10.0 和 11.0 为 Informix® 生成的 DDL 完全相同。
- -platform
- 运行 DBMS 的操作系统平台。有效值为:
- iseries
- unix
- windows
- zos
- -schema
- 包含消息传递引擎使用的所有对象的模式名称。如果您不提供 -schema 参数,那么缺省值为 IBMWSSIB。
- -user
- 用于与 DBMS 进行交互的用户标识的名称。如果您不提供 -user 参数,那么缺省值为 IBMUSER。
- -create | -drop
- 指示 DDL 语句是创建 DBMS 资源还是删除它们。如果您不提供任一参数,那么缺省值为 -create。
- -database [仅适用于 DB2 z/OS 版]
- 为消息传递引擎表分配的数据库的名称。如果您不提供 -database 参数,那么缺省值为 SIBDB。
- -storagegroup [仅适用于 DB2 z/OS 版]
- 为消息传递引擎表分配的存储器组的名称。
- 如果同时提供了 -storagegroup 和 -catalog 参数,sibDDLGenerator 命令就会将这两个值同时包括在 CREATE STOGROUP 语句中。
- 如果只提供了 -storagegroup 参数,sibDDLGenerator 命令就会在其他语句中使用存储器组名,但不会创建 CREATE STOGROUP 语句。
- 如果只提供了 -catalog 参数,sibDDLGenerator 命令就会显示用法说明,然后终止。
- 如果同时省略这两个参数,sibDDLGenerator 命令就会在其他语句中使用缺省值 SIBSG 作为存储器组名,但不会创建 CREATE STOGROUP 语句。
- -catalog [仅适用于 DB2 z/OS 版]
- 为消息传递引擎表分配的存储器组的高级限定符的名称。有关缺省值的信息,请参阅 -storagegroup 参数。
- -bufferpool [仅适用于 DB2 z/OS 版]
- 为消息传递引擎表分配的缓冲池的名称。如果您不提供 -bufferpool 参数,那么缺省值为 BP1。
- -statementend
- 将 statement_end 追加至每个 DDL 语句。例如,您可使用 ; 对每个 DDL 语句追加一个分号。缺省情况下,sibDDLGenerator 命令不对每个语句追加任何字符。提示: 在 UNIX 平台上,对分号进行转义以阻止 shell 对其进行解释。
- -nolinebreaks
- 将每个语句放在一行上而不加任何换行符。缺省情况下,sibDDLGenerator 命令会将语句换行以提高可读性。
- -noblanklines
- 在每个语句之间省略空白行。缺省情况下,sibDDLGenerator 命令在每个语句之间插入一个空白行以提高可读性。
- -firstline
- 生成 first_line 作为输出的第一行。例如,可使用 first_line 标识目标数据库。缺省情况下,sibDDLGenerator 命令不生成第一行。
- -lastline
- 生成 last_line 作为输出的最后一行。例如,您可使用 last_line 来调用在脚本中执行命令的命令。缺省情况下,sibDDLGenerator 命令不生成最后一行。
提示: 控制 DDL 语句格式的可选参数(例如,-statementend)使您能够生成适用于特定脚本编制工具(例如,DB2 CLP)的输出。缺省情况下,sibDDLGenerator 命令在每个
DDL 语句之间生成空白行但不会将分号追加至每个 DDL 语句的末尾。
以下两个可选参数用于在多个表之间展开数据存储器:
- -permanent
- 永久表的数目
- 缺省值:1
- 最小值:1
- 最大值:请参阅注
- -temporary
- 临时表的数目
- 缺省值:1
- 最小值:1
- 最大值:请参阅注
注: 消息传递引擎可以使用的 SIBnnn 表的最大数目是 32。这包括所有流表、永久表和临时表。
示例
- sibDDLGenerator -system db2 -version 8.1 -platform zos
生成在 z/OS 上运行的 DB2 8.1 的 DDL 语句,具有缺省模式、用户标识、数据库、存储器组和缓冲池。
- sibDDLGenerator -system db2 -version 8.1 -platform windows -statementend ;
生成在 Windows 上运行的 DB2 8.1 的 DDL 语句,具有缺省模式、用户标识和数据库。您可直接将语句输入至 DB2 CLP,它要求每个语句以分号结尾。
- sibDDLGenerator -system oracle -version 8i -schema SIB -user fred
生成 Oracle 8i 的 DDL 语句。
- sibDDLGenerator -system oracle -schema SIB -user fred
先前示例的简明版本。