オブジェクトをリストに組み込む方法
LISTDEF 制御ステートメントのオプションを使用すると、どのオブジェクトをリストに組み込むかを指定できます。 INCLUDE 文節は、オブジェクトをリストに追加します。 EXCLUDE 文節は、オブジェクトをリストから除去します。
最初に INCLUDE 文節を指定する必要があります。その後に、後続の INCLUDE または EXCLUDE 文節 を任意の順序で指定して、オブジェクトを既存のリストに追加したり、リストから削除することができます。
Db2® は、リストにオブジェクトを追加、またはリストからオブジェクトを除去する ことによって、一度に 1 つの文節でリストを構成します。EXCLUDE 文節が、まだリストに 存在しないオブジェクトを除去しようとすると、Db2 は そのオブジェクトの EXCLUDE 文節を無視して、次の INCLUDE または EXCLUDE 文節に進みます。 除外されたオブジェクトを、後続の INCLUDE でリストに戻せることに注意してください。
INCLUDE または EXCLUDE のいずれかを指定する必要があります。 デフォルト指定はありません。
オブジェクトの組み込みまたは除外の指定
各 INCLUDE または EXCLUDE 文節は、リストに追加したり、リストから除去する 特定のオブジェクトを示します。
各 INCLUDE または EXCLUDE 文節では、以下のエレメントを含める必要があります。
- それぞれの INCLUDE または EXCLUDE 文節ごとに、初期カタログ検索で使用するオブジェクト。 オブジェクトの検索は、データベース、表スペース、索引スペース、表、索引、その他のリストで 開始することができます。 これらのオブジェクトの名前を明示的に指定するか、あるいはパターン・マッチング式を使用 (その他のリストの場合を除く) することができます。 結果のリストには、表スペースのみ、索引スペースのみ、あるいはその両方が含まれます。
- リストに含まれるオブジェクトのタイプは、TABLESPACES または INDEXSPACES のいずれか
です。DATABASE キーワードを使用して初期オブジェクトとしてデータベースを指定する場合のみ、
リスト・タイプを明示的に指定する必要があります。
それ以外の場合は、LISTDEF は、次の表に示す
デフォルトのリスト・タイプ値を使用します。
これらの値は、INCLUDE または EXCLUDE 文節で指定したオブジェクトのタイプによって異なります。
表 1. LISTDEF が使用するデフォルトのリスト・タイプ値 指定されたオブジェクト デフォルトのリスト・タイプ値 TABLESPACE TABLESPACES TABLE TABLESPACES INDEXSPACE INDEXSPACES INDEX INDEXSPACES LIST 既存のリスト・タイプ値
例えば、次の INCLUDE 文節は、表スペース DBLT0301.TLLT031A を LIST に追加する 指定を行っています。
INCLUDE TABLESPACE DBLT0301.TLLT031A
上記の例では、初期カタログ検索に LISTDEF が使用するオブジェクトとして、 表スペース DBLT0301.TLLT031A が指定されています。 デフォルトでは、TABLESPACE オブジェクトのリスト・タイプ値は TABLESPACES です。 したがって、このリストには表スペース DBLT0301.TLLT031A のみが含まれます。
次の INCLUDE 文節の例は、INDEXSPACES キーワードが入っていることを除けば、前の例と似ています。
INCLUDE INDEXSPACES TABLESPACE DBLT0301.TLLT031A
この例では、この文節は、表スペース DBLT0301.TLLT031A にあるすべての表の全索引スペースをリストに 追加する指定を行っています。
オプションで、関係を示すキーワードを指定して、リストに参照関連オブジェクトまたは 補助関連オブジェクトなどの関連オブジェクトを追加することができます。 有効な指定には、次のキーワードがあります。
- BASE (非 LOB および非 XML オブジェクト)
- LOB (LOB オブジェクト)
- XML (XML オブジェクト)
- ALL (BASE、LOB、および XML オブジェクト)
- TABLESPACES (関連する表スペース)
- INDEXSPACES (関連する索引スペース)
- RI (参照制約による関連、通知参照制約を含む)
上記のキーワードは 2 つの機能があります。すなわち、どのオブジェクトが関連しているかを決定し、 その後、リストの内容をフィルターに掛けることです。 これらのキーワードがどのように動作するかは、指定したオブジェクトのタイプによって異なります。 例えば、初期オブジェクトが LOB オブジェクトの場合には、LOB キーワードは無視されます。 しかしながら、初期オブジェクトが LOB オブジェクトではない場合は、LOB キーワードは 関連する LOB オブジェクトを判別し、Db2 は非 LOB オブジェクトをリストから除外します。
Db2 は、それぞれの INCLUDE および EXCLUDE 文節を次の順序で処理します。
- 指定されたパターン・マッチング表現 (PARTLEVEL 指定がある場合はそれも含む) に基づいた オブジェクトの初期検索を実行します。あるオブジェクトが停止すると、そのオブジェクトが後で除外されるものであっても、Db2 はエラーを返します。
- 関連するオブジェクトを追加または除去し、さらに指定されたリスト・タイプ、 すなわち、TABLESPACES または INDEXSPACES (COPY YES あるいは COPY NO) のいずれかに基づいて、 リスト・エレメントをフィルターに掛けます。
- RI、BASE、LOB、XML、および ALL のキーワードの有無に応じて、関連するオブジェクトを追加 または除去します。
例えば、ACCOUNT データベースで、すべての LOB 表スペースを除外したすべての表スペースの リストを生成するには、次の LISTDEF ステートメントを指定します。
LISTDEF ACCNT INCLUDE TABLESPACES DATABASE ACCOUNT BASE
この例では、リストの名前は ACCNT です。TABLESPACES キーワードは、指定されたオブジェクトに関連した 表スペースをリストに組み込むことを示しています。 この場合、組み込まれる表スペースは、データベース ACCOUNT にある表スペースです。 最後に、BASE キーワードは、オブジェクトを基本表スペースのみに限定しています。
ACCOUNT データベースの LOB 索引スペースのみのリストを生成する場合は、 次の LISTDEF ステートメントで指定できます。
LISTDEF ACLOBIX INCLUDE INDEXSPACES DATABASE ACCOUNT LOB
上記の例では、INDEXSPACES および LOB キーワードは、INCLUDE 文節では LOB 索引スペース のみを ACLOBIX リストに追加することを示しています。
- TABLESPACE DSNDB01.SYSUTILX
- TABLE SYSIBM.SYSUTILX
- TABLE SYSIBM.SYSUTIL
- INDEXSPACE DSNDB01.DSNLUX01
- INDEXSPACE DSNDB01.DSNLUX02
- INDEX SYSIBM.DSNLUX01
- INDEX SYSIBM.DSNLUX02
パターン・マッチング式の使用
4 つの特殊パターン・マッチング文字 (%、*、_、?) を使用して、LISTDEF ステートメントで 総称オブジェクト名を定義することができます。これらの文字は、SQL LIKE 述部で使用される 文字に似ています。リストを参照するユーティリティーでは、実行時に Db2 カタログにアクセスし、 それぞれの総称オブジェクト名をそれに対応する列挙型リストに動的に展開します。 ユーティリティーは、ユーティリティー機能およびユーザーが指定したパラメーターに従って、 順次にもしくは並列に、この列挙型リストを処理します。
Db2 のカタログとディレクトリー・オブジェクト (DSNDB06 および DSNDB01) のパターン・マッチングはサポートされていません。 カタログおよびディレクトリー・オブジェクトは、表スペースまたは索引スペースの完全名によって LISTDEF に組み込む必要があります。 カタログおよびディレクトリー・オブジェクトは、たとえ LISTDEF のパターン・マッチング表現と一致していても、リストには組み込まれません。これらのオブジェクトを処理するには、バージョン 7 より前のリリースでの構文を使用する必要があります。
次の表に示すパターン・マッチング文字を使用して、 パターン・マッチングのオブジェクト名を指定します。 この表では、パターン・マッチング文字、同等の SQL シンボル、および追加情報を示しています。
| LISTDEF パターン・ マッチング 文字 |
SQL LIKE 述部で使用される同等のシンボル | 使用上の注意 |
|---|---|---|
| パーセント記号 (%) | パーセント記号 (%) | 同一機能を実行。 |
| 疑問符 (?) | 下線 (_) | 表および索引の名前には、パターン・マッチング文字として 下線文字 (_) の代わりに疑問符 (?) を使用。 表名および索引名に含まれる下線文字 (_) は、 その文字そのものが 1 つ現れることを表す。 |
| アスタリスク (*) | パーセント記号 (%) | 同一機能を実行。 |
| 下線 (_) | 下線 (_) | データベース、表スペース、および索引スペースの名前には、パターン・マッチング文字として 疑問符 (?) の代わりに下線文字 (_) を使用。 |
カタログおよびディレクトリー・オブジェクトを組み込む
Db2 ディレクトリー・オブジェクト (DSNDB01) および Db2 カタログ・オブジェクト (DSNDB06) を オブジェクト・リストに指定する場合は、これらのオブジェクトに対して、 完全修飾された表スペース名または索引スペース名を使用する必要があります。 カタログ・オブジェクトまたはディレクトリー・オブジェクトでは、パターン・マッチング はサポートされていません。Db2 は、ユーティリティーで無効なカタログ・オブジェクトまたはディレクトリー・オブジェクトに対して、エラー・メッセージを出します。
Db2 カタログおよびディレクトリー・オブジェクトを LISTDEF リストに表示できる場合であっても、 これらのオブジェクトはユーティリティーで無効なため、エラー・メッセージが出力される結果となる ことがあります。
以下の有効な INCLUDE 文節は、カタログおよびディレクトリー・オブジェクトを含んでいます。
-

INCLUDE TABLESPACE DSNDB06.SYSDDF
-

INCLUDE TABLESPACES TABLESPACE DSNDB06.SYSDDF
-
INCLUDE INDEXSPACE DSNDB06.DSNDXX01 -
INCLUDE INDEXSPACES INDEXSPACE DSNDB06.DSNDXX01
- DATABASE
- TABLE
- INDEX
- BASE
- LOB
- ALL
- データベース DSNDB01、DSNDB06 および DSNDB07
- 作成者 ID が SYSIBM である表および索引
すべての LISTDEF リストでは、DSNDB07 オブジェクトとユーザー定義作業ファイル・オブジェクト から構成されている作業ファイル・データベースは、自動的に除外されます。 その理由は、Db2 ユーティリティーではこれらのオブジェクトを処理しないためです。