pureQuery データのロケーションを制御する pureQuery ランタイム・プロパティー

pureQuery ランタイム・プロパティーを使用して、pureQuery Runtime が pureQuery 情報を取得し、キャプチャーした SQL データを保管するために使用するロケーションを制御します。

プロパティー

以下のプロパティーは、pureQuery Runtime が pureQuery データを取得および保管する方法を制御します。
finalRepositoryProperties
pureQuery ランタイム・プロパティーと pureQueryXML ファイル情報を取得するときに使用する SQL 管理リポジトリーが入っているデータベースを指定します。
outputPureQueryXml
pureQuery クライアント最適化対応のアプリケーションから キャプチャーした SQL データを保管するために使用するファイル名を指定します。
outputXmlRepository
SQL 管理リポジトリーを含んだデータベースを指定します。 このリポジトリーには、pureQuery クライアント最適化に対応したアプリケーションからキャプチャーした SQL データが格納されます。 このプロパティーは、finalRepositoryProperties で指定されているリポジトリーから取り込まれるプロパティー・セットでのみ指定できます。 リポジトリーから 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 の保管場所が判別されます。
    • outputXmlRepository プロパティーが設定されていない場合、キャプチャーした SQL は、finalRepositoryProperties および propertiesGroupId プロパティーで指定されたリポジトリーおよびランタイム・グループに保管されます。
    • outputXmlRepository プロパティーを設定すると、キャプチャーされた SQL は、propertiesGroupId プロパティーで指定されているランタイム・グループの outputXmlRepository プロパティーで指定されているリポジトリーに格納されます。
      注: outputXmlRepository プロパティーでは、データ・ソースや JDBC URL の指定がサポートされますが、ファイル・システムの指定はサポートされません。
  • 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
注:
  1. finalRepositoryProperties プロパティーがリポジトリーを参照している場合のみ有効。
  2. finalRepositoryProperties プロパティーが指定されている場合のみ有効。
  3. finalRepositoryProperties プロパティーが指定されていない場合のみ有効。
  4. finalRepositoryProperties プロパティーがファイル・システムを参照している場合のみ有効。
  5. pureQuery クライアント最適化を使用したトレースでは、アプリケーション・レベルでのトレースはサポートされません。
  6. グローバル pureQuery プロパティーのみ検査されます。finalRepositoryProperties、pdqappwide.properties、 targetDSName.properties、DataSource、pdqProperties、または JCC グローバル・プロパティーで定義されたアプリケーション・レベルの値はすべて無視されます。

フィードバック