SQL ステートメントを取り込むプロセスで作成されるファイル、またはそのプロセスの結果として既に存在するファイルへの完全修飾パスまたは相対パスとファイル名を指定します。
ファイルの拡張子は、.pdqxml または .xml のいずれかである必要があります。
デフォルト値はありません。ファイルの名前は、ご使用のオペレーティング・システムにおけるファイル名の規則に従う必要があります。
このプロパティーをリポジトリーで使用: finalRepositoryProperties プロパティーでリポジトリーを指定した場合に、pureQueryXml プロパティーも指定されていると例外がスローされます。
SQL ステートメントを取り込むときのこのプロパティーの使用方法:
- 非クラスター化アプリケーションからはじめて SQL ステートメントを取り込む場合には、pureQueryXml プロパティーまたは outputPureQueryXml プロパティーを使用できます。
ただし、どちらかのプロパティーを使用する必要があります。指定するディレクトリーは存在するものでなければなりません。そのディレクトリーにファイルを作成する許可を持っている必要があります。
プロパティーを両方とも指定した場合は、outputPureQueryXml プロパティーが優先します。
- クラスター化アプリケーションからはじめて SQL ステートメントを取り込む場合には、pureQueryXml プロパティーを使用することはできません。
outputPureQueryXml プロパティーを使用する必要があります。
- pureQueryXML ファイルを既に作成している非クラスター化アプリケーションから追加の SQL ステートメントを取り込む場合で、
そのファイルの現在の状態を保持しなくてよい場合にはこのプロパティーを使用してそのファイルを指定します。
追加の SQL ステートメントを取り込むと、pureQuery はそれらのステートメントをそのファイルに書き込みます。
- pureQueryXML ファイルを既に作成した非クラスター化アプリケーションから追加の SQL ステートメントを取り込む場合には、pureQueryXml プロパティーを使用してそのファイルを入力ファイルとして指定し、入力ファイルにまだ存在しない追加の SQL ステートメントを取り込むために outputPureQueryXml プロパティーを使用できます。
- クラスター化アプリケーションから追加の SQL ステートメントを取り込む場合には、pureQueryXml プロパティーを使用して、アプリケーションから SQL ステートメントを最後に取り込んだときに作成されたファイルのマージ結果である pureQueryXML ファイルを入力ファイルとして指定します。
outputPureQueryXml プロパティーを使用して、追加の SQL ステートメントを取り込む先のファイルを指定します。
このプロパティーを使用して、取り込んだ SQL ステートメントを動的に実行する方法: pureQueryXml プロパティーを使用して、ステートメントが取り込まれたファイルを指定します。
指定するディレクトリーとファイルは存在するものでなければなりません。アプリケーションには、指定したディレクトリー内のファイルに対する読み取り許可が付与されている必要があります。
ワークベンチで pdq.properties ファイルにこのプロパティーを設定する場合: プロパティー pureQueryXml を dataAccessFolderfile-name に設定します。
値を設定しないと、ワークベンチでは dataAccessFolder/capture.pdqxml が使用されます。
ワークベンチが pureQueryXML ファイルを認識するには、
そのファイルが Java プロジェクト内の dataAccessFolder フォルダーに入っていなければなりません。
重要: キャプチャーした SQL が pureQueryXML に保存されており、
そのファイルがファイル・システムに置かれている場合、アプリケーションが静止していること、
およびファイルを取得する際にそのファイルに書き込みが行われないことを確認してください。
アプリケーションが静止していないと、pureQueryXML ファイルのコンテンツが無効になったり、アプリケーションで pureQueryXML ファイルを更新できなくなって入出力エラーが発生したりする可能性があります。
Merge ユーティリティー、Configure ユーティリティー、または StaticBinder ユーティリティー
で -validateXml オプションを使用して、ファイルの妥当性を確認できます。
IBM CLI および IBM Data Server Driver の使用上の注意
pureQuery Runtime で DB2 Call Level Interface (DB2 CLI) または IBM Data Server Driver を使用する場合は、pureQuery Runtime プロパティーを構成キーワードとして使用できます。
- IBM CLI キーワードの構文
- pureQueryXml = 完全修飾ファイル名 | 相対ファイル名
- IBM Data Server Driver 構成の構文
- <パラメーター名="pureQueryXml" 値="完全修飾ファイル名 | 相対ファイル名
- 同等の環境または接続属性
- なし
- 同等の IBM® Data Server
Provider for .NET 接続ストリング・キーワード
- 該当なし