各アプリケーション環境における pureQuery Runtime プロパティーのサポート

pureQuery Runtime を、pureQuery API、pureQuery クライアント最適化、Call Level Interface (CLI) を組み込んだアプリケーションで使用するときにサポートされるプロパティーの要約。
以下の表で、pureQuery Runtime プロパティーとサポートされるアプリケーション環境の一覧を示します。
表 1. pureQuery プロパティーとサポートされるアプリケーション環境
プロパティー 説明 pureQuery API を使用する Java アプリケーション4 pureQuery クライアント最適化を使用する Java アプリケーション pureQuery クライアント最適化を使用する CLI アプリケーション
allowDynamicSQL1 pureQueryXML ファイルに取り込まれていない SQL ステートメント、または取り込まれているがバインドされていない SQL ステートメントをアプリケーションで動的に実行できるようにするかどうかを指定します。   X X
capturedOnly2 pureQueryXML ファイル内に存在する SQL ステートメントのみを実行するようにするかどうかを指定します。 X X X
captureMode SQL ステートメントに関する情報をキャプチャーするのかどうか、およびキャプチャーする情報のタイプを指定します。 X X X
captureStatementBatchSQL 最大で maxNonParmSQL プロパティーで指定された SQL ステートメント (SELECT ステートメントを除く) の数まで、アプリケーションが Statement.addBatch() メソッドに渡す SQL DML ステートメントを取り込むかどうかを指定します。 X X  
com.ibm.pdq (pureQuery コンポーネント・ログ・プロパティー) 各種 pureQuery コンポーネントのログ・レベル設定を指定します。 X X  
dumpLogsOnSqlCodes ログ・レコードがメモリー内に保管される場合、このプロパティーは、 レコードがログ・ファイルに書き込まれることになる SQL エラー・コードを指定します。 X X  
dumpLogsExcludingSqlCodes ログ・レコードがメモリー内に保管される場合、このプロパティーは、レコードが ログに書き込まれることがない SQL エラー・コードを指定します。 このプロパティーはプロパティー dumpLogsOnSqlCodes とともに使用されます。 X X  
enableDynamicSQLReplacement 元のステートメントと pureQueryXML ファイルに追加された代替 SQL ステートメントの両方がバインドされていない場合に、その代替ステートメントを実行するかどうかを指定します。 X X X
executionMode 以前に pureQuery Runtime によって取り込まれて保管された SQL ステートメントを静的に実行するかどうかを指定します。 X X X
finalRepositoryProperties pureQuery 対応のアプリケーションで使用する pureQuery プロパティーの場所を指定します。   X  
maxNonParmSQL 取り込むパラメーター化されていない SQL ステートメントの最大数を指定します。 このオプションは、captureMode の値が ON である場合にのみ適用されます。 captureMode が OFF である場合、pureQuery はこのパラメーターを無視します。 X X X
maxResultRow ステートメントが照会結果で返す最大行数を指定します。 X    
maxStackTracesCaptured 取り込む SQL ステートメントごとに定義ポイントおよび実行ポイントに対して記録されるスタック・トレースの最大数を指定します。 X X  
outputPureQueryXml SQL ステートメントの取り込みプロセスで作成される 1 つ以上のファイルへの完全修飾パスまたは相対パス、およびそのファイルの名前を指定します。 X X  
outputXmlRepository リポジトリーを含むデータベースを指定します。リポジトリーには、クライアントの最適化のために pureQuery 対応アプリケーションから取り込まれた SQL データが保管されます。   X  
packagePrefixExclusions スタック・トレースに組み込まない Java パッケージのドメインおよびサブドメインのパイプ区切りリストを指定します。 X X  
propertiesGroupId データベースに作成されるリポジトリー内のランタイム・グループ ID を指定します。 pureQuery Runtime は、このランタイム・グループ ID と、リポジトリーを指定する接続情報を使用して、アプリケーションから取り込まれた SQL データを保管するか、pureQuery ランタイム構成情報および pureQueryXML ファイル情報を取得します。   X X
propertiesRefreshInterval pureQuery クライアントの最適化によって、保管されている pureQuery データの場所で pureQuery プロパティーの変更または pureQueryXML データの変更の検査が実行されるまでの待機期間 (分数) を指定します。 更新が検出されると、pureQuery クライアントの最適化によって、更新された pureQuery ランタイム・プロパティーと pureQueryXML データが取得されて、更新された情報が使用されます。   X  
pureQueryXml SQL ステートメントを取り込むプロセスで作成されるファイル、またはそのプロセスの結果として既に存在するファイルへの完全修飾パスまたは相対パスとファイル名を指定します。 X X X
pureQueryXmlRepository pureQuery クライアント最適化対応の CLI アプリケーションで使用される pureQueryXML ファイル・データが 含まれているリポジトリーを指定します。     X
queryTimeoutInSeconds SQL ステートメントが実行するまでの待機秒数。 X    
repositoryRequired pureQuery データの取得時または書き込み時にエラーが発生した場合の、pureQuery クライアントの最適化の動作を指定します。つまり、finalRepositoryProperties プロパティーで指定された場所から pureQuery ランタイム・プロパティーおよび pureQueryXML データを取得できない場合、または取り込まれた SQL が保管されているリポジトリーにアクセスできない場合の pureQuery クライアントの最適化の動作を指定します。   X X
sqlLiteralSubstitution リテラル置換を実行するのかどうかを指定します。 pureQuery Runtime は、SQL ステートメント内のリテラル値をパラメーター・マーカーで置き換えて、 パラメーター化されたバージョンのステートメントを実行しようとします。 X X X
stackTraceDepth SQL ステートメントごとに記録されるスタック・トレース項目の最大数を指定します。 これらの項目は、pureQueryXML ファイルに記録されます。 X X  
traceBufferRowCount メモリーにバッファリングされるトレース情報ログ・レコードの数を指定します。 X X  
traceFile3 ログの書き込み先となるファイルを指定します。 絶対パス、または pureQuery Log ユーティリティーが実行されるディレクトリーを基準とする相対パスを使用できます。 X X X
traceLevel3 ログ・ファイルに書き込む詳細のレベルを指定します。 X X X
注:
  1. プロパティーは、executionMode プロパティーの値が STATIC である場合にのみ適用されます。
  2. SQL ステートメントのキャプチャー中に、capturedOnly プロパティーを TRUE に設定することはできません。
  3. pureQuery Runtime プロパティー traceFile および traceLevel は、 グローバル pdq.properties ファイルでのみ指定できます。 グローバル・プロパティー・ファイルについては、『WebSphere Application Server 環境での pureQuery ランタイム・プロパティーのスコープ』を参照してください。
  4. pureQuery プロパティーは、pureQuery EnhancedDataSource インターフェースまたは DataFactory クラスで使用できます。
    com.ibm.pdq.runtime.datasource Interface EnhancedDataSource
    capturedOnly
    captureMode
    captureStatementBatchSQL
    enableDynamicSQLReplacement
    maxNonParmSQL
    maxStackTracesCaptured
    outputPureQueryXml
    packagePrefixExclusions
    pureQueryXml
    stackTraceDepth
    sqlLiteralSubstitution
    com.ibm.pdq.runtime.factory.DataFactory
    executionMode
    queryTimeoutInSeconds
    maxResultRows

フィードバック