< Anterior | Siguiente >

Lección 2: Captura de sentencias SQL utilizando la optimización de clientes de pureQuery

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:

Para capturar sentencias SQL utilizando la optimización de clientes de pureQuery:

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

  2. Habilite la optimización de clientes de pureQuery para el proyecto.
    1. Pulse con el botón derecho del ratón en el proyecto en el Explorador de proyectos y seleccione Propiedades.
    2. En la ventana Propiedades, abra la página pureQuery pulsando en el nodo pureQuery.
    3. Bajo Optimización de cliente, seleccione 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=dataAccessFolder/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 dataAccessFolder/capture.pdqxml.

    En la carpeta del proyecto dataAccessFolder, 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\dataAccessFolder\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.
  3. Ejecute la aplicación y capture los datos SQL.
    1. En el Explorador de paquetes, pulse con el botón derecho del ratón en el archivo MySample.java, pulse Ejecutar como > Aplicación Java.
    2. En el Explorador de paquetes, pulse con el botón derecho del ratón en la carpeta pq-tutorial\dataAccessFolder y seleccione Renovar.

    El archivo de pureQueryXML aparece en la carpeta dataAccessFolder. El archivo contiene información SQL capturada por pureQuery Runtime.

  4. Capture otra sentencia SQL de la aplicación.
    1. 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 ;
    2. Guarde el archivo.
    3. 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 Ejecutar como > Aplicación Java.

      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 InfoSphere Optim pureQuery Runtime 2.2.1.0 build 2.35.73
       =======
      case 1
      case 1 - non-systems employees: 24
      Finished case 1
  5. Visualice el archivo pureQueryXML que contiene las dos sentencias SQL que ha capturado.
    1. En el Explorador de paquetes, vaya a la carpeta dataAccessFolder.
    2. Renueve la carpeta dataAccessFolder para que visualice el archivo capture.pqdxml.
    3. 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.

  6. 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
    Archivo capture.pdqxml visualizado 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.

  7. 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.

  8. Cierre el editor de pureQueryXML.

    Pulse en la X del separador capture.pdqxml.

Punto de comprobación de la lección

Ha configurado el soporte para pureQuery en el proyecto Java para habilitar la captura y enlace de datos SQL desde la aplicación. Ha ejecutado la aplicación y capturado datos SQL de ella.
En el entorno de trabajo, ha realizado las tareas siguientes:
  • Ha configurado el soporte para pureQuery con las propiedades del proyecto.
  • Ha ejecutado una aplicación Java desde el entorno de trabajo.
  • Ha visualizado los datos SQL que ha capturado en el editor de pureQueryXML.
< Anterior | Siguiente >

Comentarios