ステートメント・レベルでのアクセス・パスの指定

ステートメント・レベルのアクセス・パスを作成することで、Db2® が、指定された有効範囲内の特定の SQL ステートメントのすべてのインスタンスに対して特定のアクセス・パスを使用するように提案できます。

始める前に

プログラム固有のプログラミング・インターフェース情報の開始
以下の前提条件を満たしていること。
  • アクセス・パスを管理するための準備を行う。
  • 次の権限のいずれかを所有している。
    • SQLADM
    • SYSOPR
    • SYSCTRL
    • SYSADM
  • 既存のスキーマまたは入力表用の別個のスキーマを使用する、以下のユーザー表のインスタンスが存在します。
    • DSN_USERQUERY_TABLE
    • PLAN_TABLE
    別個のスキーマを使用する表を使用する方法について詳しくは、別個のスキーマを使用する入力 EXPLAIN 表の作成を参照してください。prefix.SDSNSAMP ライブラリーのメンバー DSNTESC および DSNTESH 内に、表および関連する索引のサンプル CREATE ステートメントがあります。
  • 索引は、PLAN_TABLE の以下の列に作成されます。
    • QUERYNO
    • APPLNAME
    • PROGNAME
    • VERSION
    • COLLID
    • OPTHINT

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

  • ステートメントが入ったパッケージは、BIND PACKAGE ステートメントによって作成されています。アクセス・パスに影響を及ぼすステートメント・レベルの方式は、他のステートメント (CREATE FUNCTION、CREATE TRIGGER、および CREATE PROCEDURE ステートメントなど) によって作成されたパッケージ内のステートメントではサポートされません。

このタスクについて

ステートメント・レベルのアクセス・パスでは、ステートメント・テキストのマッチングを使用して、以下のいずれかの有効範囲内のステートメントのすべてのインスタンスに、指定されたアクセス・パスを適用します。

  • システム全体
  • 任意のバージョンの特定のコレクションとパッケージから
  • 特定のバージョンのコレクションとパッケージから

手順

