< Précédent | Suivant >

Leçon 3 : Configuration de pureQuery Runtime pour exécuter les instructions SQL en mode statique

Une fois que vous capturez des instructions SQL à partir d'une application activée avec l'optimisation client pureQuery, vous configurez pureQuery Runtime pour exécuter les instructions SQL en mode statique sur une base de données DB2.

Avant de commencer

Vous devez disposer d'une connexion active à la base de données SAMPLE. Si vous ne disposez pas d'une connexion active, le plan de travail vous invite à établir une connexion lorsque vous effectuez l'opération de liaison.

Le fichier pureQueryXML que vous avez créé dans la leçon précédente contient un seul ensemble d'instructions. Si vous effectuez le processus de liaison avec le fichier, vous créez un seul ensemble de packages sur la base de données cible. Dans cette leçon, vous mettez à jour le nom de l'ensemble d'instructions dans le fichier pureQueryXML. Vous créez ensuite un ensemble unique de packages à partir du fichier pureQueryXML et vous liez ces packages.

Une fois le processus de liaison terminé sur la base de données cible, vous définissez les propriétés de pureQuery Runtime pour spécifier que pureQuery exécutera les instructions émises par l'application en mode statique.

Lorsque vous mettez à jour le fichier pureQueryXML, le plan de travail configure le fichier pureQueryXML au besoin. Le processus de configuration gère les instructions SQL dans le fichier pureQueryXML et ajoute les informations nécessaires au processus de liaison. Le plan de travail utilise les options définies dans le fichier Default.genProps pour configurer le fichier pureQueryXML capture.pdqxml.

Mise à jour du fichier pureQueryXML et exécution du processus de liaison avec le fichier

Utilisez le plan de travail pour mettre à jour le fichier pureQueryXML qui contient les instructions SQL capturées. Liez ensuite les instructions SQL dans le fichier en exécutant l'utilitaire StaticBinder.

