Configuration des fournisseurs JDBC de source de données pour utiliser pureQuery dans un environnement Java SE
Suivez les instructions de cette rubrique pour configurer le fournisseur JDBC (Java™ Database Connectivity) de la source des données de l'application afin d'utiliser pureQuery pour accéder à DB2 dans un environnement Java Standard Edition (Java SE). Cette configuration s'applique au fournisseur de spécification Persistence API (JPA) 2.0, WSJPA.
Avant de commencer
Pourquoi et quand exécuter cette tâche
IBM® Optim PureQuery Runtime
utilise des modules DB2. Ces modules incluent des informations relatives à une ou plusieurs instructions SQL et sont stockés dans le catalogue
DB2.
Vous devez tout d'abord exécuter la commande wsdbgen
sur une application Java Persistence
API (JPA) pour créer les modules. La commande wsdbgen crée un fichier XML qui contient les informations sur l'instruction SQL. Ce fichier XML doit figurer dans le fichier Java archive
(JAR) de l'application. La commande de liaison de DB2
utilise ce fichier en tant qu'entrée pour créer le moduleDB2.
Important :
- Pour les applications JPA, la propriété pdq.executionMode d'IBM Optim PureQuery est réglée sur STATIC.
- Le chemin d'accès aux classes doit inclure l'emplacement d'installation d'IBM Optim PureQuery Runtime. Pour plus d'informations, voir la rubrique sur l'installation d'IBM Optim PureQuery Runtime dans le centre de documentation.
- L'implémentation du fournisseur JPA doit être JPA pour le serveur d'applications (com.ibm.websphere.persistence.PersistenceProviderImpl). Les fournisseurs de persistance OpenJPA et EclipseLink ne fournissent pas la prise en charge de pureQuery.
- La commande wsdbgen requiert l'URL d'une base de données. La commande wsdbgen provoque une fonction de mappage synchronisé qui crée ou altère les tableaux requis. Pour DB2 zOS, les index à entrées uniques V8 ainsi que les tableaux LOB doivent être créés manuellement avant l'exécution de la commande wsdbgen.
Les propriétés
d'IBM Optim PureQuery Runtime
sont spécifiées dans un fichier pdq.properties, dans le répertoire META-INF du fichier JAR de
l'application. La propriété pdq.ExecutionMode
est réglée par défaut sur STATIC pour les applications JPA. Vous pouvez employer la propriété pdqProperties
pour utiliser pureQuery en mode DYNAMIC. Pour plus d'informations, voir la rubrique du centre de documentation relative
à l'utilisation de pureQuery en mode dynamique. Les propriétés PDQ, lorsqu'elles sont spécifiées,
sont passées à IBM Optim PureQuery Runtime. Pour la liste des propriétés et des valeurs valides, consultez la documentation relative à IBM Optim PureQuery Runtime.
- wsjpa.jdbc.CollectionId : Valeur de chaîne indiquant l'ID collection à utiliser. Elle se substitue à tout ID collection utilisé dans wsdbgen.
Avertissement : Des informations supplémentaires sur la conformité de niveau DB2 JAR pour
IBM Optim PureQuery Runtime sont disponibles sur le site Web
de support IBM suivant : System requirements for IBM Optim PureQuery Runtime for Linux,
UNIX, and Windows).
Procédure
- Mettez à jour la configuration du fournisseur JDBC de la source de données de l'application afin d'y inclure les fichiers JAR d'IBM Optim PureQuery Runtime. Incluez les fichiers pdq.jar et pdqmgmt.jar sur le chemin d'accès aux classes en plus des fichiers jar du pilote JDBC. Définissez un nouveau fournisseur JDBC ou modifiez un fournisseur existant afin d'inclure les fichiers JAR. Le chemin d'accès aux classes doit inclure l'emplacement d'installation d'IBM Optim PureQuery Runtime. Pour plus d'informations, voir les rubriques sur les paramètres du fournisseur JDBC et sur l'installation d'IBM Optim PureQuery Runtime dans le centre de documentation.
- A l'aide de la commande de liaison (BIND) DB2 fournie par IBM Optim PureQuery Runtime, liez le fichier XML à la base de données. Cela crée les modules DB2. Pour plus d'informations, voir la rubrique sur l'utilitaire pureQuery Bind.