En esta lección, configurará el proyecto para la optimización de clientes de
pureQuery. Ejecutará una aplicación Java™ y capturará sentencias
SQL en un archivo pureQueryXML.
Antes de empezar
Compruebe que el entorno cumpla los
requisitos siguientes:
- El soporte para pureQuery debe estar habilitado para el proyecto Java.
- Debe tener instalada una base de datos DB2 con la base de
datos SAMPLE.
- Las propiedades de conexión de base de datos para el proyecto deben especificar
una conexión con la base de datos SAMPLE, e IBM Data Server Driver
para JDBC y SQLJ debe estar en la vía de acceso de la compilación del proyecto.
En esta lección, realizará las tareas siguientes:
- Habilitar la optimización de clientes de pureQuery para el proyecto.
- Capturar datos SQL de la aplicación simple.
Para capturar sentencias SQL utilizando la optimización de clientes de pureQuery:
- Si es necesario, active la conexión con la base de datos SAMPLE.
En el Explorador de orígenes de datos, seleccione Conexiones de
base de datos\SAMPLE, pulse con el botón derecho del ratón y
seleccione Conectar. Si aparece Propiedades, especifique
cualquier información de conexión necesaria y pulse Aceptar.
- Habilite la optimización de clientes de pureQuery para el proyecto.
- Pulse con el botón derecho del ratón y seleccione Propiedades.
- En la ventana Propiedades, abra la
página pureQuery pulsando en el nodo pureQuery.
- Bajo Optimización de cliente, active Habilitar la captura y enlace de SQL para aplicaciones JDBC. Pulse Aceptar.
El archivo de propiedades de pureQuery Runtime
pdq.properties se crea
en la carpeta
src del proyecto con los valores
de propiedades de pureQuery Runtime:
pdq.captureMode=ON
pdq.executionMode=DYNAMIC
pdq.pureQueryXml=pureQueryFolder/capture.pdqxml
Cuando estos valores están habilitados,
pureQuery Runtime captura las sentencias SQL emitidas por la aplicación
y almacena los datos SQL capturados en el archivo pureQueryXML pureQueryFolder/capture.pdqxml.
En la carpeta del proyecto
pureQueryFolder, el archivo de propiedades de configuración
de pureQuery
Default.genProps se actualiza con la siguiente información
de opción
-rootPkgName:
C:\test\pq-tutorial\pureQueryFolder\capture.pdqxml= -rootPkgName pq-tut
El
entorno de trabajo utiliza la información de la opción
-rootPkgName para configurar
el archivo pureQueryXML. La configuración del archivo pureQueryXML es un paso del proceso de configuración
de pureQuery Runtime para que ejecute estáticamente las sentencias SQL en una base de
datos DB2.
- Ejecute la aplicación y capture los datos SQL.
- En el Explorador de paquetes, pulse con el botón derecho del ratón en el
archivo MySample.java, pulse .
- En el Explorador de paquetes, pulse con el botón derecho del ratón en la
carpeta pq-tutorial\pureQueryFolder y seleccione Renovar.
El archivo pureQueryXML aparece en la carpeta pureQueryFolder.
El archivo contiene información SQL capturada por pureQuery Runtime.
- Capture otra sentencia SQL de la aplicación.
- En el código fuente, cambie el valor que determina la sentencia SQL
predeterminada que se debe ejecutar.
Cambie el valor de la variable i de 0 a 1 en el código siguiente:
if ( args.length == 0) {
// valor para la sentencia SQL predeterminada que se va a ejecutar
i = 1 ;
- Guarde el archivo.
- Ejecute la aplicación para que capture la sentencia SQL.
En el Explorador de paquetes, pulse con el botón derecho del ratón en el
archivo MySample.java y seleccione .
La aplicación se ejecuta y
pureQuery Runtime captura la información SQL de la aplicación. La salida
aparece en la ventana
Consola. La salida es
similar al ejemplo siguiente:
=======
IBM Optim pureQuery Runtime 2.2.1.0 build 2.25.63
=======
case 1
case 1 - non-systems employees: 24
Finished case 1
- Visualice el archivo pureQueryXML que contiene las dos sentencias SQL que ha
capturado.
- En el Explorador de paquetes, vaya a la
carpeta pureQueryFolder.
- Renueve la carpeta pureQueryFolder para que visualice
el archivo capture.pqdxml.
- Efectúe una doble pulsación en el archivo capture.pqdxml para abrirlo
en el editor de pureQueryXML.
En el editor de pureQueryXML se visualiza el archivo pureQueryXML.
- Expanda el conjunto de sentencias para ver las dos sentencias SQL capturadas
por pureQuery Runtime.
Al seleccionar la sentencia
SQL, puede ver los datos SQL capturados como el nombre de esquema, la vía
de acceso actual y el modo de redondeo DECFLOAT.
La siguiente ilustración muestra un archivo pureQueryXML que contiene un único
conjunto de sentencias con dos sentencias SQL.
Figura 1. Archivo pureQueryXML capture.pdqxml
en el Editor de pureQueryXML
La ilustración anterior muestra un archivo pureQueryXML configurado por el
entorno de trabajo. Como parte del proceso de configuración de pureQueryXML, el conjunto de
sentencias se denomina pq-tutA. Los nombres del conjunto de sentencias
se basan en la serie pq-tut, el valor de la
opción -rootPkgName del archivo Default.genProps.
Puede gestionar las sentencias SQL
del archivo pureQueryXML con el editor de pureQueryXML. Puede realizar
acciones como cambiar el nombre a un conjunto de sentencias, ejecutar una
sentencia SQL y añadir una sentencia alternativa para una sentencia SQL
capturada.
- Ejecute una sentencia SQL desde el editor de pureQueryXML.
En el editor de pureQueryXML, pulse con el botón derecho del ratón en la primera sentencia SQL
y seleccione Ejecutar SQL.
El entorno de trabajo
ejecuta la sentencia SQL. La ventana Resultados de SQL se abre y
visualiza los resultados.
Al ejecutar la sentencia SQL desde el editor, el entorno de trabajo
utiliza la conexión definida para el proyecto. Al ejecutar la aplicación, ésta
utiliza la conexión definida en la aplicación.
- Cierre el editor de pureQueryXML.
Pulse en la X del
separador capture.pdqxml.