Scénario : Configuration du fichier pureQueryXML et liaison des instructions SQL dans le fichier

Le fichier pureQueryXML que vous avez créé à l'aide de l'utilitaire Merge pureQuery contient des instructions SQL qui sont capturées à partir de l'application WebSphere. Vous vous servez de l'utilitaire Configure pureQuery pour spécifier les caractéristiques des packages DB2 dans le fichier pureQueryXML. Vous employez l'utilitaire StaticBinder pour créer des packages DB2 à partir des instructions SQL et d'autres informations du fichier pureQueryXML et vous liez les packages à la base de données de transactions.

Pourquoi et quand exécuter cette tâche

Une fonction importe de l'utilitaire Configure consiste à regrouper les instructions SQL dans le fichier pureQueryXML en ensembles d'instructions nommés. Le nom des ensembles d'instructions est basé sur la valeur de l'option -rootPkgName et les regroupements sont basés sur les options de configuration que vous indiquez.

Avec l'utilitaire pureQuery StaticBinder, vous créez des packages qui contiennent des instructions SQL et vous liez ces packages à la base de données. Dans l'environnement de scénario, vous créez des packages sur la base de données de test qui utilise le qualificatif TEST. L'utilitaire StaticBinder crée les packages à partir des ensembles d'instructions qui sont définis dans le fichier pureQueryXML.

Procédure

Pour configurer le fichier pureQueryXML et lier les instructions SQL dans le fichier :

  1. Configurez le fichier pureQueryXML qui contient les données SQL capturées.
    Pour utiliser l'utilitaire Configure sur le fichier pureQueryXML testApp.pdqxml, exécutez la commande suivante :
    java com.ibm.pdq.tools.Configure 
      -rootPkgName testApp 
      -cleanConfigure TRUE
      -pureQueryXml testApp.pdqxml 
      –validateXml TRUE 

    L'option -cleanConfigure TRUE indique que l'utilitaire Configure doit configurer le fichier dans son intégralité. Si vous configurez un fichier pureQueryXML qui a été précédemment configuré, vous pouvez utiliser l'option -cleanConfigure FALSE. L'utilitaire Configure tente de préserver le contenu des ensembles d'instructions existants, préalablement configurés et liés dans le fichier pureQueryXML.

    L'option -validateXml spécifie que l'utilitaire Configure effectue la validation de schéma XML pour vérifier que le fichier pureQueryXML est conforme au schéma pureQueryXML XML. L'utilitaire Configure affiche toutes les erreurs de syntaxe XML qui se trouvent dans le fichier pureQueryXML.

    Conseil : Par défaut, l'utilitaire Configure utilise l'ID de collecte NULLID. Si vous souhaitez qu'il utilise une collecte différente, vous pouvez indiquer la collecte à l'aide de l'option -collection.
  2. Liez les instructions SQL dans le fichier pureQueryXML.
    Pour ce scénario, l'application s'exécute dans l'environnement de test et les instructions SQL ont été capturées dans l'environnement de test. Pour lier les instructions SQL capturées dans l'environnement de test, exécutez l'utilitaire pureQuery StaticBinder à l'aide de l'option -bindOptions "QUALIFIER TEST" afin de lier les instructions de test dans la base de données de test.
    java com.ibm.pdq.tools.StaticBinder –url "jdbc:db2://testserver.test.com:32706/sample retrieveMessagesFromServerOnGetMessage=1;"
      -username "myuser" -password "mypwd"
      -isolationLevel CS 
      -bindOptions "QUALIFIER TEST"  
      -pureQueryXml testApp.pdqxml -showDetails TRUE

    L'utilitaire StaticBinder lie les packages à un emplacement de connexion indiqué dans le fichier pureQueryXml.

    L'option StaticBinder -isolationLevel CS spécifie que StaticBinder crée un seul package avec un niveau d'isolement de lecture non reproductible. Le niveau d'isolement de lecture non reproductible est le niveau par défaut des bases de données DB2 for Linux, UNIX et Windows.

    Conseil : Lorsque vous migrez une application d'un environnement de test vers un environnement de production, l'environnement de production peut utiliser des schémas différents de ceux de l'environnement de test. Si les schémas sont différents, veillez à indiquer l'option de liaison QUALIFIER appropriée. Dans ce scénario, le schéma de l'environnement de test est TEST et le schéma de l'environnement de production est PROD. Pour l'environnement de production, vous devez indiquer l'option de liaison -bindOptions "QUALIFIER PROD" de l'utilitaire StaticBinder pour créer des packages dans la base de données de production.

    Le résultat de la commande est similaire à l'exemple suivant :

    IBM Optim pureQuery Runtime 2.2.0.3 build 2.18.118
    Licensed Materials - Property of IBM
    5724-U16
    (c) Copyright IBM Corp. 2006, 2010 All Rights Reserved.
    
    ================================================================================
    
    L'utilitaire StaticBinder commence l'opération de liaison pour le 
    fichier pureQueryXml 'C:\test\pureQuery-test\zz-merged.pdqxml'.
    
    Début de traitement des options :  -url
    "jdbc:db2://testserver.test.com:32706/sample
    " -username "*****" -password "*****" 
    -pureQueryXml "testApp.pdqxml"
    -isolationLevel "CS" 
    -bindOptions "QUALIFIER TEST" -showDetails "true"
    
    L'utilitaire StaticBinder a lié avec succès le package 'TESTAPP' 
    pour le niveau d'isolement 'CS'.
    
    Nombre d'instructions en entrée : '8', nombre d'instructions liées : '8', 
    options de liaison : 'ISOLATION CS QUALIFIER TEST'
    
    L'opération de liaison s'est terminée avec succès pour 'testApp.pdqxml'.
        Nombre de packages en entrée :'1'
        Nombre de packages en entrée pour lesquels isBindable est faux : '0'
        Nombre de packages en entrée dont aucune instruction ne peut être liée : '0'
        Nombre de packages en entrée pouvant être liés, traités par l'utilitaire Static Binder : '1' : [TESTAPP]
    
    ================================================================================
    
    Résultats de l'activité de l'utilitaire StaticBinder :
    
    Nombre des éléments pour lesquels l'opération de liaison a REUSSI : 1

Que faire ensuite

Dans la tâche suivante, vous mettez à jour le référentiel à l'aide du fichier pureQueryXML et des propriétés d'exécution pureQuery qui permettent à l'application d'exécuter des instructions SQL de façon statique.


Commentaires