[Db2] パラメーターマーカー使用時の SQL パフォーマンス

Answer

• 組み込み SQL の場合 (パッケージごと)
  BIND (または REBIND) によってパッケージに REOPT オプションを指定します。
  例

  BIND <バインド・ファイル名> [ REOPT ONCE または REOPT ALWAYS ]

  実行例

  $ db2 BIND package.bnd ACTION ADD REOPT ALWAYS

• SQL プロシージャーの場合 (SQL プロシージャー単位)
  プロシージャーのパッケージに REOPT オプションを指定します。
  例：

  CALL SYSPROC.REBIND_ROUTINE_PACKAGE('P','<プロシージャ・スキーマ>','','<プロシージャ名>','REOPT ONCE')

  実行例

  $ db2 "call sysproc.rebind_routine_package('P','DB2INST1','','SP1','REOPT ONCE')"

• 最適化ガイドラインで指定する場合 (SQL 単位)
  最適化ガイドラインが利用できる場合、ガイドラインで個別の SQL に REOPT を指定できます。
  インライン・ガイドラインで REOPT ONCE を指定する例

  SELECT * FROM T1 WHERE C1 = ? /*<OPTGUIDELINES><REOPT VALUE='ONCE'/></OPTGUIDELINES>*/

$ db2 bind @db2cli.lst collection NULLIDR1
$ db2 bind @db2cli.lst collection NULLIDRA

• CLI/ODBC アプリケーションの場合 (各クライアントの各データソースまたはすべてのデータソース)
  db2cli.ini の Reopt オプションを指定します。2: REOPT NONE、3: REOPT ONCE、4: REOPT ALWAYS
  例

  [<DSN_name>]
  Reopt=[2|3|4]

  設定例 (SAMPLE データベースへの SQL で REOPT ONCE を有効にする)

  [SAMPLE]
  Reopt=3

  注：Db2 11.5.4 以降、db2dsdriver.cfg でも Reopt オプションを指定できます。
• CLI/ODBC アプリケーションおよび .NET アプリケーションの場合 (各クライアントの各データソース)
  db2cli.ini もしくは db2dsdriver.cfg の CurrentPackageSet オプションで使用するパッケージを設定します。CurrentPackageSet と Reopt が両方指定された場合、CurrentPackageSet が優先されます。
  例１：db2cli.ini でデータソース SAMPLE に REOPT ONCE を設定

  [SAMPLE]
  CurrentPackageSet=NULLIDR1

  例２：db2dsdriver.cfg でデータベース SAMPLE にREOPT ONCE を設定

  <database host="db2srv.example.com" name="SAMPLE" port="50001">
   <parameter name="CurrentPackageSet" value="NULLIDR1"/>
  </database>

• ユニバーサル JCC ドライバー タイプ 4 接続の場合 (JDBC アプリケーション接続単位)
  Connection または Datasouce の currentPackageSet プロパティで使用するパッケージを指定します。
  構成プロパティー db2.jcc.currentPackageSet でも同等の設定が可能です。
  例：構成プロパティーで REOPT ONCE を設定

  java -cp <class_path> -Ddb2.jcc.currentPackageSet=NULLIDR1 <appl_class>

  JDBCCollection プロパティーで使用するパッケージを設定できます。
  コード例：SAMPE データベースに REOPT ALWAYS を設定

  DB2SimpleDataSource db2ds = new DB2SimpleDataSource();
  db2ds.setDatabaseName("SAMPLE");
  db2ds.setUser("db2user");
  db2ds.setPassword("xxxxx");
  db2ds.setJdbcCollection("NULLIDRA");
  con = db2ds.getConnection();

• REOPT ONCE / REOPT ALWAYS のどちらを設定するかは、適用業務に依存します。
  REOPT ALWAYS を設定すると、SQL 実行ごとにアクセスプラン選択の処理が実行されますので、場合によってはかえってパフォーマンスを悪化させることがあります。一般的に、パラメーターマーカーやホスト変数に代入する値が実行ごとに大きく変わり、最適なアクセスプランがその都度異なるようなケースでは、REOPT ALWAYS が有利です。一方、代入値が実行ごとにそれほど変わらない場合は、REOPT ONCE によって最初の一度だけアクセスプランの選択を行い、以後は同じアクセスプランを再利用したほうが有利になります。
• ステートメント・コンセントレーターを有効にすると、SQL のリテラルはホスト変数として扱われます。
  このため、REOPT ONCE の設定によりパフォーマンスが向上する可能性があります。
  注：REOPT ALWAYS を設定するとステートメント・コンセントレーターの意味が失われます。