pureQuery ランタイム・プロパティーを使用して、pureQuery Runtime が pureQuery 情報を取得し、キャプチャーした SQL データを保管するために使用するロケーションを制御します。
プロパティー
以下のプロパティーは、pureQuery Runtime が pureQuery データを取得および保管する方法を制御します。
- finalRepositoryProperties
- pureQuery ランタイム・プロパティーおよび pureQueryXML ファイル情報を取得する際に使用するロケーションを指定します。
- outputPureQueryXml
- pureQuery クライアント最適化対応のアプリケーションから
キャプチャーした SQL データを保管するために使用するファイル名を指定します。
- outputXmlRepository
- SQL 管理リポジトリーを含んだデータベースを指定します。
リポジトリーには、pureQuery クライアント最適化対応のアプリケーションから
キャプチャーした SQL データが保管されます。このプロパティーは、リポジトリーから
取得したプロパティーのセットにのみ指定できます。
リポジトリーから outputXmlRepository プロパティーが
取得されない場合、例外がスローされます。
- propertiesGroupId
- SQL 管理リポジトリーに対するデータの取得時またはデータの保管時に使用する、SQL 管理リポジトリー内のランタイム・グループ ID を指定します。
- propertiesRefreshInterval
- pureQuery プロパティーおよび pureQueryXML データに対する更新の検査の間隔を指定します。
プロパティーの規則
finalRepositoryProperties プロパティーを使用して pureQueryXML ファイル情報を取得する際には、以下の規則が適用されます。
- finalRepositoryProperties プロパティーで pureQuery プロパティーのロケーションとしてファイルを指定している場合、pureQueryXml プロパティーを使用してその pureQueryXML ファイルのパスおよび名前を指定する必要があります。
pureQueryXml プロパティーが指定されない場合、
pureQueryXML は使用されません。
- finalRepositoryProperties プロパティーでリポジトリーを指定している場合、propertiesGroupId プロパティーで指定されるランタイム・グループのアクティブ・バージョンから pureQueryXML データが取得されます。
pureQueryXml プロパティーも指定されている場合、例外がスローされます。
captureMode プロパティーが ON に設定されており、
finalRepositoryProperties プロパティーでリポジトリーが指定されている場合、
キャプチャーした SQL の保管には以下の規則が適用されます。
- outputPureQueryXml プロパティーが設定されていない場合、次のプロパティー設定により、キャプチャーした SQL の保管場所が判別されます。
- outputPureQueryXml プロパティーが設定されているが、outputXmlRepository プロパティーが設定されていない場合、キャプチャーした SQL はファイル・システムに保管されます。
$X 構文による複数キャプチャー・ファイルの指定がサポートされています。
- outputPureQueryXml プロパティーと outputXmlRepository プロパティーがいずれも設定されている場合、例外がスローされます。
キャプチャーした SQL データは、finalRepositoryProperties プロパティーでリポジトリーを指定している場合であっても、ファイル・システムに保管できます。
outputPureQueryXml プロパティーでファイル・システムを指定してください。
キャプチャーした SQL データのリポジトリーへの保管は captureMode プロパティーによって制御されますが、finalRepositoryProperties プロパティーでリポジトリーが指定されている場合にのみサポートされます。
ファイル・システムから pureQuery ランタイム・プロパティーが取得される場合、取得および保管にはそのファイル・システムが使用されます。
pureQueryXml プロパティーおよび outputPureQueryXml プロパティーを使用して、ファイルを指定する必要があります。
finalRepositoryProperties プロパティーを指定することは、
他に使用可能になっている pureQuery クライアント最適化プロパティーがない場合であっても、
その pureQuery クライアント最適化が使用可能であることを示します。
pureQuery プロパティーおよびリポジトリーへのサポートの要約
以下の表は、ファイル・システムで使用される場合
およびリポジトリーで使用される場合の pureQuery プロパティーのサポートについて要約しています。
表 1. 新旧 pureQuery プロパティーの対話の表プロパティー |
プロパティー・ファイルで、またはコマンド行で指定された場合に有効 |
リポジトリーに指定された場合に有効 |
ファイルまたはコマンドで指定された場合に有効であり、
pureQuery Runtime はリポジトリーからのプロパティーを使用 |
allowDynamicSQL |
X |
X |
|
allowGetterSetterMethodWithPublicField |
X |
|
|
allowMDMBeanRules |
X |
|
|
capturedOnly |
X |
X |
|
captureMode |
X |
X |
|
captureStatementBatchSQL |
X |
X |
|
disableJDBCPrerequisiteEnforcement |
X6 |
|
X6 |
enableDynamicSQLReplacement |
X |
X |
|
executionMode |
X |
X |
|
finalRepositoryProperties |
X |
|
|
ignoreOrphanGetterSetterMethods |
X |
|
|
maxNonParmSQL |
X |
X |
|
maxResultRows |
X |
|
|
maxStackTracesCaptured |
X |
X |
|
outputPureQueryXml |
X3 |
X4 |
|
outputXmlRepository |
|
X |
|
packagePrefixExclusions |
X |
X |
|
propertiesGroupId |
X1 |
|
|
propertiesRefreshInterval |
X2 |
X |
|
pureQueryXml |
X3 |
X |
|
queryTimeoutInSeconds |
X |
|
|
sqlLiteralSubstitution |
X |
X |
|
stackTraceDepth |
X |
X |
|
traceFile5 |
X6 |
|
X6 |
traceLevel5 |
X6 |
|
X6 |
cmx.controllerDiscoveryInterval |
X6 |
|
X6 |
cmx.controllerDiscoveryPort |
X6 |
|
X6 |
cmx.controllerURL |
X6 |
|
X6 |
cmx.dataSourceLookupInterval |
X6 |
|
X6 |
cmx.multicastTimeToLive |
X6 |
X6 |
X6 |
注: - finalRepositoryProperties プロパティーがリポジトリーを参照している場合のみ有効。
- finalRepositoryProperties プロパティーが指定されている場合のみ有効。
- finalRepositoryProperties プロパティーが指定されていない場合のみ有効。
- finalRepositoryProperties プロパティーがファイル・システムを参照している場合のみ有効。
- pureQuery クライアント最適化を使用したトレースでは、アプリケーション・レベルでのトレースはサポートされません。
- グローバル pureQuery プロパティーのみ検査されます。finalRepositoryProperties、pdqappwide.properties、
targetDSName.properties、DataSource、pdqProperties、または JCC グローバル・プロパティーで定義されたアプリケーション・レベルの値はすべて無視されます。