< Précédent | Suivant >

Leçon 2 : Capture des instructions SQL à l'aide de l'optimisation client pureQuery

Dans cette leçon, vous allez configurer votre projet pour l'optimisation client pureQuery. Vous exécutez une application Java et capturez les instructions SQL dans un fichier pureQueryXML.

Avant de commencer

Assurez-vous que votre environnement répond aux exigences suivantes :
  • Le support pureQuery doit être activé pour votre projet Java.
  • Vous devez avoir une base de données DB2 avec la base de données SAMPLE installée.
  • Les propriétés de connexion à la base de données pour votre projet doivent spécifier une connexion à la base de données SAMPLE et IBM Data Server Driver for JDBC and SQLJ doit se trouver dans le chemin de génération du projet.
Dans cette leçon, vous réaliserez les tâches suivantes :

Pour capturer les instructions SQL à l'aide de l'optimisation client pureQuery :

  1. Le cas échéant, activez la connexion à la base de données SAMPLE.

    Dans l'Explorateur de sources de données, sélectionnez Connexions à la base de données\SAMPLE, cliquez avec le bouton droit de la souris et sélectionnez Connecter. Si Propriétés apparaît, saisissez les éventuelles informations de connexion, puis cliquez sur OK.

  2. Activez l'optimisation client pureQuery pour le projet.
    1. Cliquez avec le bouton droit de la souris sur le projet dans l'explorateur de packages et sélectionnez Propriétés.
    2. Dans la fenêtre Propriétés, ouvrez la page pureQuery en cliquant sur le noeud pureQuery.
    3. Sous Optimisation client, sélectionnez Activer la capture et la liaison SQL pour les applications JDBC. Cliquez sur OK.
    Le fichier de propriétés pureQuery Runtime pdq.properties est créé dans le dossier src du projet avec les paramètres de propriétés pureQuery Runtime suivants :
    pdq.captureMode=ON
    pdq.executionMode=DYNAMIC
    pdq.pureQueryXml=dataAccessFolder/capture.pdqxml

    Lorsque ces paramètres sont activés, pureQuery Runtime capture les instructions SQL émises par votre application et stocke les données SQL capturées dans le fichier pureQueryXML dataAccessFolder/capture.pdqxml.

    Dans le dossier du projet dataAccessFolder, le fichier de propriétés de configuration pureQuery Default.genProps est mis à jour avec les informations d'option suivantes : -rootPkgName :
    C:\test\pq-tutorial\dataAccessFolder\capture.pdqxml= -rootPkgName pq-tut
    Les informations d'option -rootPkgName sont utilisées par le plan de travail pour configurer le fichier pureQueryXML. La configuration du fichier pureQueryXML est une étape du processus de configuration de pureQuery Runtime pour l'exécution statique des instructions SQL sur une base de données DB2.
  3. Exécutez l'application et capturez les données XML.
    1. Dans l'Explorateur de packages, cliquez avec le bouton droit de la souris sur le fichier MySample.java, puis cliquez sur Exécuter en tant que > Application Java.
    2. Dans l'Explorateur de packages, cliquez avec le bouton droit de la souris sur le dossier pq-tutorial\dataAccessFolder et sélectionnez Actualiser.

    Le fichier pureQueryXML apparaît dans le dossier dataAccessFolder. Le fichier contient les informations SQL capturées par pureQuery Runtime.

  4. Capturez une autre instruction SQL dans l'application.
    1. Dans votre code source, modifiez la valeur qui détermine l'instruction SQL par défaut à exécuter.

      Modifiez la valeur de la variable i en la faisant passer de 0 à 1 dans le code suivant :

         if ( args.length == 0) {
         // value for the default SQL statement to run
            i = 1 ;
    2. Sauvegardez le fichier.
    3. Exécutez l'application pour capturer l'instruction SQL.

      Dans l'Explorateur de packages, cliquez avec le bouton droit de la souris sur le fichier MySample.java, puis sélectionnez Exécuter en tant que > Application Java.

      L'application s'exécute et pureQuery Runtime capture les informations SQL depuis l'application. La sortie apparaît dans la fenêtre Console. La sortie est similaire à l'exemple suivant :
      =======
      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. Affichez le fichier pureQueryXML qui contient les instructions SQL que vous avez capturées.
    1. Dans l'Explorateur de packages, accédez au dossier dataAccessFolder.
    2. Actualisez le dossier dataAccessFolder pour afficher le fichier capture.pqdxml.
    3. Cliquez deux fois sur le fichier capture.pqdxml pour l'ouvrir dans l'éditeur pureQueryXML.

    L'éditeur pureQueryXML affiche le fichier pureQueryXML.

  6. Développez l'ensemble d'instructions pour afficher les deux instructions SQL capturées par pureQuery Runtime.

    Lorsque vous sélectionnez l'instruction SQL, vous pouvez visualiser les données SQL capturées telles que le nom du schéma, le chemin d'accès actuel et le mode d'arrondi DECFLOAT.

    L'illustration suivante présente un fichier pureQueryXML contenant un seul ensemble d'instructions SQL avec deux instructions SQL.

    Figure 1. Fichier pureQueryXML capture.pdqxml dans l'Editeur pureQueryXML
    Fichier capture.pdqxml affiché dans l'éditeur pureQueryXML.

    La figure précédente illustre un fichier pureQueryXML configuré par le plan de travail. Dans le cadre du processus de configuration pureQueryXML, l'ensemble d'instructions est nommé pq-tutA. Les noms d'ensembles d'instructions sont basés sur la chaîne pq-tut, la valeur de l'option -rootPkgName dans le fichier Default.genProps.

    Vous pouvez gérer les instructions SQL dans le fichier pureQueryXML à l'aide de l'éditeur pureQueryXML. Vous pouvez effectuer différentes actions, par exemple renommer un ensemble d'instructions, exécuter une instruction SQL et ajouter une instruction alternative pour une instruction SQL capturée.

  7. Exécutez une instruction SQL à partir de l'éditeur pureQueryXML.

    Dans l'éditeur pureQueryXML, cliquez avec le bouton droit de la souris sur la première instruction SQL, puis sélectionnez Exécuter SQL.

    Le plan de travail exécute l'instruction SQL. La fenêtre Résultats SQL s'ouvre et affiche les résultats.

    Lors de l'exécution de l'instruction SQL à partir de l'éditeur, le plan de travail utilise la connexion définie pour le projet. Lorsque vous exécutez l'application, celle-ci utilise la connexion définie dans l'application.

  8. Fermez l'éditeur pureQueryXML.

    Cliquez sur X dans l'onglet capture.pdqxml.

Point de contrôle de la leçon

Vous avez configuré le support pureQuery dans votre projet Java pour activer la capture et la liaison de données SQL à partir de l'application. Vous avez exécuté l'application et capturé les données SQL à partir de l'application.
Depuis le plan de travail, vous avez effectué les tâches suivantes :
  • Configuré le support pureQuery avec les propriétés du projet.
  • Exécuté une application Java à partir du plan de travail.
  • Visualisé les données SQL que vous avez capturées dans l'éditeur pureQueryXML.
< Précédent | Suivant >

Commentaires