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

Wenn Sie eine CLI-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-Anwendungen als CLI-Schlüsselwörter verwendet werden können. Nicht alle pureQuery Runtime-Eigenschaften werden von den CLI-Anwendungen unterstützt, die für die pureQuery-Clientoptimierung aktiviert sind.
Tabelle 1. pureQuery-Eigenschaften, die von für die pureQuery-Clientoptimierung aktivierten CLI-Anwendungen unterstützt werden
Eigenschaft Beschreibung
allowDynamicSQL Gibt an, ob eine Anwendung SQL-Anweisungen dynamisch ausführen darf, die nicht in einer pureQueryXML-Datei erfasst sind bzw. erfasst, aber nicht gebunden sind.
capturedOnly 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.
enableDynamicSQLReplacement Gibt an, ob alternative SQL-Anweisungen, die einer pureQueryXML-Datei hinzugefügt wurden, ausgeführt werden sollen, wenn die ursprünglichen SQL-Anweisungen und die alternativen SQL-Anweisungen nicht gebunden wurden.
executionMode Gibt an, ob die SQL-Anweisungen, die zuvor von pureQuery Runtime erfasst und gespeichert wurden, statisch ausgeführt werden sollen.
maxNonParmSQL Gibt die maximale Anzahl nicht parameterisierter SQL-Anweisungen an, die erfasst werden kann. Diese Option wird nur angewendet, wenn captureMode den Wert ON aufweist. Wenn captureMode auf OFF gesetzt ist, ignoriert pureQuery diesen Parameter.
propertiesGroupId 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.
pureQueryXmlRepository Gibt das Repository an, das die pureQueryXML-Dateidaten enthält, die mit einer mit pureQuery-Clientoptimierung aktivierten CLI-Anwendung verwendet werden.
repositoryRequired 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.
sqlLiteralSubstitution 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.
traceLevel Gibt die Detaillierungsebene für den Schreibvorgang in die Protokolldatei an.

Hinweise

  • 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-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