pureQuery ランタイム・プロパティー finalRepositoryProperties を使用すると、データベース内のファイル・システムまたはリポジトリーからランタイム・プロパティーを取得できます。ファイル・システムまたはリポジトリーからランタイム・プロパティーを取得すると、優先順位に影響します。
finalRepositoryProperties プロパティーで指定されたロケーションから pureQuery ランタイム・プロパティーが取得および設定される前に、pureQuery クライアント最適化と既存の pureQuery ランタイム・プロパティーがデフォルト値にリセットされます。 データ・ソース・レベルで設定されたいかなるプロパティーも保存されません。グローバル pureQuery プロパティーとして取得および設定されたプロパティーは、影響を受けません。
WebSphere 環境では、pureQuery ランタイム・プロパティーを異なるロケーションで設定して、プロパティーのスコープ・レベルを制御します。ロケーションは、プロパティーが複数のロケーションに設定されている場合は優先順位にも影響します。
プロパティー・ファイル pdq.properties で pureQuery ランタイム・プロパティーを指定し、そのファイルを WebSphere JDBC プロバイダーの CLASSPATH に含めます。
pdq.properties ファイルを使用してグローバル・プロパティーを設定する場合は、ファイル pdq.properties を pureQuery JAR ファイルと一緒に JDBC プロバイダーの CLASSPATH に置きます。JDBC プロバイダーの CLASSPATH で設定されたプロパティーは、このドライバーを使用するすべてのアプリケーションに適用されます。特定のアプリケーションまたはデータ・ソースに適用するプロパティーは、ここに指定しないでください。
JDBC ドライバーのカスタム・プロパティー pdqProperties を WebSphere データ・ソースに対して指定します。
ユーザーは、データ・ソースごとに pureQuery ランタイム・プロパティーを設定できます。データ・ソース・レベルが適切であるのは、それぞれのデータ・ソースごとの設定が互いに独立している必要がある場合です。例えば、アプリケーションが複数の個別のデータ・ソースを使用する場合、それぞれのデータ・ソースは独自の pureQueryXML ファイルでそのターゲットとなっている SQL をキャプチャーします。
プロパティーがデータ・ソースに対して設定されている場合、プロパティーはそのデータ・ソースを使用しているすべてのアプリケーションに適用されます。したがって、アプリケーションがデータ・ソースを共有していると、キャプチャーされる SQL ステートメントはすべてのアプリケーションの共通ファイルでキャプチャーされます。
プロパティーの値に対して変更を行うたびに、アプリケーション・サーバーを再始動してアプリケーション・サーバーが新しい値を使用できるようにする必要があります。
DSName は、データ・ソースに対して設定された WebSphere DB2® Universal JDBC ドライバーのカスタム・プロパティー dataSourceName の値です。
pdq.DSName.properties ファイルは、あるアプリケーションでのデータ・ソース固有のプロパティーを指定します。このファイルで指定されるプロパティーは、アプリケーションが使用する特定のデータ・ソースに適用されます。DSName は、データ・ソースでの WebSphere カスタム・プロパティー dataSourceName のストリング値です。 このカスタム・プロパティーは、WebSphere カスタム・プロパティー pdqProperties の設定に使用されるステップと似たステップを使用して設定されます。
データ・ソース名 DSName を使用しているアプリケーションの場合、pdq.DSName.properties で指定されたプロパティーは pdq.appwide.properties で指定されたものに優先します。
アプリケーションが pdq.appwide.properties または pdq.dsName.properties ファイルなどのアプリケーション固有のプロパティー・ファイルを使用している場合、プロパティーが変更されたときに新規プロパティーを有効にするには、アプリケーション・サーバーを再始動する代わりに、WebSphere 接続プールをパージし、アプリケーションを再開して、新規プロパティー値を有効にする必要があります。
pureQuery ランタイム・プロパティー finalRepositoryProperties を使用して、データベース内のファイル・システムまたはリポジトリーを指定します。 プロパティーは、グローバル・レベル、データ・ソース・レベル、またはアプリケーション・レベルで指定できます。
propertiesGroupId プロパティーの値は、それがデータベースで作成されたリポジトリーで使用されない限り無視されます。リポジトリーが使用されているときは、リダイレクトされたプロパティー内で propertiesGroupId プロパティーの値を変更できません。
pureQuery Runtime repositoryRequired プロパティーは、ファイル・システムまたはリポジトリーを使用しているときの pureQuery Runtime の動作を制御します。WebSphere ロケーション pureQuery でプロパティーを指定して、pureQuery Runtime の動作を制御します。repositoryRequired プロパティーの値は、取得されるプロパティーの 1 つとして repositoryRequired プロパティーを設定することによりオーバーライドできます。