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 SET-Anweisungen, die Sonderregister definieren, oder JDBC-Verbindungsaufbaumethoden, durch die Sonderregister definiert werden, von pureQuery Runtime nicht eingeschränkt. Die Anweisungen sind unabhängig davon, ob die Anweisung in der pureQueryXML-Datei enthalten ist, immer zulässig.
Wenn eine SQL-Anweisung mit optimistischem Sperren ausgeführt wird, kann sie nicht statisch ausgeführt werden. Daher erfasst pureQuery Runtime keine Anweisungen, die mit optimistischem Sperren ausgeführt werden. Die Anweisungen werden nicht von den pureQuery Runtime-Optionen allowDynamicSQL und capturedOnly beeinflusst. Optimistisches Sperren wird durch folgende Methoden aktiviert:

DB2Connection.prepareDB2OptimisticLockingQuery
DB2Statement.executeDB2OptimisticLockingQuery

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