PLAN_TABLE インスタンスでのアクセス・パスの指定

特定の単一の許可 ID によって発行された SQL ステートメントに対して特定のアクセス・パスを施行するために、PLAN_TABLE アクセス・パスを作成できます。

始める前に

プログラム固有のプログラミング・インターフェース情報の開始
以下の前提条件を満たしていること。
  • アクセス・パスを管理するための準備を行う。
  • PLAN_TABLE 表のインスタンスが、SQL ステートメントを発行した許可 ID で作成されている。
  • 索引は、PLAN_TABLE の以下の列に作成されます。
    • QUERYNO
    • APPLNAME
    • PROGNAME
    • VERSION
    • COLLID
    • OPTHINT

    索引を作成するサンプル・ステートメントは、SDSNSAMP ライブラリーのメンバー DSNTESC に組み込まれています。

このタスクについて

PLAN_TABLE アクセス・パスを指定すると、それは、指定された特定の SQL ステートメントに対してのみ、しかも、指定のアクセス・パスを含む PLAN_TABLE インスタンスを所有する許可 ID によって発行されたステートメントのインスタンスに対してのみ施行されます。 Db2 は、他の許可 ID によって発行された同一ステートメントのインスタンスに対しては、指定されたアクセス・パスを使用しません。

また、他のメソッドを使用して、ステートメントを発行した許可 ID に関係なく、ステートメントの複数のインスタンスのアクセス・パス選択に影響を与えることができます。 ステートメント・レベルでアクセス・パスを指定する方法の詳細については、ステートメント・レベルでのアクセス・パスの指定を参照してください。

Db2 が既存のアクセス・パスの施行を試みるように、PLAN_TABLE アクセス・パスを使用して指定することができますが、静的 SQL ステートメントの再バインド時にアクセス・パスの変更を防止するための望ましい方法は、APREUSE バインド・オプションを指定することです。同様に、動的 SQL ステートメントの準備時にアクセス・パスの変更を防止するための望ましい方法は、プラン管理ポリシーを指定することです。アクセス・パスの再使用方法の詳細については、バインドおよび再バインド時のアクセス・パスの再利用と比較を参照してください。

手順

