sibDBUpgrade 命令
消息传递引擎需要数据定义语言 (DDL) 语句来变更现有的数据库管理系统 (DBMS) 资源。可以使用 sibDBUpgrade 命令变更 DBMS 资源。
需要使用 sibDBUpgrade 命令来修改新功能(例如 记录每个消息的失败传递次数 和 限制长期运行的锁)的表。可以使用 sibDBUpgrade 命令将消息传递引擎从先前版本的 WebSphere® Application Server 迁移到 V9.0。
语法
Unix 的命令行语法为:
>>-sibDBUpgrade.sh--+----------------------------+--------------> '- -runUpgrade--true 或 false-' >--+------------------------------+-----------------------------> '- -dbUser--database user name-' >--+----------------------------------+-------------------------> '- -dbSchema--database schema name-' >--+-------------------------+--+---------------------------+---> '- -dbType--database type-' '- -serverName--server name-' >--+-------------------------+----------------------------------> '- -dbName--database name-' >--+---------------------------------+--------------------------> '- -dbPassword--database password-' >--+------------------------------+-----------------------------> '- -dbNode--database node name-' >--+--------------------------------+---------------------------> '- -oracleHome--Oracle home path-' >--+-------------------------------+----------------------------> '- -scriptDir--script directory-' >--+-----------------------------------------+------------------> '- -permanent--number of permanent tables-' >--+-----------------------------------------+----------------->< '- -temporary--number of temporary tables-'
Windows 的命令行语法为:
>>-sibDBUpgrade.bat--+----------------------------+-------------> '- -runUpgrade--true 或 false-' >--+------------------------------+-----------------------------> '- -dbUser--database user name-' >--+----------------------------------+-------------------------> '- -dbSchema--database schema name-' >--+-------------------------+--+---------------------------+---> '- -dbType--database type-' '- -serverName--server name-' >--+-------------------------+----------------------------------> '- -dbName--database name-' >--+---------------------------------+--------------------------> '- -dbPassword--database password-' >--+------------------------------+-----------------------------> '- -dbNode--database node name-' >--+--------------------------------+---------------------------> '- -oracleHome--Oracle home path-' >--+-------------------------------+----------------------------> '- -scriptDir--script directory-' >--+-----------------------------------------+------------------> '- -permanent--number of permanent tables-' >--+-----------------------------------------+----------------->< '- -temporary--number of temporary tables-'
用途
数据库管理员可以使用 sibDBUpgrade 实用程序命令来变更消息传递引擎的 DBMS 资源。sibDBUpgrade 命令将生成数据库管理员可保存并稍后进行处理的 DDL 语句,以变更已改变的数据库表中列示的 DBMS 资源。除数据库管理员外,有权变更数据库表的用户也可以使用此实用程序来变更数据库表。
要访问
IBM® i
命令行,请使用 STRQSH 命令启动 Qshell 会话。
有关更多信息,请参阅 使用 wsadmin 脚本编制配置 Qshell 以运行 WebSphere 脚本.
必需参数
提示: sibDBUpgrade 命令区分大小写。例如,参数值
Oracle 与参数值 oracle 不同。
- -runUpgrade true 或 false [对于 z/OS、Derby 和 Informix,此值必须为 false]
- 用于变更数据库资源的命令。将参数值指定为 true 可以变更数据库资源,而指定为 false 可以仅生成 DDL 脚本。
- -dbUser
- 用于与 DBMS 进行交互的用户标识的名称。
- -dbSchema
- 包含消息传递引擎使用的所有对象的模式名称。
- -dbType
- 标识 DBMS 的类型。有效值为:
- DB2
- Oracle
- SqlServer
- Sybase
- Informix
- Derby
注: 支持 DB2 on zos 和 iseries 平台。
可选参数
- -dbName
- 为消息传递引擎表分配的数据库的名称。如果 runUpgrade 参数的值指定为 true,那么 -dbName 参数为必需参数。
- -serverName
- 这是用于和 DBMS 进行交互的服务器的名称。如果未提供 -serverName 参数,那么缺省值为 IBMUSER。
- -dbPassword
- 这是用于和 DBMS 进行交互的用户标识的密码。
- -dbNode
- 这是数据库节点的名称。此可选参数仅适用于 DB2。使用 -runUpgrade 选项在其上运行脚本的系统必须仅安装 DB2 客户机。
- -oracleHome
- 这是 -dbType 参数值为 Oracle 时 Oracle 主目录的路径。
- -scriptDir
- 必须在其中生成 DDL 脚本的目录的名称。如果未指定目录,那么脚本将生成到 <current_directory>/SIBusUpgradeDatabase 目录中,其中 current_directory 是活动目录。
- -permanent
- 这是创建服务集成消息传递引擎时创建的永久表的数目。有关所配置的表数目的更多信息,请参阅数据存储器 [设置]。缺省情况下,将有一个永久表。如果消息传递引擎配置为使用多个永久表,请指定表的数目。
- -temporary
- 这是创建服务集成消息传递引擎时创建的临时表的数目。有关所配置的表数目的更多信息,请参阅数据存储器 [设置]。缺省情况下,将有一个临时表。如果消息传递引擎配置为使用多个临时表,请指定表的数目。
示例
要将服务集成总线的数据库模式从先前版本的 WebSphere Application Server 升级到 V9.0,请执行以下命令。
- sibDBUpgrade.sh -runUpgrade false -dbUser db2inst1 -dbSchema SIBusMESchema -dbType DB2
- sibDBUpgrade.sh -runUpgrade true -dbName SIBus -dbUser db2inst1 -dbSchema SIBusMESchema -dbType DB2
要将服务集成总线的数据库模式从先前版本的 WebSphere Application Server 升级到 V9.0,请执行以下命令。
- sibDBUpgrade.bat runUpgrade=false dbUser=db2inst1 dbSchema=SIBusMESchema dbType=DB2
- sibDBUpgrade.bat runUpgrade=true dbName=SIBus dbUser=db2inst1 dbSchema=SIBusMESchema dbType=DB2