ステートメント・レベルのアクセス・パスを作成するには、次のようにします。

  1. DSN_USERQUERY_TABLE 表に行を INSERT します。
    1. 以下の列に値を挿入して、アクセス・パスを適用する SQL ステートメントおよびコンテキストを指定します。
      QUERYNO
      実行するアクセス・パスを記述する既存の PLAN_TABLE 行の QUERYNO 列の値と相関する値を挿入します。
      SCHEMA
      SQL ステートメントに、異なるデフォルト・スキーマに解決される可能性のある非修飾オブジェクト名がいくつか含まれている場合、非修飾のデータベース・オブジェクトを識別するスキーマ名を挿入します。ステートメントに非修飾オブジェクト名が含まれる場合、ステートメントが異なるタイミングで異なるスキーマに適用される可能性があるために、可能性のある SCHEMA 値ごとに別個のヒントまたはオーバーライドを作成する必要があります。ステートメントに完全修飾オブジェクト名だけが含まれる場合は、SCHEMA 値は不要です。ただし、特定のスキーマに関連したヒントを見分けやすくするために、SCHEMA 値を挿入することができます。
      QUERY_TEXT
      影響を及ぼすアクセス・パスが含まれるステートメントのテキストを挿入します。

      指定するテキストは、静的 SQL ステートメントをバインドして、動的 SQL ステートメントを準備する際に Db2 が使用するステートメント・テキストと一致する必要があります。正常にテキストが一致するようにする方法については、ステートメント・レベルのマッチングの照会テキストの取り込みを参照してください。

      HINT_SCOPE
      ステートメントを突き合わせるコンテキストを指定するための値を挿入します。
      0
      システム全体。Db2 は SQL ステートメントのテキストのみを使用し、SCHEMA 列に値が含まれている場合はその値を使用して、ステートメントが一致するかどうかを判別します。
      1
      パッケージ・レベル。Db2 は、COLLECTION、PACKAGE、および VERSION 列の値を使用して、ステートメントが一致するかどうかを判別します。
      COLLECTION
      パッケージのコレクション名を挿入します。この値は、HINT_SCOPE の値が 1 の場合のみ必要です。

      HINT_SCOPE の値が 0 (この値はオプションです) であれば、値が指定されている場合は、Db2 は、一致する値が SYSIBM.SYSPACKAGE カタログ表に見つからないときに照会のバインド時にエラー・メッセージを出します。HINT_SCOPE が 0 の場合、COLLECTION および PACKAGE の両方を指定するか、両方のフィールドをブランクのままにします。

      静的 SQL ステートメントおよび動的 SQL ステートメントで DYNAMICRULES(BIND) オプションを使用する場合、Db2 が SYSIBM.SYSPACKSTMT カタログ表から正しいアプリケーション・デフォルト値を取得できるように、この列の値を指定しなければならない場合があります。

      PACKAGE
      パッケージの名前を挿入します。この値は、HINT_SCOPE の値が 1 の場合のみ必要です。

      HINT_SCOPE の値が 0 (この値はオプションです) であれば、値が指定されている場合は、Db2 は、一致する値が SYSIBM.SYSPACKAGE カタログ表に見つからないときに照会のバインド時にエラー・メッセージを出します。HINT_SCOPE が 0 の場合、COLLECTION および PACKAGE の両方を指定するか、両方のフィールドをブランクのままにします。

      静的 SQL ステートメントおよび動的 SQL ステートメントで DYNAMICRULES(BIND) オプションを使用する場合、Db2 が SYSIBM.SYSPACKSTMT カタログ表から正しいアプリケーション・デフォルト値を取得できるように、この列の値を指定しなければならない場合があります。

      パッケージ限定の有効範囲を使用する主な目的は、ステートメント・レベルのヒントをシステム全体の有効範囲にデプロイする前に、ステージング、検証、およびテストをサポートすることです。

      VERSION
      パッケージのバージョン ID または「*」を挿入します。この列の値は、HINT_SCOPE の値が 1 の場合のみ必要です。VERSION 列に「*」を指定する場合は、Db2 では、ステートメントが一致するために VERSION 列が一致している必要はありません。

      HINT_SCOPE の値が 0 の場合は、この値はオプションです。値が指定されている場合は、Db2 は、一致する値が SYSIBM.SYSPACKAGE カタログ表に見つからないときに照会のバインド時にエラー・メッセージを出します。

      静的 SQL ステートメントおよび動的 SQL ステートメントで DYNAMICRULES(BIND) オプションを使用する場合、Db2 が SYSIBM.SYSPACKSTMT カタログ表から正しいアプリケーション・デフォルト値を取得できるように、この列の値を指定しなければならない場合があります。

      変更の始まりSELECTVTY_OVERRIDE変更の終わり
      変更の始まり選択度のオーバーライドが指定されていないことを示すには、「N」の値を指定します。 同じステートメントに対して、ステートメント・レベルのアクセス・パスと選択度のオーバーライドを共存させることはできません。変更の終わり
      変更の始まりACCESSPATH_HINT変更の終わり
      変更の始まりアクセス・パスが指定されていることを示すには、「Y」の値を指定します。変更の終わり
      変更の始まりOPTION_OVERRIDE 変更の終わり
      変更の始まりステートメント・レベルの最適化パラメーターが指定されていることを示すには、「Y」の値を指定します。変更の終わり
      重要: 変更の始まりSELECTVTY_OVERRIDE、ACCESSPATH_HINT、および OPTION_OVERRIDE 列を含まない以前のフォーマットの DSN_USERQUERY_TABLE も、互換性のためにサポートされます。ただし、最新のフォーマットの DSN_USERQUERY_TABLE を使用して、それらの各列に値を指定することが推奨されています。これらの値を指定することによって、アクセス・パスに影響を及ぼすために意図した方式だけを使用するようにプロセスをシンプルにできます。変更の終わり
      例えば、以下のいずれかのステートメントを実行して、DSN_USERQUERY_TABLE にデータを追加することができます
      • 静的 SQL ステートメントの場合は、SYSIBM.SYSPACKSTMT カタログ表から値を取得し、以下の INSERT ステートメントのようなステートメントを実行して値を挿入します。 変更の始まり
        INSERT INTO DSN_USERQUERY_TABLE 
        ( QUERYNO, SCHEMA, HINT_SCOPE, 
        QUERY_TEXT,
        USERFILTER, OTHER_OPTIONS,
          COLLECTION, PACKAGE, VERSION, 
        REOPT, STARJOIN, 
        MAX_PAR_DEGREE, DEF_CURR_DEGREE, 
        SJTABLES, OTHER_PARMS, 
        SELECTVTY_OVERRIDE, ACCESSPATH_HINT, 
        OPTION_OVERRIDE 
        )   
        SELECT 1111111, 'MYSCHEMA_1', 1, 
        STATEMENT, 
        '','',
        COLLID, NAME, VERSION, 
        '', '', 
        -1, '', -1, '',
        'N', 'Y', 'N' 
        FROM SYSIBM.SYSPACKSTMT
        WHERE COLLID = 'MYCOLLID_1'
        AND NAME = 'MYPACKAGE_1'
        AND VERSION = 'MYVERSION_1'
        AND STMTNO = 12;
        変更の終わり

        妥当性検査されると、結果として、指定のパッケージ・バージョンで実行された指定のステートメントのインスタンスに対して、QUERYNO 値が 1111111 である PLAN_TABLE 行に記述されているアクセス・パスを Db2 が使用するように指定することになります。 HINT_SCOPE の値が 1 である場合、指定のパッケージで実行されるステートメントのインスタンスにのみ、ヒントは適用されます。

      • ステートメント・テキストとその他の情報が SYSIBM.SYSPACKSTMT カタログ表から得られない場合は、値を明示的に指定した INSERT ステートメントを実行できます。
  2. SQL ステートメントの PLAN_TABLE にデータを設定します。 この表には、手動で 1 つ以上の行を挿入するか、EXPLAIN ステートメントを発行して、データを設定することができます。
  3. BIND QUERY コマンドを発行します。 LOOKUP オプションを省略するか、LOOKUP(NO) を指定する必要があります。 変更の始まり専用のスキーマの下で入力表を作成した場合、EXPLAININPUTSCHEMA バインド・オプションとスキーマの名前を指定します。変更の終わり Db2 はすべての DSN_USERQUERY_TABLE 行および関連する入力表から入力を取得し、データを以下のカタログ表に挿入します。
    • SYSIBM.SYSQUERY
    • SYSIBM.SYSQUERYPLAN

    QUERYID 列はこれらの表の行を相関させます。

    プログラム固有のプログラミング・インターフェース情報の終了

