OracleデータソースにプッシュダウンさせるIN句引数上限値の設定方法 – TIBCOサポート

概要

Oracleデータソースを利用するビューに対し、クライアントから大量の引数を持つIN句を含むクエリが実行された時に、IN句がOracle側にプッシュダウンされない場合があります。

この記事ではOracleデータソースにプッシュダウンさせるIN句引数上限値の設定手順について説明します。

大量の引数を持つIN句がプッシュダウンされない原因

大量の引数を持つIN句を含むクエリの例としては以下のようなものがあります。

SELECT
    *
FROM
    [仮想テーブル名]
WHERE
    (COL1, COL2) IN (
        ('xxx', 'abcdefg'),
        ('yyy', 'hijklmn'),
        ...
        ('zzz', 'opqrstu')
    )

このようなクエリのIN句がデータソースにプッシュダウンされない原因の一つとして考えられるのは、IN句の引数の個数がTDV Server の設定値 jdbcds.max_number_of_in_operator_values を超過していることです。

本記事では、 jdbcds.max_number_of_in_operator_values の変更方法について説明します。

Oracleのcapabilitiesファイルを修正

設定値 jdbcds.max_number_of_in_operator_values は TDV Serverが利用するOracleのcapabilitiesファイルに記述されていますので、そのファイルを更新する必要があります。

ここでの Oracleのcapabilitiesファイルは、

[TDV Serverインストール先フォルダパス]\apps\dlm\cis_ds_oracle\conf

にある、

oracle.capabilities

もしくは

oracle-xxxxxxxxx.capabilities（xxx部分はメジャー/マイナーバージョン・サービスパック・リビジョンを表します）
- - 例）TDV 8.3.0 HF007 が適用済みの場合のファイル名は oracle-080300007.capabilities です。
  - 初回インストール後に1回以上Hotfixを適用されている場合は、ファイル名の形式が oracle-xxxxxxxxx.capabilities となっているファイルが存在しますので、oracle.capabilities ではなく、こちらのファイルを修正してください。

を指します。

例えば、TDV Server 8.3.0 HF007 を Windows Server で実行中の場合、Oracleのcapabilitiesファイルは以下のパスに存在します。

C:\Program Files\TIBCO\TDV Server 8.3\apps\dlm\cis_ds_oracle\conf\oracle-080300007.capabilities

修正対象のOracleのcapabilitiesファイルが特定できましたら、それをテキストエディタ等で開き、以下のとおり変更します。

変更前（デフォルト値）：

jdbcds.max_number_of_in_operator_values: 1000

変更後（例）：

jdbcds.max_number_of_in_operator_values: 3000

変更後の値は TDV Server が受け付けるクエリの内容を考慮し決定してください。

Oracleのcapabilitiesファイルの変更が完了しましたら、変更を反映するために、TDV Serverサービスを再起動します。

TDV Serverが正常に再起動されましたら、クエリを再度実行頂き、IN句がOracleにプッシュダウンされているかどうかを確認します。

ただし、 jdbcds.max_number_of_in_operator_values の上限を引き上げた結果、大量のIN句がOracle側にプッシュダウンされ、それによりOracle側の制約に抵触する可能性もありますので、変更後の jdbcds.max_number_of_in_operator_values の値についてはOracle側の設定も考慮しつつ決定頂く必要があります。