PLAN_TABLE インスタンスでアクセス・パスを指定するには、次のようにします。

  1. オプション: SQL ステートメントに QUERYNO 節を含めます。 以下の照会には QUERYNO 文節の例が含まれています。
    SELECT * FROM T1
      WHERE C1 = 10 AND
            C2 BETWEEN 10 AND 20 AND
            C3 NOT LIKE 'A%'
      QUERYNO 100;
    このステップは、PLAN_TABLE インスタンスでアクセス・パスを指定するために必要なわけではありません。 ただし、各 SQL ステートメントを識別するために照会番号を指定することで、PLAN_TABLE の行と対応する SQL ステートメントの間の関係におけるあいまいさを解消することができます。

    例えば、動的アプリケーションのステートメント番号は、アプリケーションでステートメントを準備するステートメントの番号です。DSNTEP2 などの一部のアプリケーションでは、アプリケーション内の同一ステートメントがそれぞれの動的ステートメントを準備しています。これは、それぞれの動的ステートメントに同一のステートメント番号が付いていることを意味します。

    同様に、静的ステートメントが含まれるアプリケーションを変更する場合は、ステートメント番号が変更される恐れがあり、その結果、PLAN_TABLE の行が変更されたアプリケーションと同期しなくなります。QUERYNO 文節を使用したステートメントは、ステートメント番号には依存していません。PLAN_TABLE の行とアプリケーションで対応するステートメントの間の関係に影響を与えることなく、これらのステートメントを近辺に移動させることができます。

    そのようなあいまいさによって、Db2 が指定されたアクセス・パスを施行できなくなる可能性があります。

  2. SQL ステートメントの PLAN_TABLE 行の OPTHINT 列に指定されたアクセス・パスの名前を挿入します。 このステップにより、Db2 は、アクセス・パスを指定している PLAN_TABLE 行を識別できます。
    UPDATE PLAN_TABLE
      SET OPTHINT = 'NOHYB'
      WHERE QUERYNO = 200 AND
            APPLNAME = ' ' AND
            PROGNAME = 'DSNTEP2' AND
            VERSION = ' ' AND
            COLLID = 'DSNTEP2';
  3. オプション: Db2 に異なるアクセス・パスを施行するよう指示するために PLAN_TABLE 行を変更します。 また、PLAN_TABLE アクセス・パスは、再バインドまたは準備後に同じアクセス・パスの施行を試みる場合にのみ使用できます。 この場合は、このステップを省略できます。ただし、PLAN_TABLE アクセス・パスは、再バインドまたは準備の後に既存のアクセス・パスを施行するための推奨される方法ではないことを覚えておいてください。再バインド時に APREUSE オプションを使用するか、プラン管理ポリシーを代わりに指定してください。

    例えば、ソート・マージ結合 (METHOD = 2) の方がパフォーマンスが上がることがわかっているときに、Db2 がハイブリッド結合 (METHOD = 4) を選択すると仮定します。以下のステートメントを発行できます。

    UPDATE PLAN_TABLE
      SET METHOD = 2 
      WHERE QUERYNO = 200 AND
            APPLNAME = ' ' AND
            PROGNAME = 'DSNTEP2' AND
            VERSION = '' AND
            COLLID = 'DSNTEP2' AND
            OPTHINT = 'NOHYB' AND
            METHOD = 4;
  4. 指定のアクセス・パスを施行するように Db2 に指示します。
    オプション 説明
    動的ステートメントの場合
    1. SET CURRENT OPTIMIZATION HINT = 'hint-name' ステートメントを発行します。
    2. SET CURRENT OPTIMIZATION HINT ステートメントが静的 SQL ステートメントである場合は、プランまたはパッケージを再バインドしてください。
    3. アクセス・パスを使用するステートメントの EXPLAIN ステートメントを発行します。Db2 は、ステートメントのプラン表に行を追加し、'hint-name' 値を HINT_USED 列に挿入します。

    動的ステートメント・キャッシュが有効になっている場合は、Db2 は、動的ステートメント・キャッシュでステートメントの一致が見つからなかった場合のみヒントを使用しようとします。その他の場合は、Db2 は、キャッシュに入れられているプランを使用し、ステートメントを準備したり指定されたアクセス・パスを考慮したりしません。

    静的ステートメントの場合 ステートメントが含まれるプランまたはパッケージを再バインドして、EXPLAIN(YES) オプションと OPTHINT('hint-name') オプションを指定します。
    Db2 は、アクセス・パスを指定している行と SQL ステートメントを突き合わせるときに、PLAN_TABLE の次の列を使用します。
    • QUERYNO
    • APPLNAME
    • PROGNAME
    • VERSION
    • COLLID
    • OPTHINT
    PLAN_TABLE インスタンスでアクセス・パスを指定する場合は、PLAN_TABLE のこれらの列に索引を作成することが最善です。

    Db2 は、指定したアクセス・パスをすべて使用した場合、EXPLAIN ステートメントの PREPARE およびその指定のアクセス・パスを使用する SQL ステートメントの PREPARE から SQLCODE +394 を戻します。 指定したアクセス・パスのいずれかが無効である場合、または重複が検出された場合は、Db2 は SQLCODE +395 を発行します。変更の始まりSUPPRESS_HINT_SQLCODE_DYN サブシステム・パラメーターの値を設定することにより、動的 SQL ステートメントの SQLCODES +394 および +395 を抑止できます。変更の終わり

    Db2 は、アクセス・パスが指定されていることを検出できない場合、別の SQLCODE を戻します。 通常、この SQLCODE は 0 です。また、Db2 は、ヒントが完全に適用されたステートメントの数、適用されていないか部分的に適用されたステートメントの数、および検出されなかったステートメントの数を識別するために、バインド操作の完了時にメッセージを戻します。

  5. PLAN_TABLE から SELECT して、Db2 が指定されたアクセス・パスを使用したかどうかを確認します。 例えば、以下のステートメントを発行できます。
    SELECT *
      FROM PLAN_TABLE
       WHERE QUERYNO = 200
      ORDER BY TIMESTAMP, QUERYNO, QBLOCKNO, PLANNO, MIXOPSEQ; 

    以下の表に、PLAN_TABLE データの例を示します。指定されたアクセス・パスが使用された場合、OPTHINT 列に NOHYB 値が入っています。 HINT_USED 列の NOHYB 値で示されているように、Db2 がこのアクセス・パスを使用したこともわかります。

    表 1. NOHYB アクセス・パスが使用されることを示す PLAN_TABLE
    QUERYNO METHOD TNAME OPTHINTS HINT_USED
    200 0 EMP NOHYB
    200 2 EMPPROJACT NOHYB  
    200 3   NOHYB  
    200 0 EMP   NOHYB
    200 2 EMPPROJECT   NOHYB
    200 3     NOHYB
    プログラム固有のプログラミング・インターフェース情報の終了