ステートメント・レベルでの最適化パラメーターの指定

ステートメント・レベルの最適化パラメーターを作成すると、特定の有効範囲に含まれる特定の SQL ステートメントのすべてのインスタンスに対して、最適化関連のいくつかのサブシステム・パラメーターおよびバインド・オプションの値をカスタマイズすることができます。

始める前に

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

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

このタスクについて

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

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

手順

ステートメント・レベルの最適化パラメーターを指定するには、次のようにします。

  1. DSN_USERQUERY_TABLE 表に行を INSERT します。
    1. 以下の列に値を挿入して、最適化パラメーターに関する SQL ステートメントとコンテキストを指定します。
      QUERYNO
      PLAN_TABLE 行と相関しておらず、別の DSN_USERQUERY_TABLE 行にまだ存在しない値を指定します。 QUERYNO 値は、DSN_USERQUERY_TABLE の主キーとしてのみ使用されます。
      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」を指定します。 両方のタイプのオーバーライドを指定する場合は、「Y」を指定します。変更の終わり
      変更の始まりACCESSPATH_HINT変更の終わり
      変更の始まりアクセス・パスが指定されていないことを示すには、「N」の値を指定します。 同じステートメントにアクセス・パスと選択度オーバーライドの両方を指定することはできません。変更の終わり
      変更の始まりOPTION_OVERRIDE 変更の終わり
      変更の始まりステートメント・レベルの最適化パラメーターが指定されていることを示すには、「Y」の値を指定します。変更の終わり
      重要: 変更の始まりSELECTVTY_OVERRIDE、ACCESSPATH_HINT、および OPTION_OVERRIDE 列を含まない以前のフォーマットの DSN_USERQUERY_TABLE も、互換性のためにサポートされます。ただし、最新のフォーマットの DSN_USERQUERY_TABLE を使用して、それらの各列に値を指定することが推奨されています。これらの値を指定することによって、アクセス・パスに影響を及ぼすために意図した方式だけを使用するようにプロセスをシンプルにできます。変更の終わり
    2. 最適化パラメーターを定義する値を挿入します。 ステートメント・レベルの最適化パラメーターは、DSN_USERQUERY_TABLE に指定した QUERYNO 値が既存の PLAN_TABLE 行に対応していない場合にのみ作成されます。 次の最適化パラメーターおよびオプションの設定を指定できます。
      • REOPT バインド・オプション
      • STARJOIN サブシステム・パラメーター
      • PARAMDEG サブシステム・パラメーター (MAX_PAR_DEGREE 列)
      • CDSSRDEF サブシステム・パラメーター (DEF_CURR_DEGREE 列)
      • SJTABLES サブシステム・パラメーター
      例えば、以下の SQL ステートメントを実行して、最適化パラメーター・ヒントを作成する DSN_USERQUERY_TABLE に行を挿入できます。
      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
      )   
        VALUES  
        (100, 'MYSCHEMA_1', 0,
         'DECLARE C06 CURSOR FOR
           SELECT N_NAME, COUNT(*)
             FROM ORDER, CUSTOMER, NATION_NP
             WHERE C_NATIONKEY = N_NATIONKEY
               AND C_CUSTKEY = O_CUSTKEY
               AND N_REGIONKEY = :H
               AND O_ORDERDATE BETWEEN ''1998-01-01'' AND ''1998-03-31''
             GROUP BY N_NAME',                               
         'USER001', '',        
         '', '', '',            
         'Y', '', -1, 
         '', -1, '',
      'N', 'N', 'Y'
      );     

      この結果として、Db2 は、指定されたステートメントのインスタンスに対して REOPT(ALWAYS) 最適化パラメーターを使用するようになります。

      プログラム固有のプログラミング・インターフェース情報の終了
  2. BIND QUERY コマンドを発行します。 LOOKUP オプションを省略するか、LOOKUP(NO) を指定する必要があります。 変更の始まり専用のスキーマの下で入力表を作成した場合、EXPLAININPUTSCHEMA バインド・オプションとスキーマの名前を指定します。変更の終わり Db2 はすべての DSN_USERQUERY_TABLE 行および関連する入力表から入力を取得し、データを以下のカタログ表に挿入します。
    • SYSIBM.SYSQUERY
    • SYSIBM.SYSQUERYOPTS

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

タスクの結果

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

次のタスク

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

  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 コマンドを再発行すると、予期しない結果になる恐れがあります。