Pour mettre à jour le fichier pureQueryXML et lier les instructions SQL dans le fichier :

  1. Dans la vue Explorateur de packages, cliquez deux fois sur le fichier pureQueryFolder\Default.genProps dans le projet Java pq-tutorial.
  2. Modifiez la valeur de l'option -rootPkgName en la remplaçant par aatest
    C:\test\pq-tutorial\pureQueryFolder\capture.pdqxml= -rootPkgName aatest

    L'option -rootPkgName spécifie la chaîne de base utilisée pour créer des ensembles d'instructions nommés dans le fichier pureQueryXML. Les noms d'ensemble d'instructions dans le fichier pureQueryXML sont les chaînes de base pour les noms des packages créés dans la base de données cible.

  3. Sauvegardez le fichier. Cliquez sur Oui dans le message qui apparaît pour confirmer la reconstruction du projet.
  4. Configurez le fichier pureQueryXML avec un nouveau nom d'ensemble d'instructions.
    1. Ouvrez le fichier capture.pdqxml dans l'éditeur pureQueryXML.

      Dans l'Explorateur de packages, cliquez deux fois sur le fichier pureQueryFolder\capture.pqdxml pour l'ouvrir dans l'éditeur pureQueryXML.

    2. Supprimez le nom de l'ensemble d'instructions dans le fichier.

      Dans l'éditeur pureQueryXML, mettez en évidence le nom d'instruction pq-tutA et supprimez le texte.

    3. Fermez et sauvegardez le fichier.
    4. Ouvrez à nouveau le fichier.

    Une fois le fichier sauvegardé, le plan de travail a configuré le fichier pureQueryXML. Le processus de configuration a créé un seul ensemble d'instructions nommé aatestA contenant les instructions SQL. Le nom de l'ensemble d'instructions est basé sur aatest, la valeur de l'option -rootPkgName spécifiée dans le fichier Default.genProps.

    Figure 1. Fichier pureQueryXML configuré avec le nom d'ensemble d'instructions aatestA
    Fichier capture.pdqxml configuré dans l'éditeur pureQueryXML.
  5. Liez les instructions SQL dans le fichier pureQueryXML à la base de données SAMPLE.
    1. Dans la vue Explorateur de packages, cliquez avec le bouton droit de la souris sur le fichier capture.pdqxml et cliquez sur pureQuery > Lier. La boîte de dialogue Sélectionner les connexions s'ouvre.
    2. Sélectionnez la connexion SAMPLE et cliquez sur Terminer.
    Le plan de travail exécute l'utilitaire StaticBinder et envoie la sortie de cet utilitaire dans la vue Console. La sortie est similaire à l'exemple suivant :
    ================================================================================
    
    L'utilitaire StaticBinder commence l'opération de liaison pour le fichier pureQueryXml 
       'C:\test\ODS-tutorial\pq-tutorial\pureQueryFolder\capture.pdqxml'.
    
    Démarrage des options de processus :  
       -url "jdbc:db2://localhost:50000/SAMPLE:retrieveMessagesFromServerOnGetMessage=true;" 
       -username "*****" -password "*****" 
       -pureQueryXml "C:\test\ODS-tutorial\pq-tutorial\pureQueryFolder\capture.pdqxml"
    
    L'utilitaire StaticBinder a lié avec succès le package 'aatestA1' pour le niveau d'isolement 'UR'.
    L'utilitaire StaticBinder a lié avec succès le package 'aatestA2' pour le niveau d'isolement 'CS'.
    L'utilitaire StaticBinder a lié avec succès le package 'aatestA3' pour le niveau d'isolement 'RS'.
    L'utilitaire StaticBinder a lié avec succès le package 'aatestA4' pour le niveau d'isolement 'RR'.
    
    L'opération de liaison s'est terminée avec succès pour
      'C:\test\ODS-tutorial\pq-tutorial\pureQueryFolder\capture.pdqxml'.
    
    ================================================================================
    
    Résultats de l'activité de l'utilitaire StaticBinder :
    
        Nombre d'éléments pour lesquels l'opération de liaison a REUSSI : 1
    
    
    La liaison pour le fichier XML capture.pdqxml à l'aide de la connexion SAMPLE dans le projet pq-tutorial a abouti.

    Le plan de travail a exécuté l'utilitaire pureQuery StaticBinder pour créer un seul ensemble de packages et lier les packages sur la base de données. L'utilitaire pureQuery StaticBinder a créé les packages en fonction des informations figurant dans le fichier capture.pdqxml configuré et les options de liaison StaticBinder par défaut.

    L'ensemble de packages est nommé en fonction du nom de l'ensemble d'instructions dans le fichier pureQueryXML. L'utilitaire StaticBinder a créé quatre packages. Par défaut, StaticBinder crée un package pour chacun des quatre niveaux d'isolement DB2 : UR, CS, RS et RR.

  6. Localisez les packages dans l'Explorateur de sources de données à partir de la vue Structure SQL.
    1. Dans la vue Structure SQL, ouvrez la fenêtre Packages de la base de données en cliquant sur l'onglet Packages de base de données au bas de la vue.
    2. Cliquez avec le bouton droit de la souris sur le nom du package et sélectionnez Rechercher dans l'Explorateur de sources de données.

      L'Explorateur de sources de données s'ouvre et développe les dossiers de la connexion SAMPLE, puis met en évidence les packages.

      Les noms de package sont basés sur aatest, qui est le nom de l'ensemble d'instructions dans le fichier pureQueryXML.

Configuration de pureQuery Runtime pour l'exécution statique des instructions SQL

Mettez à jour les propriétés de pureQuery Runtime pour que votre application exécute les instructions SQL en mode statique.

