pureQueryXml (Eigenschaft)

Gibt den vollständig qualifizierten oder relativen Pfad sowie den Namen einer Datei an, die beim Erfassen von SQL-Anweisungen erstellt werden soll oder bereits als Ergebnis des Erfassungsprozesses vorhanden ist.

Die Erweiterung der Datei muss .pdqxml oder .xml sein. Es gibt keinen Standardwert. Der Name der Datei muss die Konventionen von Dateinamen für Ihr Betriebssystem beachten.

Verwendung dieser Eigenschaft mit einem Repository: Gibt die Eigenschaft finalRepositoryProperties ein Repository an, wird eine Ausnahmebedingung ausgelöst, wenn gleichzeitig die Eigenschaft pureQueryXml angegeben wird.

Verwendung dieser Eigenschaft beim Erfassen von SQL-Anweisungen:

Verwendung dieser Eigenschaft, um erfasste SQL-Anweisungen dynamisch auszuführen: Mit der Eigenschaft pureQueryXml können Sie die Datei angeben, in der diese Anweisungen erfasst wurden. Das Verzeichnis und die Datei, das bzw. die Sie angeben, müssen vorhanden sein. Die Anwendung muss über eine Leseberechtigung für Dateien verfügen, die sich im angegebenen Verzeichnis befinden.

Wenn Sie diese Eigenschaft in einer Datei pdq.properties in der Workbench erstellen: Stellen Sie sicher, dass die Eigenschaft pureQueryXml auf dataAccessFolder/Dateiname gesetzt ist. Wenn Sie keinen Wert festlegen, verwendet die Workbench dataAccessFolder/capture.pdqxml. Damit die Workbench die pureQueryXML-Datei erkennt, muss sich die Datei im Ordner dataAccessFolder in Ihrem Java-Projekt befinden.

Wichtig: Wird erfasstes SQL in der pureQueryXML-Datei gespeichert und befindet sich die Datei in einem Dateisystem, müssen Sie sicherstellen, dass die Anwendung im Quiescemodus ist und dass nicht in die Datei geschrieben wird, während Sie die Datei abrufen. Wird die Anwendung nicht in den Quiescemodus versetzt, ist der Inhalt der pureQueryXML-Datei möglicherweise nicht gültig oder die Anwendung ist möglicherweise nicht in der Lage, die pureQueryXML-Datei zu aktualisieren, was zu einem E/A-Fehler führt. Sie können die Option -validateXml mit dem Dienstprogramm Merge, dem Dienstprogramm Configure oder dem Dienstprogramm StaticBinder verwenden, um die Gültigkeit der Datei sicherzustellen.

Hinweise zur Verwendung von IBM CLI und IBM Data Server Driver

Bei der Verwendung von DB2 Call Level Interface (DB2 CLI) oder IBM Data Server Driver mit pureQuery Runtime können Sie die pureQuery Runtime-Eigenschaft als Konfigurationsschlüsselwort verwenden.

IBM CLI-Schlüsselwortsyntax
pureQueryXml = vollständig qualifizierter Dateiname | relativer Dateiname
IBM Data Server Driver-Konfigurationssyntax
<parameter name="pureQueryXml" value="vollständig qualifizierter Dateiname | relativer Dateiname
funktional entsprechendes Umgebungs- oder Verbindungsattribut:
keins
funktional entsprechendes Verbindungszeichenfolgenschlüsselwort von IBM® Data Server Provider für .NET
nicht zutreffend

Feedback