制限された SQL ステートメント・セットを動的にキャプチャーし、実行するためのプロパティー

以下の記述では、pureQuery が SQL ステートメントをどのようにキャプチャーし、キャプチャーしたステートメントをどのように実行するかを決定するために設定できる各 pureQuery Runtime プロパティーの目的について説明します。
制限された SQL ステートメント・セットのキャプチャーおよび実行のためにすべての pureQuery Runtime プロパティーがサポートされているわけではありません。使用可能な pureQuery Runtime プロパティーを以下の表に示します。
表 1. 制限された SQL ステートメント・セットを動的にキャプチャーし、実行するための pureQuery Runtime プロパティー
プロパティー 説明
capturedOnly pureQueryXML ファイル内に存在する SQL ステートメントのみを実行するようにするかどうかを指定します。
captureMode SQL ステートメントに関する情報を取り込むかどうかを指定します。
captureStatementBatchSQL 最大で maxNonParmSQL プロパティーで指定された SQL ステートメント (SELECT ステートメントを除く) の数まで、アプリケーションが Statement.addBatch() メソッドに渡す SQL DML ステートメントを取り込むかどうかを指定します。
enableDynamicSQLReplacement 元のステートメントと pureQueryXML ファイルに追加された代替 SQL ステートメントの両方がバインドされていない場合に、その代替ステートメントを実行するかどうかを指定します。
executionMode 以前に pureQuery Runtime によって取り込まれて保管された SQL ステートメントを静的に実行するかどうかを指定します。
finalRepositoryProperties pureQuery 対応のアプリケーションで使用する pureQuery プロパティーの場所を指定します。
maxNonParmSQL 取り込むパラメーター化されていない SQL ステートメントの最大数を指定します。 このオプションは、captureMode の値が ON である場合にのみ適用されます。 captureMode が OFF である場合、pureQuery はこのパラメーターを無視します。
maxStackTracesCaptured 取り込む SQL ステートメントごとに定義ポイントおよび実行ポイントに対して記録されるスタック・トレースの最大数を指定します。
outputPureQueryXml SQL ステートメントの取り込みプロセスで作成される 1 つ以上のファイルへの完全修飾パスまたは相対パス、およびそのファイルの名前を指定します。
outputXmlRepository リポジトリーを含むデータベースを指定します。リポジトリーには、クライアントの最適化のために pureQuery 対応アプリケーションから取り込まれた SQL データが保管されます。
packagePrefixExclusions スタック・トレースに組み込まない Java パッケージのドメインおよびサブドメインのパイプ区切りリストを指定します。
propertiesGroupId データベースに作成されるリポジトリー内のランタイム・グループ ID を指定します。 pureQuery Runtime は、このランタイム・グループ ID と、リポジトリーを指定する接続情報を使用して、アプリケーションから取り込まれた SQL データを保管するか、pureQuery ランタイム構成情報および pureQueryXML ファイル情報を取得します。
propertiesRefreshInterval pureQuery クライアントの最適化によって、保管されている pureQuery データの場所で pureQuery プロパティーの変更または pureQueryXML データの変更の検査が実行されるまでの待機期間 (分数) を指定します。 更新が検出されると、pureQuery クライアントの最適化によって、更新された pureQuery ランタイム・プロパティーと pureQueryXML データが取得されて、更新された情報が使用されます。
pureQueryXml SQL ステートメントを取り込むプロセスで作成されるファイル、またはそのプロセスの結果として既に存在するファイルへの完全修飾パスまたは相対パスとファイル名を指定します。
repositoryRequired pureQuery データの取得時または書き込み時にエラーが発生した場合の、pureQuery クライアントの最適化の動作を指定します。つまり、finalRepositoryProperties プロパティーで指定された場所から pureQuery ランタイム・プロパティーおよび pureQueryXML データを取得できない場合、または取り込まれた SQL が保管されているリポジトリーにアクセスできない場合の pureQuery クライアントの最適化の動作を指定します。
sqlLiteralSubstitution リテラルの置換を実行するかどうかを指定します。pureQuery Runtime は、SQL ステートメント内のリテラル値をパラメーター・マーカーで置き換えて、パラメーター化されたバージョンのステートメントを取り込むことを試みます。
stackTraceDepth SQL ステートメントごとに記録されるスタック・トレース項目の最大数を指定します。 これらの項目は、pureQueryXML ファイルに記録されます。
traceFile ログの書き込み先の物理ファイルを指定します。 絶対パス、または pureQuery Log ユーティリティーが実行されるディレクトリーを基準とする相対パスを使用できます。
traceLevel ログ・ファイルに書き込む詳細のレベルを指定します。

フィードバック