タスクの結果

静的 SQL ステートメントのカタログ表の行は、ステートメントが入ったパッケージを再バインドするときに、検証され、適用されます。動的 SQL ステートメントのカタログ表の行は、ステートメントの準備ができたときに検証され、実施されます。

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

次のタスク

以下のアクションの実行について考慮します。

  1. 適切なカタログ表の行が作成されていることを確認します。
    1. QUERY_TEXT 列と SCHEMA 列に値が含まれている DSN_USERQUERY_TABLE 表に行を挿入します。
    2. 次のコマンドを発行します。
      BIND QUERY LOOKUP(YES)
      Db2 は、カタログ表に、DSN_USERQUERY_TABLE 行に対応する有効な行が含まれるかどうかを示す以下のメッセージを発行します。
      • DSNT280I メッセージ (各 DSN_USERQUERY_TABLE 行にカタログ表内の一致する行がある場合)。
      • DSNT281I メッセージ (各 DSN_USERQUERY_TABLE 行にカタログ表内の一致する行がない場合)。
      • 単一の DSNT290I メッセージ (カタログ表に一致する行がいくつかある場合) または DSNT291I メッセージ (一致する行がない場合)。
      また Db2 は、DSN_USERQUERY_TABLE 表の QUERYID 列の値を更新し、SYSIBM.SYSQUERY カタログ表の一致する行の値と一致するようにします。
  2. DSN_USERQUERY_TABLE 行を削除し、後ほど BIND QUERY コマンドが発行される際に既存のカタログ表の行と置き換わらないようにします。BIND_QUERY コマンドを発行するときに、DSN_USERQUERY_TABLE 行のすべての行に関してカタログ表の行が作成されるか置換されます。 他の入力表のデータに変更が加えられると、DSN_USERQUERY_TABLE に古い行が残っている場合に BIND_QUERY コマンドを再発行すると、予期しない結果になる恐れがあります。