ステートメント・レベルのマッチングの照会テキストの取り込み

BIND QUERY コマンドを使用してアクセス・パスの選択に影響を与える際に、Db2® が一致する SQL ステートメントを識別できる可能性を増大することができます。

このタスクについて

Db2 は、BIND 時または PREPARE 時にマッチングに使用されるステートメント・テキストを変更できます。 例えば、空白文字、SQL コメント、および EXPLAIN などの特定の文節は照会テキストから削除されます。 これらの変更により、Db2 は解析済みの SQL ステートメントを BIND 処理や PREPARE 処理の間にマッチングできるようになります。

BIND QUERY の時点での以下のアプリケーションのデフォルト値は、静的 SQL ステートメントがバインドされた時点、または動的 SQL ステートメントが準備された時点と同じでなければなりません。

  • CCSID
  • DECIMAL POINT
  • STRING DELIMITER

手順

ステートメント・テキストを正常にマッチングできるようにするには、以下の方法を使用します。

  • 静的 SQL ステートメントの場合、および DYNAMICRULES(BIND) オプションで準備される動的ステートメントの場合は、DSN_USERQUERY_TABLE 内のステートメントのパッケージ情報を指定する以下の列を指定します。
    • PACKAGE
    • COLLECTION
    • VERSION

    これらの値は必ず必要なわけではありません。ただし、 これらの値が指定されている場合、Db2 は SYSIBM.SYSPACKSTMT カタログ表からの構文解析情報を使用して、 ステートメント・テキストを変更します。これらの値が指定されていない場合、 または BIND QUERY 処理中に一致するパッケージが見つからない場合、Db2 は アプリケーションのデフォルト・モジュールで指定された値を使用します。

    BIND QUERY 処理の一環として、Db2 はパッケージ (指定されている場合) に一致する ステートメント・テキストが含まれているかどうかを確認します。ステートメント・テキストが一致しない場合、Db2 は メッセージ DSNT281I を発行し、BIND QUERY コマンドは失敗します。

    パッケージのバージョンが複数存在する場合は、VERSION 列の値に * を指定します。Db2 は、VERSION 列の値が 最も小さい SYSIBM.SYSPACKSTMT カタログ表からのパッケージ情報を使用して、 ステートメント・テキストを変更します。パッケージの他のバージョンで異なるオプションを使用する場合は、他のバージョンのステートメントに対するマッチングが失敗する可能性があります。

    パッケージ・コンテキストが DSN_USERQUERY_TABLE に指定されていない場合、Db2 は アプリケーションのデフォルト・モジュールを使用して、ステートメント・テキストを変更します。しかし、特定のパッケージのステートメントとの照合によるステートメント・テキストの妥当性検査は実行されません。

  • DSN_USERQUERY_TABLE の QUERY_TEXT 列にデータを取り込む場合は、以下のロケーションから構文解析された照会テキストを選択します。
    • 静的 SQL ステートメントでは、DBRM または SYSIBM.SYSPACKSTMT カタログ表からステートメント・テキストを選択します。
    • 動的 SQL ステートメントの場合は、動的ステートメント・キャッシュからステートメント・テキストを選択します。アンパーサンド記号 (&) で リテラル値を置き換えるのに適したステートメントの場合は、Db2 がリテラル値を置き換えた後で ステートメント・テキストを抽出します。

    INSERT ステートメントには (アプリケーションのソース・コードからコピーするなどして) 直接テキストを指定できます。ただし、この方法では、ステートメントとヒントが正常にマッチングされる可能性が低くなります。

  • ステートメント・テキスト内のオブジェクト名と SQL キーワードが、(特に動的 SQL ステートメントで) 大文字で指定されていることを確認します。