バインドまたは再バインド時のアクセス・パスの変更の分析

パッケージを再バインドする際に、アクセス・パスの比較を使用して、どのアクセス・パスが変更されたか確認したり、アクセス・パスの再利用が正常に行われたかどうか検査したりすることができます。

始める前に

プログラム固有のプログラミング・インターフェース情報の開始
以下の前提条件が満たされている必要があります。
  • パッケージには、DB2® 9 以降で作成された SQL ステートメントが入っています。

このタスクについて

アクセス・パスの比較 では、Db2® は、新しいアクセス・パスが以前のアクセス・パスと一致するかどうかを検査します。 この比較では、新しいアクセス・パスを調べ、それを既存のアクセス・パスと比較します。 Db2 は、新しいアクセス・パスと以前のアクセス・パスとの間の不一致を検出すると、PLAN_TABLE.REMARKS 列に不一致に関する情報を書き込みます。

比較が完了すると、Db2 は、再バインド操作後に変更されたアクセス・パスと変更されなかったアクセス・パスの数を示す DSNT285I メッセージを発行します。

比較にはエラーまたは警告のいずれかの規則を指定することができます。 警告規則では、パッケージ内のステートメントにおいて再使用または比較が失敗したかどうかに関係なく、バインド操作は完了します。 エラー規則では、再使用または比較のエラーが検出された場合、ステートメントがすべて処理された後でパッケージのバインド操作が終了します。

Db2 はアクセス・パスの比較を使用して、アクセス・パスの再使用の指定時に結果として得られるアクセス・パスの検証も行います。

手順

バインドまたは再バインド後のアクセス・パスの変更結果にアクセスするには、次のようにします。

  1. 以下のいずれかのバインド・オプションを指定して、アクセス・パスの比較をアクティブにします。
    • 変更の始まりAPREUSE(WARN)。アクセス・パスの再使用の実行を試み、再使用を適用できない場合はアクセス・パスの変更を受け入れ、変更がいつ行われたかを調べます。 このオプションを使用して行われるアクセス・パスの変更結果は、許容できない場合もあるかもしれません。 したがって、以前のアクセス・パスに切り替えられるプラン管理ポリシーも使用することをお勧めします。変更の終わり
    • APCOMPARE(WARN)。新しいアクセス・パスを取得し、変更がいつ行われたかを調べます。 このオプションを使用して行われるアクセス・パスの変更結果は、許容できない場合もあるかもしれません。 したがって、以前のアクセス・パスに切り替えられるプラン管理ポリシーも使用することをお勧めします。
    • APCOMPARE(ERROR)。再使用を試みず、アクセス・パスの変更を受け入れません。
    • APREUSE(ERROR)。再使用の失敗やアクセス・パスの変更を受け入れず、アクセス・パスの再使用の実行を試みます。
  2. 以下のいずれかのバインド・オプションを指定して、Db2 がバインドまたは再バインド操作の EXPLAIN 出力を作成するようにします。
    • EXPLAIN(ONLY) では、バインドおよび再バインド操作が完了されないように指定します。 ただし、Db2 はアクセス・パスを処理し、PLAN_TABLE にアクセス・パスの比較結果情報を取り込みます。 このオプションではバインドや再バインド操作が完了することはないため、EXPLAIN(ONLY) が指定されている場合は APCOMPARE(ERROR) と APCOMPARE(WARN) は同じ意味になります。
  3. コマンドを発行して、パッケージをバインドまたは再バインドします。 アクセス・パスの変更が受け入れられる場合は REBIND PACKAGE コマンドが推奨されます。このコマンドにより、プラン管理ポリシーが使用できるようになるからです。
  4. DSNT285I メッセージを調べて、バインドまたは再バインド操作で変更されたアクセス・パスと変更されなかったアクセス・パスの数を確認します。
    DSNT285I  -csect-name REBIND FOR PACKAGE = package-name,
               USE OF APCOMPARE RESULTS IN:
               75 STATEMENTS WHERE COMPARISON IS SUCCESSFUL
               5 STATEMENTS WHERE COMPARISON IS NOT SUCCESSFUL
               2 STATEMENTS WHERE COMPARISON COULD NOT BE PERFORMED.
    アクセス・パスの再使用を指定した場合は、再使用の成功についての統計を示す DSNT286I メッセージを調べることもできます。
    DSNT286I  -csect-name REBIND FOR PACKAGE = package-name,
               USE OF APREUSE RESULTS IN:
               73 STATEMENTS WHERE APREUSE IS SUCCESSFUL
               7 STATEMENTS WHERE APREUSE IS EITHER NOT SUCCESSFUL
                 OR PARTIALLY SUCCESSFUL
               2 STATEMENTS WHERE APREUSE COULD NOT BE PERFORMED
               0 STATEMENTS WHERE APREUSE WAS SUPPRESSED BY OTHER HINTS.
    Db2 はアクセス・パスの再使用の指定時に比較も使用しますが、比較と再使用は別個の操作です。 Db2 が以前のアクセス・パスを実行するためにヒントを適用することができない場合、再使用は失敗します。新しいアクセス・パスが以前のアクセス・パスと一致しない場合、比較は失敗します。 前述の例のように、再使用が失敗しても、Db2 は以前のアクセス・パスと一致する新しいアクセス・パスを選択する場合があることに注意してください。
  5. PLAN_TABLE を照会し、比較または再使用の結果として Db2 がデータを追加した行を見つけます。

    再使用が成功した場合、Db2 は値「APREUSE」を PLAN_TABLE.HINT_USED 列に挿入します。再使用または比較が失敗した場合、Db2 は PLAN_TABLE.REMARKS 列に失敗に関する情報を取り込みます。

    • 再使用が失敗した場合、Db2 は、SQLCODE +395 の理由コード値に対応する理由コードを挿入します。
    • 比較が失敗した場合、Db2 は不一致に関する情報を挿入します。新規および以前のアクセス・パスの対応する行が一致しない場合、Db2 は、次のように、一致しない値が存在する列を識別します。
      • 古いアクセス・パスと新しいアクセス・パスの両方に存在する行の場合、Db2 は新しいアクセス・パスの対応する行の REMARKS 列で不一致を示します。
      • 新しいアクセス・パスにのみ存在する行の場合、新しい不一致行の REMARKS 列に不一致行が示されます。
      • 古いアクセス・パスにのみ存在する行の場合、新しいアクセス・パスにおける別の行の REMARKS 列に不一致行が示されます。

次のタスク

比較結果に基づいて、以下のいずれかのアクションを行うことができます。
  • 変更の始まり再使用が失敗した場合は、APREUSE(WARN) バインド・オプションを使用して変更を許容できるパッケージを再バインドしてください。変更の終わり メッセージと PLAN_TABLE 出力を使用すれば、アクセス・パスが変更されたパッケージとステートメントのリストを作成できます。 このリストは、パフォーマンスの低下時に問題を切り分けるために役立つ場合があります。
  • アクセス・パスの変更を許容できないパッケージの再使用が失敗した場合は、パッケージを再バインドしないでください。 このオプションは最も慎重な方法ですが、アプリケーションのパフォーマンスを改善できなくなる可能性があります。