Exemples de commandes ManageRepository

Utilisez l'utilitaire ManageRepository pour vous connecter à une base de données et créer un référentiel dans lequel stocker les informations de configuration pureQuery et les données du fichier pureQueryXML. Le référentiel peut également être utilisé pour stocker des données SQL capturées lors de l'utilisation de l'optimisation client pureQuery.

L'utilitaire ManageRepository permet de créer un référentiel dans une base de données prise en charge. Vous pouvez également utiliser ManageRepository ou le plan de travail pour gérer un référentiel.

Exemples

Dans les exemples suivants, un référentiel est créé :
java com.ibm.pdq.tools.ManageRepository 
  -create repository
  -repositoryType pureQueryOnly
  -repositoryURL jdbc:db2://test.user.com:17593/SAMPLE 
  -repositoryUsername testid 
  -repositoryPassword testpwd 
  -repositoryDriverClass com.ibm.db2.jcc.DB2Driver
Remarque : Les options de connexion repositoryURL, repositoryUsername, repositoryPassword et repositoryDriverClass sont indispensables pour se connecter à la base de données. Dans certains des exemples suivants, le jeu d'options de connexion est abrégé en <connection options> pour plus de clarté.

Dans l'exemple suivant, un script DDL qui peut être utilisé pour créer un référentiel est généré. Le référentiel n'est pas créé.

java com.ibm.pdq.tools.ManageRepository
  -create repository
  -repositoryType pureQueryOnly
  <connection options>
  -generateScriptOnly "c:\create.ddl"

Création d'un référentiel pour ne stocker que les données d'exécution pureQuery

Si le référentiel n'est utilisé que pour stocker le fichier pureQueryXML utilisé par l'optimisation client pureQuery, une version plus compacte et plus simple du référentiel peut être créée. Utilisez l'option -repositoryType avec la valeur pureQueryRuntimeOnly.
java com.ibm.pdq.tools.ManageRepository 
    -create repository
    -repositoryType pureQueryRuntimeOnly
    <connection options>

Création de packages pour accéder au référentiel

Une fois le référentiel créé, pour les plateformes de base de données prenant en charge les instructions SQL statiques, des packages packages de base de données peuvent être créés pour gérer l'accès au référentiel.

Le nom de collection et les noms de package seront choisis par l'utilitaire et ne pourront pas être modifiés par l'utilisateur.
java com.ibm.pdq.tools.ManageRepository
    -bind packages 
    <connection options>
Si l'utilisateur spécifie l'option -generateScriptOnly, l'utilitaire ManageRepository ne crée que le script de commande requis pour lier l'instruction SQL qui gère le référentiel. La liaison n'est pas effectuée.

Mise à jour des données pureQueryXML à l'aide des données SQL capturées

L'exemple suivant suppose que toutes les données pureQuery sont stockées dans un même référentiel : les données pureQuery, le fichier pureQueryXML, le fichier de propriétés pureQuery, les fichiers SQL capturés, les fichiers de configuration utilisés pour la fusion et les fichiers de propriétés requis pour la liaison. La commande suivante permet d'extraire toutes les données dans des fichiers hébergés sur votre système local.
java com.ibm.pdq.tools.ManageRepository 
      -extract runtimeGroup
      -outputDirectory "c:\mergeDir"
      -pureQueryXml "capture.pdqxml"
      -optionsFileForBind "bind.properties"
      -optionsFileForConfigure "gen.properties"
      -pureQueryProperties "pdq.properties"
      -incrementalCapture "testcap"
      -runtimeGroupId "SampleId"
      -runtimeGroupVersion "3.1"
       <connection options>
Les données SQL capturées sont placées dans des fichiers appelés testcap_N.pdqxml, où N est un nombre entier commençant par 1.
Remarque : Pour mettre à jour les données pureQueryXML pour une version de groupe d'exécution, tous les fichiers extraits ne sont pas nécessaires au fonctionnement des utilitaires Merge, Configure et StaticBinder. Cependant, conserver les fichiers pureQuery ensemble sur votre système ou dans un référentiel facilite leur gestion.

La commande suivante supprime les données SQL capturées de la version de groupe d'exécution après avoir comparé les instructions SQL capturées aux données SQL capturées dans les fichiers pour s'assurer que les instructions SQL capturées dans le référentiel n'ont pas été modifiées.

