EXPLAIN 表でのアクセス・パス情報のキャプチャー
Db2® が SQL ステートメントの処理で使用するアクセス・パスに関する情報を EXPLAIN 表に取り込むことができます。
始める前に
以下の前提条件が満たされている必要があります。
- 適切なスキーマを使用する EXPLAIN 表 (PLAN_TABLE を含む) が存在する。
- 必要な権限と特権がある。権限および特権について詳しくは、EXPLAINを参照してください。
手順
SQL ステートメントの EXPLAIN 情報を収集するには、以下のいずれかの方法を使用します。
- EXPLAIN ステートメントを発行します。 別の許可 ID で作成された EXPLAIN 表で別名が定義され、
適切な SELECT 特権と INSERT 特権がある場合は、自分の所有でない EXPLAIN 表にもデータを追加することがきます。
EXPLAIN ステートメントは、アプリケーション・プログラムから静的に発行することも、QMF™、SPUFI、またはコマンド行プロセッサーを使用して動的に発行することもできます。
Db2 がアクセス・パス情報をキャプチャーするために使用するプロセスは、EXPLAIN ステートメントに指定したオプションに応じて決まります。 例えば、PLAN FOR explainable-statement オプションを指定すると、Db2 はアクセス・パス選択プロセスを使用してアクセス・パス情報を生成します。
ただし、PACKAGE オプションを指定した場合、Db2 は、パッケージのバインド時にステートメントに対して選択された既存のアクセス・パスの情報を抽出します。 同様に、STMTCACHE オプションを指定した場合、Db2 は、ステートメントが準備され、動的ステートメント・キャッシュに入れられたときに選択された、既存のアクセス・パスの情報を抽出します。
- プランまたはパッケージをバインドするときに EXPLAIN(YES) オプションを指定します。 EXPLAIN(YES) を指定した場合、結果をプラン表に挿入するために必要な追加処理はごくわずかです。
EXPLAIN(YES) と EXPLAIN (NO) のどちらを使用しても、実行されるアクセス・パスの選択処理は同じです。
以前に EXPLAIN(YES) を指定してバインドしたプランまたはパッケージを自動的に再バインドする場合、ABEXP サブシステム・パラメーターの値で、EXPLAIN 情報を自動再バインド中に再度収集するかどうかが決まります。 このときも、結果を プラン表に挿入するために必要なオーバーヘッドはごくわずかです。
EXPLAIN(YES) バインド・オプションを指定すると、情報は package_owner.PLAN_TABLE 表または plan_owner.PLAN_TABLE 表に示されます。 動的に準備された SQL の場合は、PLAN_TABLE の修飾子が 現行 SQLID です。プラン所有者またはパッケージ所有者が、 別所有者が作成した PLAN_TABLE 上に別名を持っている 場合、package_owner.PLAN_TABLE または plan_owner.PLAN_TABLE では なく、other_owner.PLAN_TABLE にデータが追加されます。
- BIND コマンドまたは REBIND コマンドを発行し、EXPLAIN(ONLY) オプションを指定します。 EXPLAIN 表には、EXPLAIN(YES) が指定されている場合と同じようにデータが追加されます。 ただし、パッケージのバインド操作や再バインド操作は完了しません。 指定されたパッケージが既に存在する場合、それが除去されたり置換されたりすることはありません。
- リモート・バインドでは、サーバーでのパッケージのバインド時に EXPLAIN(YES) を指定できます。以下のいずれかの方法を使用することができます。
- Db2 サーバー上のパッケージをバインドするときに、リモート・リクエスターから EXPLAIN(YES) を指定します。この情報はリクエスターでは なくサーバーのプラン表に収められます。
- リクエスターが EXPLAIN(YES) オプションの伝搬をサポートしていない場合は、 リクエスター上でパッケージを再バインドし、EXPLAIN(YES) を指定します。
- アプリケーションで CURRENT EXPLAIN MODE 特殊レジスターを指定します。 この方法を使用すれば、アプリケーション・ロジックに変更を加えずに、特定のユーザーおよびアプリケーションの動的ステートメントについて EXPLAIN 情報を収集できます。
CURRENT EXPLAIN MODE 特殊レジスターに対して YES または EXPLAIN を指定すると、EXPLAIN 情報は、 REOPT(NONE) オプションでバインドされたパッケージの準備フェーズ中と、REOPT(ONCE | ALWAYS | AUTO) バインド・オプションでバインドされたパッケージの実行時にステートメントが再最適化されるときに収集されます。オプション 説明 CURRENT EXPLAIN MODE = NO EXPLAIN 可能の動的ステートメントの実行時に EXPLAIN 情報はキャプチャーされません。NO がデフォルト値です。 CURRENT EXPLAIN MODE = YES EXPLAIN 可能の動的 SQL ステートメントは通常どおり実行され、各ステートメントが準備され、実行された後、EXPLAIN 表に情報がキャプチャーされます。 CURRENT EXPLAIN MODE = EXPLAIN EXPLAIN 可能の動的 SQL ステートメントは実行されませんが、アプリケーションで各ステートメントが準備された後、EXPLAIN 表に情報がキャプチャーされます。CURRENT EXPLAIN MODE = EXPLAIN で実行した場合、ステートメントが実際に正常に実行されることに基づくロジックを使用するアプリケーションは失敗します。単純なアプリケーション・ロジックを使用するアプリケーションでのみ、このオプションを使用する必要があります。 例えば、以下のアプリケーション・プログラムには動的ステートメントが含まれており、ステートメントが準備され、実行された後、EXPLAIN 情報が生成され、EXPLAIN 表に挿入されます。
EXEC SQL DECLARE C1 CURSOR FOR PREP_STMT; SOURCE_STMT = 'SELECT X, Y, Z FROM SCHEMA.TABLE1 WHERE X < Y '; EXEC SQL SET CURRENT EXPLAIN MODE = YES; EXEC SQL PREPARE PREP_STMT FROM SOURCE_STMT; EXEC SQL OPEN C1;