capturedOnly (Eigenschaft)

Gibt an, ob nur die SQL-Anweisungen ausgeführt werden sollen, die sich in der pureQueryXML-Datei befinden.

Sie können diese Eigenschaft auf TRUE setzen, wenn Sie eine pureQueryXML-Datei für die Verwendung mit einer Anwendung erstellt haben. Wenn Sie SQL-Anweisungen erfassen, können Sie die Eigenschaft nicht auf TRUE setzen.

Diese Eigenschaft kann folgende Werte annehmen:

TRUE
Die Anwendung führt nur die SQL-Anweisungen aus, die sich in der pureQueryXML-Datei befinden.
FALSE
Die Anwendung führt alle SQL-Anweisungen aus, auch solche, die sich nicht in der pureQueryXML-Datei befinden.
Dies ist der Standardwert.
Anmerkung: Wenn die Eigenschaft capturedOnly auf TRUE gesetzt ist, werden Anweisungen SET SPECIAL REGISTER oder Anweisungen mit dem Anweisungstyp (statementType) SET_METHOD von pureQuery Runtime nicht eingeschränkt. Die Anweisungen sind unabhängig davon, ob die Anweisung in der pureQueryXML-Datei enthalten ist, immer zulässig.

Die folgende Tabelle zeigt die Kombinationen aus capturedOnly, executionMode und allowDynamicSQL und die aus diesen Kombinationen resultierenden Operationen:

Tabelle 1. Kombinationen aus capturedOnly, executionMode und allowDynamicSQL und resultierende Operationen:
capturedOnly executionMode allowDynamicSQL SQL-Anweisung abgeglichen Ergebnis
TRUE STATIC TRUE JA Bei isBindable = TRUE SQL-Anweisung statisch ausführen

Bei isBindable = False SQL-Anweisung dynamisch ausführen

TRUE STATIC/DYNAMIC TRUE/FALSE NEIN Fehler zurückgeben
TRUE STATIC FALSE JA Bei isBindable = TRUE SQL-Anweisung statisch ausführen

Bei isBindable = False Fehler zurückgeben

TRUE DYNAMIC TRUE/FALSE JA SQL-Anweisung ausführen
FALSE STATIC TRUE JA Bei isBindable = TRUE SQL-Anweisung statisch ausführen

Bei isBindable = False SQL-Anweisung dynamisch ausführen

FALSE STATIC TRUE NEIN SQL-Anweisung dynamisch ausführen
FALSE STATIC FALSE JA Bei isBindable = TRUE SQL-Anweisung statisch ausführen

Bei isBindable = False Fehler zurückgeben

FALSE STATIC FALSE NEIN Fehler zurückgeben
FALSE DYNAMIC TRUE/FALSE JA/NEIN SQL-Anweisung ausführen

Hinweise zur Verwendung von DB2 CLI und IBM Data Server Driver

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

IBM CLI-Schlüsselwortsyntax
capturedOnly = TRUE | FALSE
IBM Data Server Driver-Konfigurationssyntax
<parameter name="capturedOnly" value="TRUE | FALSE" />
funktional entsprechendes Verbindungszeichenfolgenschlüsselwort von IBM Data Server Provider für .NET
nicht zutreffend

Hinweise

Ist das Schlüsselwort capturedOnly=TRUE für eine CLI-Anwendung festgelegt, die für die pureQuery-Clientoptimierung aktiviert ist, werden Anweisungen mit dem Anweisungstyp SET_METHOD durch pureQuery Runtime eingeschränkt, wenn die Anweisung sich nicht in der pureQueryXML-Datei befindet.


Feedback