sibDDLGenerator 指令
傳訊引擎需要資料定義語言 (DDL) 陳述式來建立 DBMS(資料庫管理系統)資源。 這些 DBMS 資源由 sibDDLGenerator 指令產生。
語法
>>-sibDDLGenerator--+-------------------+-----------------------> '- -system--DBMS 名稱-' >--+--------------------+--+---------------------+--------------> '- -version--DBMS 版本-' '- -platform--DBMS 平台-' >--+----------------+--+---------------+--+----------+----------> '- -schema--綱目名稱-' '- -user--使用者名稱-' +- -create-+ '- -drop---' >--+-----------------+--+-----------------------+---------------> '- -database--資料庫-' '- -storagegroup--儲存體群組-' >--+------------------+--+-------------------+------------------> '- -catalog--高階限定元-' '- -bufferpool--緩衝池-' >--+-----------------------+--+----------------+----------------> '- -statementend--陳述式結束-' '- -nolinebreaks-' >--+----------------+--+------------------+---------------------> '- -noblanklines-' '- -firstline--第一行-' >--+------------------+--+-----------------+--------------------> '- -lastline--最後一行-' '- -permanent--數字-' >--+-----------------+----------------------------------------->< '- -temporary--數字-'
用途
傳訊引擎需要有它啟動時可建立的 DBMS 資源,例如資料庫表格。 如果您的安裝有一項原則規定只有資料庫管理者才有權建立資料庫表格,請使用 sibDDLGenerator 指令,讓資料庫管理者能夠建立傳訊引擎所需的 DBMS 資源。 sibDDLGenerator 指令會產生 DDL 陳述式供資料庫管理者儲存,稍後可處理這些 DDL 陳述式來建立資料儲存庫表格所列的 DBMS 資源。
此指令也會產生 DDL 陳述式來授與適當權限給傳訊引擎使用這些表格。
如果要存取 IBM® i 指令行,請使用 STRQSH 指令啟動 Qshell 階段作業。
如需相關資訊,請參閱利用 wsadmin Script 配置 Qshell 來執行 WebSphere Script.
選用參數
如參數清單所示,部分參數僅適用於特定的 DBMS;例如:-database [僅適用於 DB2® for z/OS]
- -system
- 指出供管理者處理 DDL 陳述式的 DBMS 類型。有效值如下:
- 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 for UNIX 或 Windows 產生的 DDL 相同。 使用 -version 參數值 7.1、8.1 和 9.1 為 DB2 for 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 互動的使用者 ID 的名稱。如果未提供 -user 參數,預設值為 IBMUSER。
- -create | -drop
- 指出 DDL 陳述式是建立或刪除 DBMS 資源。如果未提供任一參數,預設值為 -create。
- -database [僅適用於 DB2 for z/OS]
- 配置給傳訊引擎表格的資料庫名稱。如果未提供 -database 參數,預設值為 SIBDB。
- -storagegroup [僅適用於 DB2 for z/OS]
- 配置給傳訊引擎表格的儲存體群組名稱。
- 如果同時提供 -storagegroup 和 -catalog 參數,sibDDLGenerator 指令會將兩個值都加入 CREATE STOGROUP 陳述式中。
- 如果只提供 -storagegroup 參數,sibDDLGenerator 指令會在其他陳述式中使用儲存體群組名稱,但不會建立 CREATE STOGROUP 陳述式。
- 如果只提供 -catalog 參數,sibDDLGenerator 指令會顯示用法陳述式,然後就終止。
- 如果兩個參數都省略,sibDDLGenerator 指令會在其他陳述式中使用預設值 SIBSG 作為儲存體群組名稱,但不會建立 CREATE STOGROUP 陳述式。
- -catalog [僅適用於 DB2 for z/OS]
- 配置給傳訊引擎表格的儲存體群組的高階限定元名稱。如需預設值的相關資訊,請參閱 -storagegroup 參數。
- -bufferpool [僅適用於 DB2 for 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 來呼叫指令執行 Script 中的指令。依預設,sibDDLGenerator 指令不會產生最後一行。
下列兩個選用參數用於將資料儲存庫分散成多個表格:
- -permanent
- 永久表格的數目:
- 預設值:1
- 最小值:1
- 最大值:請參閱附註
- -temporary
- 暫存表格的數目:
- 預設值:1
- 最小值:1
- 最大值:請參閱附註
範例
- sibDDLGenerator -system db2 -version 8.1 -platform zos
使用預設的綱目、使用者 ID、資料庫、儲存體群組及緩衝池,為 z/OS 上執行的 DB2 8.1 產生 DDL 陳述式。
- sibDDLGenerator -system db2 -version 8.1 -platform windows -statementend ;
使用預設的綱目、使用者 ID 及資料庫,為 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
前述範例的精簡版本。