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 :
- La prise en charge de pureQuery doit être activée 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 :
- Activation de l'optimisation client pureQuery pour le projet.
- Capture de données SQL pour l'application simple.
Pour capturer les instructions SQL à l'aide de l'optimisation client pureQuery :
- Le cas échéant, activez la connexion à la base de données SAMPLE.
Dans l'Explorateur de source 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.
- Activez l'optimisation client pureQuery pour le projet.
- Cliquez avec le bouton droit de la souris sur le projet et sélectionnez Propriétés.
- Dans la fenêtre Propriétés, ouvrez la page pureQuery en cliquant sur le noeud pureQuery.
- Sous Optimisation client, activez SQL capturing and binding for SQL applications (Capture et liaison SQL pour les applications SQLp. 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=pureQueryFolder/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 pureQueryFolder/capture.pdqxml.
Dans le dossier du projet
pureQueryFolder, 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\pureQueryFolder\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.
- Exécutez l'application et capturez les données XML.
- Dans l'Explorateur de package, cliquez avec le bouton droit de la souris sur le fichier MySample.java, puis cliquez sur .
- Dans l'Explorateur de package, cliquez avec le bouton droit de la souris sur le dossier pq-tutorial\pureQueryFolder et sélectionnez Régénérer.
Le fichier pureQueryXML apparaît dans le dossier pureQueryFolder.
Le fichier contient les informations SQL capturées par pureQuery Runtime.
- Capturez une autre instruction SQL dans l'application.
- 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 ;
- Sauvegardez le fichier.
- Exécutez l'application pour capturer l'instruction SQL.
Dans l'Explorateur de package, cliquez avec le bouton droit de la souris sur le fichier MySample.java, puis sélectionnez .
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 Optim pureQuery Runtime 2.2.1.0 build 2.25.63
=======
case 1
case 1 - non-systems employees: 24
Finished case 1
- Affichez le fichier pureQueryXML qui contient les instructions SQL que vous avez capturées.
- Dans l'Explorateur de package, accédez au dossier pureQueryFolder.
- Régénérez le dossier pureQueryFolder pour afficher le fichier capture.pqdxml.
- Cliquez deux fois sur le fichier capture.pqdxml pour l'ouvrir dans l'éditeur pureQueryXML.
L'éditeur pureQueryXML affiche le fichier pureQueryXML.
- 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 avec un seul ensemble d'instructions SQL contenant deux instructions SQL.
Figure 1. Le fichier pureQueryXML capture.pdqxml
dans l'Editeur 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.
- 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.
- Fermez l'éditeur pureQueryXML.
Cliquez sur X dans l'onglet capture.pdqxml.