SYSINSTALLOBJECTS プロシージャー

SYSINSTALLOBJECTS プロシージャーは、特定のツールで必要なデータベース・オブジェクトを作成またはドロップします。

構文

スキーマは SYSPROC です。

プロシージャー・パラメーター

tool-name

以下のいずれかの値を使用して、ロードされるツールの名前を指定する、タイプ VARCHAR(128) の入力引数。

'Db2AC' (自立走行式コンピューティングの場合 (ヘルス・モニター))
'STMG_DBSIZE_INFO' (ストレージ管理の場合)
'OPT_PROFILES' (最適化プロファイル表を作成する場合)
'POLICY' (ポリシーの場合 (表およびトリガー))
'EXPLAIN' (Explain 表を作成またはマイグレーションする場合)
'INGEST' (INGEST ユーティリティーで使用される再始動表を作成する場合)
'REPL_MQT' (シャドー表の待ち時間表を作成する場合)

action

実行予定のアクションを指定する、タイプ CHAR(1) 入力引数。有効な値は以下のとおりです。

C: オブジェクトを作成します。
D: オブジェクトをドロップします。
V: オブジェクトを検証します。
M: オブジェクトをマイグレーションします。 M オプションは、ツール名 EXPLAIN と共に使用する場合にのみ有効です。このオプションは、バージョン 7 以降で作成された Explain 表をマイグレーションして、現行バージョンとの互換性を持たせます。

tablespace-name

オブジェクトを作成するときの表スペースの名前を指定する、タイプ VARCHAR(128) の入力引数。値を指定しないか、値が空またはブランク・ストリングである場合には、ツール名が AM であればデフォルトのユーザー・スペースが使用されます。ツール名が EXPLAIN でアクションが M である場合には、入力表スペース名は無視されて、マイグレーション対象の Explain 表が作成された表スペースが使用されます。それ以外の場合は、SYSTOOLSPACE 表スペースが使用されます。 SYSTOOLSPACE がまだ存在しない場合は、作成されます。

schema-name

'EXPLAIN' tool-name オプションを除く、入力パラメーターとして渡される schema-name に関係なく、SYSTOOLS が必ずスキーマとして使用されます。

'EXPLAIN' tool-name オプションに対しては、入力の schema-name を渡すことができ、指定されたその schema-name で表が作成されます。 schema-name が入力パラメーターとして渡されない場合は、SYSTOOLS スキーマが使用されます。

許可

このプロシージャーを実行するには、以下のいずれかの権限が必要です。

プロシージャーでの EXECUTE 特権
DATAACCESS 権限
DBADM 権限
SQLADM 権限

デフォルトの PUBLIC 特権

制限のないデータベースでは、このプロシージャーが自動的に作成されると、EXECUTE 特権が PUBLIC に付与されます。

例

すべての Explain 表をマイグレーションする。

CALL SYSPROC.SYSINSTALLOBJECTS('EXPLAIN', 'M', CAST (NULL AS VARCHAR(128)),
   CAST (NULL AS VARCHAR(128)))

自律型コンピューティング (ヘルス・モニター) に使用されるオブジェクトを検証する。
```
CALL SYSPROC.SYSINSTALLOBJECTS('Db2AC', 'V', CAST (NULL AS VARCHAR(128)), 
   CAST (NULL AS VARCHAR(128)))
```
この CALL ステートメントの結果、メッセージは以下のようになります。
```
SQL0438N 
Application raised error or warning with diagnostic text: "Db2AC INVALID". 
SQLSTATE=3900
```