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

Wenn Sie mehrere DB2-Paketsammlungen verwenden müssen, lesen Sie den Information-Center-Artikel "pureQuery für die Verwendung mehrerer Paketsammlungen konfigurieren", bevor Sie diese Task fortsetzen.

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

  1. 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.
  2. 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".

Nächste Schritte

Wenn Sie die Datenquelle für JDBC neu konfigurieren, entfernen Sie die Dateien pdq.jar und pdqmgmt.jar aus dem Klassenpfad.

Symbol, das den Typ des Artikels anzeigt. Taskartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tejb_configpdqjpase
Dateiname:tejb_configpdqjpase.html