java com.ibm.pdq.tools.ManageRepository 
    -delete incremental
    -inputDirectory "c:\mergeDir"
    -runtimeGroupId "SampleId"
    -runtimeGroupVersion "3.1"
    -incrementalCapture "testcap"
    <connection options>
Une fois les informations de configuration mises à jour et les opérations de fusion, configuration et liaison effectuées, utilisez l'option ManageRepository -update runtimeGroup pour télécharger les informations pureQuery dans un référentiel. Dans l'exemple suivant, l'ID version a été modifié pour créer une nouvelle version des données de groupe d'exécution.
java com.ibm.pdq.tools.ManageRepository 
      -update runtimeGroup
      -inputDirectory "c:\mergeDir"
      -pureQueryXML "capture.pdqxml"
      -bindProps "bind.properties"
      -genProps  "gen.properties"
      -pdqProperties "pdq.properties"
      -runtimeGroupId "SampleId"
      -version "3.2"
       <connection options>

Activation d'une version de groupe d'exécution

La commande suivante active la nouvelle version de groupe d'exécution.
java com.ibm.pdq.tools.ManageRepository 
    -activate runtimeGroup
    -runtimeGroupId "SampleId"
    -runtimeGroupVersion "3.2"
    <connection options>

Définition d'une connexion à un référentiel distinct contenant les données SQL capturées

Les données SQL capturées à partir d'une application avec l'optimisation client pureQuery peuvent être stockées dans un référentiel autre que celui contenant les données pureQueryXML. Vous pouvez spécifier les deux référentiels et extraire les données SQL capturées à l'extraction des données pureQueryXML.

La commande ManageRepository suivante utilise l'option extract et deux ensembles d'options de connexion, les propriétés repository* et les propriétés incrementalRepository*. Les options de connexion repository* définissent une connexion au référentiel contenant les données pureQueryXML. Les propriétés incrementalRepository* définissent une connexion au référentiel contenant les données SQL capturées. La commande utilise la version de groupe d'exécution spécifiée par les options runtimeGroupId et version à l'extraction des données pureQuery et des données SQL capturées. Les données pureQuery se trouvent dans le référentiel indiqué par les options de connexion repository* et les données SQL capturées dans le référentiel spécifié par les options de connexion incrementalRepository*.
java com.ibm.pdq.tools.ManageRepository 
      -extract runtimeGroup
      -outputDirectory "c:\mergeDir"
      -pureQueryXML "capture.pdqxml"
      -bindProps "bind.properties"
      -genProps  "gen.properties"
      -pdqProperties "pdq.properties"
      -incrementalCapture "testcap"
      -runtimeGroupId "SampleId"
      -version "3.1"

      -repositoryURL jdbc:db2://test.user.com:17593/SAMPLE 
      -repositoryUsername testid 
      -repositoryPassword testpwd 
      -repositoryDriverClass com.ibm.db2.jcc.DB2Driver

      -incrementalRepositoryURL=jdbc:db2://test.capture.com:18588/CAPTURE 
      -incrementalRepositoryUsername=testsqlcap
      -incrementalRepositoryPassword=testsqlcappwd
      -incrementalRepositoryDriverClass=ccom.ibm.db2.jcc.DB2Driver
      -incrementalRepositorySchema=PQCAPTURE
Remarque : Les options de connexion incrementalRepository ne sont utilisées qu'avec l'option -extract runtimeGroup pour extraire les données SQL capturées à partir du référentiel.

Comparez deux fichiers pureQueryXML

La commande suivante compare deux fichiers pureQueryXML et stocke le rapport dans le fichier c:\pureQuery\testEnv\pdqChanges\demo.html.
java com.ibm.pdq.tools.ManageRepository
    -report pureQueryXMLChanges 
    -oldPureQueryXml c:\pureQuery\testEnv\pdqArtifacts\demo.pdqxml.org 
    -newPureQueryXml c:\pureQuery\testEnv\pdqArtifacts\demo.pdqxml
    -file c:\pureQuery\testEnv\pdqChanges\demo.html
    -repositoryURL jdbc:db2://test.user.com:17593/SAMPLE 
    -repositoryUsername testid 
    -repositoryPassword testpwd
    -repositoryDriverClass com.ibm.db2.jcc.DB2Driver 
Une connexion à une base de données est obligatoire.

Commentaires