JDBC-Provider von Datenquellen für Verwendung von pureQuery in einer Java SE-Umgebung konfigurieren
Verwenden Sie diese Task, um den JDBC-Provider (Java™ Database Connectivity) für Anwendungsdatenquellen so zu konfigurieren, dass pureQuery für den Zugriff auf DB2 in einer Java SE-Umgebung verwendet wird. Diese Konfiguration ist für die Verwendung mit dem Java™ Persistence API (JPA) 2.0-Spezifikationsprovider, WSJPA, bestimmt.
Vorbereitende Schritte
Informationen zu diesem Vorgang
IBM® Optim PureQuery Runtime verwendet DB2-Pakete. Diese Pakete setzen sich aus Informationen für eine oder mehrere
SQL-Anweisungen (Structured Query Language) zusammen und sind im
DB2-Katalog gespeichert. Sie müssen zuerst den Befehl "wsdbgen" in einer
JPA-Anwendung (Java Persistence
API) ausführen, um die Pakete zu erstellen. Der Befehl "wsdbgen" erstellt eine
XML-Datei, die Informationen zu SQL-Anweisungen enthält. Diese XML-Datei muss in die JAR-Datei
(Java-Archiv) der Anwendung eingeschlossen werden. Der DB2-Befehl "bind" verwendet diese Datei als Eingabe für die Erstellung des
DB2-Pakets.
Wichtig:
- JPA setzt die Eigenschaft pdq.executionMode von IBM Optim PureQuery Runtime auf den Wert STATIC.
- Der Klassenpfad muss die Installationsposition für IBM Optim PureQuery Runtime enthalten. Weitere Informationen finden Sie im Information-Center-Artikel zum Installieren von IBM Optim PureQuery Runtime.
- Die JPA-Providerimplementierung muss für den Anwendungsserver JPA sein (com.ibm.websphere.persistence.PersistenceProviderImpl). Die OpenJPA- und EclipseLink-Persistenzprovider bieten keine Unterstützung für pureQuery.
- Der Befehl "wsdbgen" setzt den URL einer Datenbank voraus. Der Befehl "wsdbgen" ruft eine Synchronisationszuordnungsfunktion auf, die die erforderlichen Tabellen erstellt oder ändert. Für DB2 for z/OS Version 8 müssen eindeutige Indizes und LOB-Tabellen manuell erstellt werden, bevor der Befehl "wsdbgen" ausgeführt wird.
Eigenschaften
von IBM Optim PureQuery Runtime werden in einer Datei pdq.properties im Verzeichnis
META-INF der Anwendungs-JAR-Datei angegeben. Die Eigenschaft pdq.ExecutionMode
wird für JPA-Anwendungen standardmäßig auf STATIC gesetzt. Sie können die Eigenschaft "pdqProperties"
einsetzen, um pureQuery im dynamischen Modus (DYNAMIC) zu verwenden. Weitere Informationen finden Sie im Information-Center-Artikel "pureQuery im dynamischen Modus verwenden".
PDQ-Eigenschaften, sofern angegeben, werden an
IBM Optim PureQuery Runtime weitergegeben. Eine Liste der Eigenschaften und ihrer gültigen Werte finden Sie in der Dokumentation zu
IBM Optim PureQuery Runtime.
- wsjpa.jdbc.CollectionId: Zeichenfolgewert, der die zu verwendende Sammlungs-ID angibt. Dieser Parameter überschreibt die während der Ausführung von "wsdbgen" verwendete Sammlungs-ID.
Achtung: Weitere
Informationen zur Kompatibilität der
DB2-JAR-Version für IBM Optim PureQuery Runtime finden Sie auf der
IBM Unterstützungswebsite im Artikel
"System requirements for IBM Optim PureQuery Runtime
for Linux, UNIX, and Windows".
Vorgehensweise
- Aktualisieren Sie die Konfiguration des JDBC-Providers für Anwendungsdatenquellen so, dass die JAR-Dateien für IBM Optim PureQuery Runtime eingeschlossen sind. Fügen Sie die Dateien pdq.jar und pdqmgmt.jar zusätzlich zu den JAR-Dateien des JDBC-Treibers in den Klassenpfad ein. Definieren Sie einen neuen JDBC-Provider oder ändern Sie einen vorhandenen Provider und fügen Sie die JAR-Dateien ein. Der Klassenpfad muss die Installationsposition für IBM Optim PureQuery Runtime enthalten. Weitere Informationen finden Sie in den Information-Center-Artikeln zu den Einstellungen für JDBC-Provider und zum Installieren von IBM Optim PureQuery Runtime.
- Verwenden Sie den von IBM Optim PureQuery Runtime bereitgestellten DB2-Befehl "bind", um die XML-Datei an die Datenbank zu binden. Dieser Befehl erstellt die DB2-Pakete. Weitere Informationen finden Sie im Information-Center-Artikel zum PureQuery-Dienstprogramm "Bind".