Unterstützung für pureQuery Runtime-Eigenschaften in Anwendungsumgebungen

Zusammenfassung der unterstützten Eigenschaften, wenn pureQuery Runtime von Anwendungen verwendet wird, die die pureQuery-API, pureQuery-Clientoptimierung, CLI (Call Level Interface) oder .NET integrieren.
In der folgenden Tabelle werden die pureQuery Runtime-Eigenschaften und die unterstützten Anwendungsumgebungen aufgelistet.
Tabelle 1. pureQuery-Eigenschaften und unterstützte Anwendungsumgebungen
Eigenschaft Beschreibung Java™-Anwendungen, die nur die pureQuery-API verwenden Java-Anwendungen, die nur die pureQuery-Clientoptimierung verwenden CLI-, ODBC/CLI- oder .NET-Anwendungen, die die pureQuery-Clientoptimierung verwenden
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.   X X
capturedOnly2 Gibt an, ob nur die SQL-Anweisungen ausgeführt werden sollen, die sich in der pureQueryXML-Datei befinden.   X X
captureMode Gibt an, ob Informationen zu SQL-Anweisungen und dem zu erfassenden Typ von Informationen erfasst werden sollen.   X X
captureStatementBatchSQL Gibt an, ob SQL-DML-Anweisungen, die die Anwendung an eine Methode Statement.addBatch() übermittelt, bis zu der Anzahl SQL-Anweisungen (ohne SELECT-Anweisungen) erfasst werden sollen, die von der Eigenschaft maxNonParmSQL angegeben ist.   X  
com.ibm.pdq (pureQuery-Komponentenprotokolleigenschaften) Gibt die Protokollebeneneinstellung für verschiedene pureQuery-Komponenten an. X X  
dumpLogsOnSqlCodes Wenn sich Protokollsätze im Speicher befinden, gibt diese Eigenschaft die SQL-Fehlercodes an, die das Schreiben der Datensätze in die Protokolldatei auslösen. X X  
dumpLogsExcludingSqlCodes Wenn sich Protokollsätze im Speicher befinden, gibt diese Eigenschaft die SQL-Fehlercodes an, die das Schreiben der Datensätze in das Protokoll nicht auslösen. Diese Eigenschaft wird mit der Eigenschaft dumpLogsOnSqlCodes verwendet. X X  
enableDynamicSQLReplacement 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.   X X
executionMode Gibt an, ob die SQL-Anweisungen, die zuvor von pureQuery Runtime erfasst und gespeichert wurden, statisch ausgeführt werden sollen. X X X
finalRepositoryProperties Gibt die Speicherposition der mit einer pureQuery-fähigen Anwendung verwendeten pureQuery-Eigenschaften an.   X  
maxNonParmSQL 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.   X X
maxResultRow Gibt die maximale Anzahl Zeilen an, die eine Anweisung in Abfrageergebnisse zurückgibt. X    
maxStackTracesCaptured Gibt die maximale Anzahl Stack-Traces an, die für den Definitionspunkt und den Ausführungspunkt für jede SQL-Anweisung aufgezeichnet werden, die Sie erfassen.   X  
outputPureQueryXml Gibt einen vollständig qualifizierten oder relativen Pfad sowie den Namen der Datei(en) an, die der Prozess beim Erfassen von SQL-Anweisungen erstellt.   X  
outputXmlRepository Gibt eine Datenbank an, die ein Repository enthält. Das Repository speicherte erfasste SQL-Daten aus einer für die pureQuery-Clientoptimierung aktivierten Anwendung.   X  
packagePrefixExclusions Gibt eine durch Pipezeichen getrennte Liste mit Domänen und Unterdomänen der Java-Pakete an, die Sie nicht in Stack-Traces einschließen wollen.   X  
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 entweder die von einer Anwendung erfassten SQL-Daten zu speichern oder um pureQuery-Laufzeitkonfigurationsdaten und pureQueryXML-Dateiinformationen abzurufen.   X X
propertiesRefreshInterval Gibt an, wann pureQuery Runtime die in der Speicherposition gespeicherten pureQuery-Daten auf Änderungen prüft, die an pureQuery Runtime-Eigenschaften oder pureQueryXML-Daten nach dem Anwendungsstart vorgenommen wurden. Wenn pureQuery Runtime Aktualisierungen erkennt, ruft pureQuery Runtime die aktualisierten Laufzeiteigenschaften und pureQueryXML-Daten ab und verwendet die aktualisierten Informationen.   X  
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.   X X
pureQueryXmlRepository 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.     X
queryTimeoutInSeconds Die Anzahl Sekunden, die gewartet wird, bis die SQL-Anweisung ausgeführt wird. X    
repositoryRequired Gibt das Verhalten der pureQuery-Clientoptimierung an, wenn während des Abrufens oder Schreibens von pureQuery-Daten Fehler auftreten. Wenn die pureQuery-Laufzeiteigenschaften und die pureQueryXML-Daten nicht von der über die Eigenschaft finalRepositoryProperties angegebene Speicherposition abgerufen werden können oder wenn das Repository, in dem das erfasste SQL gespeichert ist, nicht zugänglich ist.   X X
repositorySchema Gibt das Schema für ein Repository an, das in einer Datenbank erstellt wird. X X  
runtimeGroupActivationCheckInterval4 Gibt die Dauer der Wartezeit in Minuten an, bevor pureQuery Runtime prüft, ob eine pureQuery-Laufzeitgruppe aktiviert wurde.   X  
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.   X X
stackTraceDepth Gibt die maximale Anzahl Stack-Trace-Einträge an, die für jede SQL-Anweisung aufgezeichnet werden. Diese Einträge werden in der pureQueryXML-Datei erfasst.   X  
traceBufferRowCount Gibt die Anzahl von Datensätzen des Traceinformationsprotokolls an, die im Speicher gepuffert werden. X X  
traceFile3 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. X X X
traceLevel3 Gibt die Detaillierungsebene für den Schreibvorgang in die Protokolldatei an. X X X
Anmerkung:
  1. Die Eigenschaft wird nur angewendet, wenn der Wert der Eigenschaft executionMode STATIC ist.
  2. Der Wert der Eigenschaft capturedOnly kann nicht auf TRUE gesetzt werden, wenn Sie SQL-Anweisungen erfassen.
  3. Die pureQuery Runtime-Eigenschaften traceFile und traceLevel können nur in einer globalen Datei pdq.properties angegeben werden. Informationen zu globalen Eigenschaftendateien finden Sie in Umfang der pureQuery Runtime-Eigenschaften in einer WebSphere Application Server-Umgebung.
  4. Die pureQuery Runtime-Eigenschaft runtimeGroupActivationCheckInterval kann nur als globale Eigenschaft angegeben werden. Informationen zum Angeben der Eigenschaft finden Sie in den Hinweisen zur Verwendung von runtimeGroupActivationCheckInterval.

Feedback