Configuración de los proveedores JDBC de orígenes de datos para utilizar pureQuery en un entorno Java SE

Utilice esta tarea para configurar el proveedor JDBC (Java™ Database Connectivity) de origen de datos de aplicación de modo que utilice pureQuery para acceder a DB2 en un entorno Java Standard Edition (Java SE). Esta configuración es para utilizarla con el proveedor de persistencia Java™ Persistence API (JPA) 2.0, WSJPA.

Antes de empezar

Si necesita utilizar varias colecciones de paquetes DB2, consulte el tema del Information Center, Configuración de pureQuery para utilizar varias colecciones de paquetes, antes de continuar con esta tarea.

Acerca de esta tarea

IBM® Optim PureQuery Runtime utiliza los paquetes de DB2. Estos paquetes contienen información sobre una o más sentencias SQL (Structured Query Language) y se almacenan en el catálogo de DB2. En primer lugar, debe ejecutar el mandato wsdbgen en una aplicación Java Persistence API (JPA) para crear los paquetes. El mandato wsdbgen crea un archivo XML que contiene información de sentencias SQL. Este archivo XML debe incluirse en el archivo archivador Java (JAR) de la aplicación. El mandato de enlace DB2 utiliza este archivo como entrada para crear el paquete de DB2.
Importante:
  • JPA establece la propiedad de IBM Optim PureQuery pdq.executionMode en el valor STATIC.
  • La classpath debe incluir la ubicación de instalación de IBM Optim PureQuery Runtime. Consulte el tema del Information Center sobre la instalación de IBM Optim PureQuery Runtime para obtener más información.
  • La implementación de proveedores de JPA para el servidor de aplicaciones (com.ibm.websphere.persistence.PersistenceProviderImpl). Los proveedores de persistencia OpenJPA y EclipseLink no proporcionan el soporte para pureQuery.
  • El mandato wsdbgen requiere el URL de una base de datos. El mandato wsdbgen aplica una función de correlación de sincronización que crea o altera las tablas necesarias. Para DB2 zOS, deben crearse manualmente índices exclusivos de la V8 y tablas LOB antes de ejecutar el mandato wsdbgen.
Las propiedades de IBM Optim PureQuery Runtime se especifican en un archivo pdq.properties del directorio META-INF del archivo JAR de la aplicación. El valor predeterminado de la propiedad pdq.ExecutionMode es STATIC para las aplicaciones JPA. Puede utilizar la propiedad pdqProperties para utilizar pureQuery en la modalidad DYNAMIC. Consulte el tema del Information Center, Utilización de pureQuery en modalidad dinámica, si desea más información. Las propiedades de PDQ, si se especifican, se pasan a IBM Optim PureQuery Runtime. Consulte la documentación de IBM Optim PureQuery Runtime para obtener una lista de las propiedades y de los valores válidos.
  • wsjpa.jdbc.CollectionId: valor de serie que especifica el ID de colección para utilizar. Este parámetro altera el ID de colección que se utiliza durante wsdbgen.
Atención: Consulte más información acerca del cumplimiento del nivel JAR de DB2 JAR level para IBM Optim PureQuery Runtime en sitio web de soporte de IBM: Requisitos del sistema para IBM Optim PureQuery Runtime para Linux, UNIX y Windows.

Procedimiento

  1. Actualice la configuración de proveedores de JDBC del origen de datos de aplicación para que incluya los archivos JAR de IBM Optim PureQuery Runtime. Incluya los archivos pdq.jar y pdqmgmt.jar en la vía de acceso de clases, junto con los archivos JAR del controlador JDBC. Defina un nuevo proveedor de JDBC, o bien modifique un proveedor existente para incluir los archivos JAR. La classpath debe incluir la ubicación de instalación de IBM Optim PureQuery Runtime. Consulte los temas del Information Center sobre los valores del proveedor JDBC y la instalación de IBM Optim PureQuery Runtime para obtener más información.
  2. Mediante el mandato bind de DB2 que proporciona IBM Optim PureQuery Runtime, enlace el archivo XML con la base de datos. De este modo, se crearán los paquetes de DB2. Consulte el tema del Information Center sobre el programa de utilidad bind de pureQuery para obtener más información.

Qué hacer a continuación

Si desea volver a configurar el origen de datos de JDBC, elimine los archivos pdq.jar y pdqmgmt.jar de la vía de acceso de clases.

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tejb_configpdqjpase
File name: tejb_configpdqjpase.html