Sie legen pureQuery Runtime-Eigenschaften auf der Datenquellenebene fest. Die aus dem Repository abgerufenen pureQuery Runtime-Eigenschaften werden auch auf der Datenquellenebene festgelegt. Nach dem Neustart der Anwendung erfasst pureQuery Runtime von der Anwendung ausgegebene SQL-Anweisungen.
Vorbereitende Schritte
Stellen Sie sicher, dass WebSphere Application
Server eine dynamische Anwendung ausführt. Die Anwendung verwendet eine Datenquelle mit dem JNDI-Namen jdbc/nobleDS, die für den DB2-Provider verfügbar ist.
Informationen zu diesem Vorgang
Sie erstellen angepasste WebSphere-JDBC-Provider-Eigenschaften für die Datenquelle. Die Eigenschaften werden von pureQuery Runtime und IBM® Data
Server Driver für JDBC und SQLJ verwendet.
Die angepasste Eigenschaft
pdqProperties für
pureQuery Runtime verweist auf das in der Task
Szenario: Repository für pureQuery Runtime erstellen und konfigurieren erstellte Repository. Die Eigenschaft
dataSourceName für den DB2-Treiber gibt die Transaktionsdatenbank als Datenquelle an. In der folgenden Tabelle werden die WebSphere-Eigenschaften und ihre Werte aufgelistet:
Tabelle 1. Angepasste WebSphere-Eigenschaften Name der angepassten WebSphere-Datenquelleneigenschaft |
Wert |
pdqProperties |
finalRepositoryProperties(ds://jdbc/nobleDS),
propertiesGroupId(testApp), repositoryRequired(atStartup), propertiesRefreshInterval(2) |
dataSourceName |
nobleDS |
Wenn Sie die angepassten Datenquelleneigenschaften pdqProperties und dataSourceName angeben, geben Sie die pureQuery Runtime-Eigenschaften der Datenquelle an.
Anmerkung: Wenn Sie pureQuery Runtime-Eigenschaften der Datenquelle mithilfe der Zeichenfolge pdqProperties festlegen, haben diese Eigenschaften Vorrang vor der angepassten Datenquelleneigenschaft dataSourceName.
Vorgehensweise
Gehen Sie wie folgt vor, um angepasste Datenquelleneigenschaften in WebSphere Application Server festzulegen:
- Legen Sie die angepasste Datenquelleneigenschaft pdqProperties für die Datenquelle fest.
Wechseln Sie in der Administrationskonsole zum Teilfenster Angepasste Eigenschaften.
.
Erstellen Sie die Eigenschaft pdqProperties.
Legen Sie die folgenden Werte fest, um eine angepasste Eigenschaft für die pureQuery Runtime-Eigenschaften anzugeben:
finalRepositoryProperties(ds://jdbc/nobleDS),
propertiesGroupId(testApp), repositoryRequired(atStartup), propertiesRefreshInterval(2)
Die angepasste WebSphere-Eigenschaft gibt die folgenden pureQuery Runtime-Eigenschaften an:
- finalRepositoryProperties
- Der Wert gibt die Position des Repositorys an, das die von der Anwendung verwendeten pureQuery Runtime-Eigenschaften speichert.
Beim Szenario ist der Wert die Datenquelle ds://jdbc/nobleDS. Die Repository-Datenbank entspricht der Transaktionsdatenbank.
- propertiesGroupId
- Der Wert gibt die Laufzeitgruppen-ID an, die die pureQuery
Runtime-Eigenschaften und pureQueryXML-Daten für die Anwendung speichert. Der Wert von propertiesGroupId muss eine definierte Laufzeitgruppen-ID im angegebenen Repository in einer Datenbank sein. Im Szenario befindet sich das Repository in der Datenbank, die von der Datenquelle jdbc/nobleDS angegeben ist. Der Wert von propertiesGroupId ist die ID der in Szenario: Repository für pureQuery Runtime erstellen und konfigurieren erstellten Laufzeitgruppe.
- repositoryRequired
- Der Wert gibt das pureQuery Runtime-Verhalten bei nicht verfügbarem Repository an. Beim Szenario ist der Wert atStartup.
Das Repository ist beim Anwendungsstart erforderlich, um die
pureQuery Runtime-Eigenschaften und pureQuerXML-Daten aus dem Repository zu lesen.
Wenn das Repository nicht verfügbar ist oder Lesefehler auftreten, wird für die Anwendung eine Ausnahmebedingung ausgelöst. Im Folgenden werden die anderen für die Eigenschaft repositoryRequired zulässigen Werte aufgelistet:
- Der Wert forOutput gibt an, dass für die Anwendung eine Ausnahmebedingung ausgelöst wird, wenn das Repository, das die erfassten SQL-Daten speichert, nicht verfügbar ist, wenn pureQuery Runtime versucht, zum ersten Mal in das Repository zu schreiben.
- Der Wert atStartupAndForOutput gibt an, dass das
pureQuery Runtime-Verhalten für atStartup und forOutput aktiviert ist.
Wenn die Eigenschaft repositoryRequired nicht angegeben ist und die durch die Option finalRepositoryProperties angegebene Speicherposition nicht verfügbar ist, führt pureQuery Runtime SQL-Anweisungen dynamisch aus, bis das Repository verfügbar wird.
Tipp: Wenn die Anwendung SQL-Anweisungen statisch oder mit verschiedenen SQL-Ersetzungen ausführen muss, geben Sie die Eigenschaft repositoryRequired mit dem Wert atStartup oder atStartupAndForOutput an.
- propertiesRefreshInterval
- Der Wert gibt (in Minuten) das Intervall für Überprüfungen auf Aktualisierungen der pureQuery Runtime-Eigenschaften oder pureQueryXML-Daten an, die an der durch die Eigenschaft finalRepositoryProperties angegebenen Position gespeichert sind.
pureQuery Runtime prüft nur auf Aktualisierungen der Eigenschaften, wenn die Eigenschaft propertiesRefreshInterval eine der abgerufenen Eigenschaften ist und wenn der Wert der Eigenschaft eine positive ganze Zahl ist.
Anmerkung: Sie können das Aktualisierungsintervall ändern, nachdem pureQuery Runtime zum ersten Mal die Eigenschaften abgerufen hat. Sie können die Eigenschaft
propertiesRefreshInterval als beim Anwendungsstart zu verwendende Eigenschaft festlegen. Sie können sie auch als Eigenschaft festlegen, die von der Speicherposition abgerufen wird, die durch die Eigenschaft
finalRepositoryProperties angegeben wird.
Wenn das Repository beim Start nicht benötigt wird, können Sie auf der Basis der Verfügbarkeit des Repositorys verschiedene Aktualisierungsintervalle angeben. Das von der Anwendung angegebene Aktualisierungsintervall ist so lange gültig, bis das Repository verfügbar ist. Sobald das Repository verfügbar ist, kommt das Aktualisierungsintervall zur Anwendung, das von der durch die Eigenschaft finalRepositoryProperties angegebenen Speicherposition abgerufen wird.
- Legen Sie die angepasste WebSphere-Datenquelleneigenschaft dataSourceName fest.
Erstellen Sie im Teilfenster Angepasste Eigenschaften die angepasste DB2 Universal-JDBC-Eigenschaft dataSourceName.
Setzen Sie den Wert auf eine Zeichenfolge, die die Datenquelle angibt.
Beim Szenario ist der Wert auf nobleDS gesetzt.
- Starten Sie WebSphere Application
Server erneut.
Der Anwendungsserver wird mit den Änderungen an CLASSPATH des Providers und an der Datenquelle, die durch die angepassten Eigenschaften angegeben werden, erneut gestartet.
Ergebnisse
Wenn die angepasste Eigenschaft pdqProperties des WebSphere-JDBC-Providers von WebSphere für die Datenquelle erkannt wird, werden alle aus dieser Datenquelle erstellten Verbindungen für die pureQuery-Clientoptimierung aktiviert. Die pureQuery Runtime-Eigenschaft finalRepositoryProperties gibt die Position des Repositorys an, an der die pureQuery Runtime-Eigenschaften gespeichert werden. Die pureQuery Runtime-Eigenschaft propertiesGroupId gibt die Laufzeitgruppe im Repository an.
Da die pureQuery-Eigenschaft propertiesRefreshInterval aus dem Repository abgerufen wird, können Sie die pureQuery-Konfigurationsinformationen, pureQuery-Eigenschaften und pureQueryXML-Daten aktualisieren, ohne den Anwendungsserver erneut zu starten. Die Anwendung prüft auf Updates für die Informationen, ruft die aktualisierten Informationen ab und verwendet sie.
Tipp: Wenn mehrere Anwendungen die Datenquelle gemeinsam nutzen, können Sie die pureQuery Runtime-Eigenschaften auf der Anwendungsebene überschreiben.
Nächste Schritte
In der nächsten Task führen Sie die WebSphere-Anwendung aus, um SQL-Anweisungen auszuführen.
pureQuery Runtime erfasst die SQL-Anweisungen sowie zugeordneten SQL-Daten und speichert die Daten im Repository.