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 oder CLI (Call Level Interface) einschließen.
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 mit der pureQuery-API3 Java-Anwendungen mit der pureQuery-Clientoptimierung CLI-Anwendungen mit der pureQuery-Clientoptimierung
allowDynamicSQL1 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.   X X
capturedOnly2 Gibt an, ob nur die SQL-Anweisungen ausgeführt werden sollen, die sich in der pureQueryXML-Datei befinden. X X X
captureMode Gibt an, ob Informationen zu SQL-Anweisungen erfasst werden sollen. X 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 X  
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. X 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-aktivierten Anwendung verwendeten pureQuery-Eigenschaften an.   X  
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. X 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 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 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 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  
propertiesRefreshInterval Gibt die Dauer der Wartezeit in Minuten an, bevor die pureQuery-Clientoptimierung die in der Speicherposition gespeicherten pureQuery-Daten auf Änderungen prüft, die an pureQuery-Eigenschaften oder pureQueryXML-Daten vorhanden sind. Werden Aktualisierungen erkannt, ruft die pureQuery-Clientoptimierung die aktualisierten pureQuery-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 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  
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 zu erfassen. X 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 X  
traceFile Gibt die physische 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
traceLevel 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. pureQuery-Eigenschaften können nicht mit der pureQuery-Schnittstelle EnhancedDataSource oder mit der Klasse DataFactory verwendet werden.
    com.ibm.pdq.runtime.datasource Interface EnhancedDataSource
    capturedOnly
    captureMode
    captureStatementBatchSQL
    enableDynamicSQLReplacement
    maxNonParmSQL
    maxStackTracesCaptured
    outputPureQueryXml
    packagePrefixExclusions
    pureQueryXml
    stackTraceDepth
    sqlLiteralSubstitution
    com.ibm.pdq.runtime.factory.DataFactory
    executionMode
    queryTimeoutInSeconds
    maxResultRows

Feedback