sibDBUpgrade 指令
傳訊引擎需要資料定義語言 (DDL) 陳述式來變更現有的資料庫管理系統 (DBMS) 資源。您可以使用 sibDBUpgrade 指令來變更 DBMS 資源。
需要使用 sibDBUpgrade 指令來修改表格,才能使用保存每個訊息的失敗遞送次數和限制長時間執行鎖定等新的功能。sibDBUpgrade 指令可用來將傳訊引擎從舊版 WebSphere® Application Server 移轉至 9.0 版。
語法
Unix 的指令行語法為:
>>-sibDBUpgrade.sh--+----------------------------+--------------> '- -runUpgrade--true 或 false-' >--+--------------------+--+---------------------+--------------> '- -dbUser--資料庫使用者名稱-' '- -dbSchema--資料庫綱目名稱-' >--+-----------------+--+---------------------+-----------------> '- -dbType--資料庫類型-' '- -serverName--伺服器名稱-' >--+-----------------+--+---------------------+-----------------> '- -dbName--資料庫名稱-' '- -dbPassword--資料庫密碼-' >--+-------------------+--+-----------------------------+-------> '- -dbNode--資料庫節點名稱-' '- -oracleHome--Oracle 起始目錄路徑-' >--+------------------------+--+--------------------+-----------> '- -scriptDir--Script 目錄-' '- -permanent--永久表格數-' >--+--------------------+-------------------------------------->< '- -temporary--暫存表格數-'
Windows 的指令行語法為:
>>-sibDBUpgrade.bat--+----------------------------+-------------> '- -runUpgrade--true 或 false-' >--+--------------------+--+---------------------+--------------> '- -dbUser--資料庫使用者名稱-' '- -dbSchema--資料庫綱目名稱-' >--+-----------------+--+---------------------+-----------------> '- -dbType--資料庫類型-' '- -serverName--伺服器名稱-' >--+-----------------+--+---------------------+-----------------> '- -dbName--資料庫名稱-' '- -dbPassword--資料庫密碼-' >--+-------------------+--+-----------------------------+-------> '- -dbNode--資料庫節點名稱-' '- -oracleHome--Oracle 起始目錄路徑-' >--+------------------------+--+--------------------+-----------> '- -scriptDir--Script 目錄-' '- -permanent--永久表格數-' >--+--------------------+-------------------------------------->< '- -temporary--暫存表格數-'
用途
資料庫管理者可以使用 sibDBUpgrade 公用程式指令來變更傳訊引擎的 DBMS 資源。 sibDBUpgrade 指令會產生 DDL 陳述式供資料庫管理者儲存,稍後可處理這些 DDL 陳述式來變更變更的資料庫表格所列的 DBMS 資源。 除了資料庫管理者,有權變更資料庫表格的使用者也可以利用此公用程式來變更資料庫表格。
如果要存取 IBM® i 指令行,請使用 STRQSH 指令啟動 Qshell 階段作業。
如需相關資訊,請參閱利用 wsadmin Script 配置 Qshell 來執行 WebSphere Script.
必要參數
提示: sibDBUpgrade 指令區分大小寫。
例如,參數值 Oracle 與參數值 oracle 不相同。
- -runUpgrade true 或 false [適用於 z/OS、Derby 及 Informix,值必須為 false]
- 用於變更資料庫資源的指令。將參數值指定為 true 可以變更資料庫資源,而指定為 false 只會產生 DDL Script。
- -dbUser
- 用來與 DBMS 互動的使用者 ID 的名稱。
- -dbSchema
- 綱目的名稱,此綱目包含傳訊引擎使用的所有物件。
- -dbType
- 識別 DBMS 的類型。有效值如下:
- DB2
- Oracle
- SqlServer
- Sybase
- Informix
- Derby
註: 支援 zos 和 iseries 平台上的 DB2。
選用參數
- -dbName
- 配置給傳訊引擎表格的資料庫名稱。如果 runUpgrade 參數的值指定為 true,則 -dbName 為必要參數。
- -serverName
- 用來與 DBMS 互動的伺服器的名稱。如果未提供 -serverName 參數,預設值為 IBMUSER。
- -dbPassword
- 用來與 DBMS 互動的使用者 ID 的密碼。
- -dbNode
- 資料庫節點的名稱。此選用參數僅適用於 DB2。使用 -runUpgrade 選項執行 Script 的系統上必須只安裝 DB2 用戶端。
- -oracleHome
- -dbType 參數值為 Oracle 時,Oracle Home 目錄的路徑。
- -scriptDir
- 目錄的名稱,DDL Script 必須在此目錄中產生。如果未指定目錄,則會在 <current_directory>/SIBusUpgradeDatabase 目錄中產生 Script,其中 current_directory 是作用中的目錄。
- -permanent
- 建立服務整合傳訊引擎時建立的永久表格數。如需配置的表格數的相關資訊,請參閱 資料儲存庫 [設定]。依預設有一個永久表格。如果傳訊引擎配置為使用多個永久表格,請指定表格數。
- -temporary
- 建立服務整合傳訊引擎時建立的暫存表格數。如需配置的表格數的相關資訊,請參閱 資料儲存庫 [設定]。依預設有一個暫存表格。如果傳訊引擎配置為使用多個暫存表格,請指定表格數。
範例
將服務整合匯流排的資料庫綱目從舊版 WebSphere Application Server 升級至 9.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 升級至 9.0 版。
- sibDBUpgrade.bat runUpgrade=false dbUser=db2inst1 dbSchema=SIBusMESchema dbType=DB2
- sibDBUpgrade.bat runUpgrade=true dbName=SIBus dbUser=db2inst1 dbSchema=SIBusMESchema dbType=DB2