Von CLI- und .NET-Anwendungen unterstützte pureQuery-Schlüsselwörter

Wenn Sie eine CLI- oder .NET-Anwendung für die pureQuery-Clientoptimierung aktivieren, können Sie die pureQuery-Clientoptimierung durch die Angabe von Schlüsselwörtern und Werten in der Anwendungskonfigurationsdatei konfigurieren.
In der folgenden Tabelle werden die pureQuery Runtime-Eigenschaften aufgelistet, die für CLI- und .NET-Anwendungen als pureQuery-Schlüsselwörter verwendet werden können. Nicht alle pureQuery Runtime-Eigenschaften werden von den CLI- und .NET-Anwendungen unterstützt, die für die pureQuery-Clientoptimierung aktiviert sind.
Tabelle 1. pureQuery-Eigenschaften, die von für die pureQuery-Clientoptimierung aktivierten CLI- und .NET-Anwendungen unterstützt werden
Eigenschaft Beschreibung
allowDynamicSQL1 Gibt an, ob eine Anwendung die folgenden Typen von SQL-Anweisungen dynamisch ausführen darf: SQL-Anweisungen, die nicht in einer pureQueryXML-Datei erfasst sind, und SQL-Anweisungen, die in einer pureQueryXML-Datei erfasst sind, aber nicht vom Dienstprogramm StaticBinder gebunden wurden.
capturedOnly1 Gibt an, ob nur die SQL-Anweisungen ausgeführt werden sollen, die sich in der pureQueryXML-Datei befinden.
captureMode Gibt an, ob Informationen zu SQL-Anweisungen erfasst werden sollen.
enableDynamicSQLReplacement1 Gibt an, ob alternative SQL-Anweisungen in einer pureQueryXML-Datei ausgeführt werden sollen, wenn weder diese alternativen Anweisungen noch die ursprünglichen SQL-Anweisungen vom Dienstprogramm StaticBinder gebunden worden sind.
executionMode Gibt an, ob die SQL-Anweisungen, die zuvor von pureQuery Runtime erfasst und gespeichert wurden, statisch ausgeführt werden sollen.
maxNonParmSQL1 Gibt die maximale Anzahl nicht parametrisierter SQL-Anweisungen an, die erfasst werden können. Diese Option wird nur angewendet, wenn captureMode den Wert ON aufweist. Wenn captureMode auf OFF gesetzt ist, ignoriert pureQuery diesen Parameter.
propertiesGroupId1 Gibt eine Laufzeitgruppen-ID in einem Repository an, das in einer Datenbank erstellt ist. pureQuery Runtime verwendet die Laufzeitgruppen-ID und die Verbindungsinformationen, die das Repository angeben, um pureQuery-Laufzeitkonfigurationsdaten und pureQueryXML-Dateiinformationen abzurufen.
pureQueryXml 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.
pureQueryXmlRepository1 Gibt das Repository an, das die pureQueryXML-Dateidaten enthält, die mit einer für die pureQuery-Clientoptimierung aktivierten CLI- oder .NET-Anwendung verwendet werden.
repositoryRequired1 Gibt das Verhalten der pureQuery-Clientoptimierung an, wenn beim Abrufen von pureQuery-Daten Fehler auftreten. Wenn die pureQuery-Laufzeiteigenschaften und die pureQueryXML-Daten nicht von der über die Eigenschaft pureQueryXmlRepository angegebenen Speicherposition abgerufen werden können.
sqlLiteralSubstitution1 Gibt an, ob Literalersetzungen ausgeführt werden sollen. pureQuery Runtime versucht, Literalwerte in SQL-Anweisungen durch Parametermarken zu ersetzen und die parametrisierten Versionen der Anweisungen auszuführen.
traceFile Gibt die Datei an, in die das Protokoll geschrieben werden soll. Sie können einen absoluten Pfad oder einen Pfad verwenden, der relativ zu dem Verzeichnis ist, in dem das pureQuery-Protokolldienstprogramm ausgeführt wird.
traceLevel1 Gibt die Detaillierungsebene für den Schreibvorgang in die Protokolldatei an.
1 Unterstützt von pureQuery für .NET-Anwendungen mit IBM Data Server Driver Package Version 9.7 Fixpack 6 oder höher.

Hinweise

  • pureQuery Runtime-Schlüsselwörter können als Eigenschaft einer Anwendungsverbindung, für CLI- und .NET-Anwendungen in der Datei db2cli.ini oder für CLI-Anwendungen in der Datei db2dsdriver.cfg angegeben werden. Wird ein Schlüsselwort an mehreren Positionen angegeben, gilt die folgende Reihenfolge (von höchster Position zur niedrigsten):
    • Eigenschaft einer Anwendungsverbindung
    • Datei db2cli.ini
    • Datei db2dsdriver.cfg
  • pureQuery Runtime prüft, ob eine gültige pureQuery-Lizenz vorhanden ist, wenn eines der pureQuery Runtime-Schlüsselwörter in einer Konfigurationsdatei angegeben wird. Wenn keine gültige pureQuery-Lizenz gefunden wird, wird pureQuery Runtime mit dem Fehlercode SQL8029N beendet.
  • pureQuery Runtime prüft die folgenden Schlüsselwörter in einer CLI- oder .NET-Anwendungsumgebung. Wenn die Schlüsselwörter nicht auf ihre Standardwerte gesetzt sind und pureQuery Runtime feststellt, dass eine pureQueryXML-Datei erforderlich ist:
    • capturedOnly
    • captureMode
    • enableDynamicSQLReplacement
    • executionMode
  • Wenn eine pureQueryXML-Datei erforderlich, jedoch nicht angegeben ist, gibt pureQuery Runtime den Fehler CLI0124E "Ungültiger Wert für Argument" zurück. SQLSTATE=S1009

Feedback