Pour configurer pureQuery Runtime pour l'exécution statique des instructions SQL :

  1. Dans la vue Explorateur de packages, cliquez deux fois sur le fichier pdq.properties.

    Le fichier s'ouvre dans l'éditeur de propriétés PDQ.

  2. Mettez à jour le fichier de propriétés pureQuery Runtime.
    • Modifiez la valeur de la propriété captureMode en la remplaçant par OFF
    • Ajoutez la propriété capturedOnly avec la valeur TRUE
    • Modifiez la valeur de la propriété executionMode en la remplaçant par STATIC
    Le fichier mis à jour contient les propriétés suivantes :
    pdq.captureMode=OFF
    pdq.capturedOnly=TRUE
    pdq.executionMode=STATIC
    pdq.pureQueryXml=pureQueryFolder/capture.pdqxml
  3. Sauvegardez et fermez le fichier.
  4. Exécutez l'application.

    Cliquez avec le bouton droit de la souris sur le fichier MySample.java et cliquez sur Exécuter en tant que > Application Java.

    L'application s'exécute et renvoie les résultats dans la fenêtre Console.

Test du mappage entre le fichier pureQueryXML et les packages sur la base de données

Lorsque vous modifiez des informations dans le fichier pureQueryXML, le mappage entre les instructions SQL du fichier et les packages de la base de données qui exécute les instructions SQL en mode statique change également. Si le mappage change, vous devez créer de nouveaux packages dans la base de données et lier les packages.

Pour tester le mappage entre le fichier pureQueryXML et les packages de la base de données :

  1. Dans le fichier pureQueryXML, modifiez le nom de l'ensemble d'instructions en remplaçant aatest par aatut
    1. Dans l'Explorateur de packages, cliquez deux fois sur le fichier capture.pdqxml.

      Le fichier s'ouvre dans l'éditeur pureQueryXML.

    2. Dans l'éditeur pureQueryXML, cliquez avec le bouton droit de la souris sur le nom de l'ensemble d'instructions et modifiez son nom en le remplaçant par aatut.
    3. Sauvegardez et fermez le fichier.

      Cliquez sur OK pour confirmer la sauvegarde des changements.

  2. Exécutez l'application.

    Dans la fenêtre Console, l'application renvoie une erreur indiquant qu'un package est introuvable (SQLCODE=-805).

    Les packages sont toujours dans la base de données, mais pureQuery Runtime ne les trouve pas car le nom de l'ensemble d'instructions dans le fichier pureQueryXML a changé. pureQuery Runtime utilise le nom de l'ensemble d'instructions pour déterminer le nom du package.

  3. Liez les instructions SQL dans le fichier pureQueryXML mis à jour.
    1. Cliquez avec le bouton droit de la souris sur le fichier capture.pdqxml et cliquez sur pureQuery > Lier.
    2. Dans la boîte de dialogue Sélectionner les connexions, sélectionnez la base de données SAMPLE et cliquez sur Terminer.

    Les informations de liaison apparaissent dans la fenêtre Console.

    L'utilitaire StaticBinder utilise le nom mis à jour de l'ensemble d'instructions dans le fichier pureQueryXML pour créer des packages dans la base de données. Les packages que vous avez créés au préalable en fonction du nom de l'instruction aatestA ne sont pas abandonnés.

  4. Exécutez l'application.

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

    L'application s'exécute et renvoie les résultats dans la fenêtre Console.

Point de contrôle de la leçon

Depuis le plan de travail, vous avez configuré une application activée avec l'optimisation client pureQuery pour exécuter les instructions SQL en mode statique.
Depuis le plan de travail, vous avez effectué les tâches suivantes :
  • Mis à jour un fichier reQueryXML et vérifié que le plan de travail avait configuré le fichier.
  • Exécuté l'utilitaire StaticBinder à partir du plan de travail pour créer des packages et lier les packages à une base de données.
  • Affiché le fichier pureQueryXML dans l'éditeur pureQueryXML.
  • Défini les propriétés de pureQuery Runtime pour exécuter les instructions SQL émises par l'application en mode statique.
  • Trouvé les packages dans une base de données DB2.
  • Mis à jour le fichier pureQueryXML et lié à nouveau les instructions SQL sur la base de données.
< Précédent | Suivant >

Commentaires