Utilitaire ManageRepository

L'utilitaire ManageRepository permet de créer un référentiel dans une base de données et de le gérer. Le référentiel contient des données pureQuery utilisées par des applications activées avec pureQuery, notamment des informations de configuration et des données pureQueryXML. Le référentiel peut stocker des données SQL capturées à partir d'applications activées avec l'optimisation client pureQuery.

Une base de données prenant en charge l'installation d'un référentiel doit être disponible et l'application doit être configurée pour utiliser l'optimisation client pureQuery. Voir Configuration requise pour Optim pureQuery Runtime for pureQuery.

Les sections suivantes décrivent l'utilitaire ManageRepository :

Pour comprendre les conventions utilisées dans le diagramme, voir Lecture des diagrammes de syntaxe.

Opérations de niveau référentiel

Les opérations de niveau référentiel assurées par ManageRepository incluent la création et la suppression d'un référentiel dans une base de données, la vérification de la validité du référentiel et l'affichage de la version du référentiel.

Pour afficher les instructions SQL requises pour créer, supprimer ou lier un référentiel, utilisez l'option -generateScriptOnly. Les instructions sont générées sans pour autant exécuter les opérations correspondantes. Si vous modifiez les instructions SQL et que vous les émettez, vous pouvez utiliser l'option -verify repository pour vérifier le référentiel.

Pour créer un référentiel contenant uniquement les informations des fichiers pureQuery utilisés pour l'optimisation client pureQuery, indiquez l'option -repositoryType avec le paramètre -pureQueryRuntimeOnly. Le référentiel ne stocke pas les données SQL capturées.

Syntaxe de la commande ManageRepository pour les opérations de niveau référentiel

Lire le diagrammeSauter le diagramme
    (1)                                             
>>-------java--com.ibm.pdq.tools.ManageRepository--------------->

>--+- -create repository-- -repositoryType--+-pureQueryOnly--------+-+-->
   |                                        '-pureQueryRuntimeOnly-' |   
   |  (2)                                                            |   
   +------- -bind packages-------------------------------------------+   
   +- -verify repository---------------------------------------------+   
   +- -report--+-repositoryData-- -file--file-name-+-----------------+   
   |           '-repositoryVersion-----------------'                 |   
   '- -delete repository--+--------------------+---------------------'   
                          |          .-FALSE-. |                         
                          '- -force--+-TRUE--+-'                         

>--| connection information |----------------------------------->

>--+---------------------------------------------------+-------->
   |  (3)                                              |   
   '------- -generateScriptOnly--chemin-fichier-script-'   

>--+--------+--------------------------------------------------><
   '- -help-'   

connection information

|-- -repositoryURL--URL-base de données-référentiel------------->

>-- -repositoryUsername--ID-utilisateur-- -repositoryPassword--mot de passe-->

>-- -repositoryDriverClass--classe de pilote--------------------|

Remarques:
  1. Vous pouvez spécifier les options dans n'importe quel ordre.
  2. L'option -bind packages ne peut être utilisées qu'avec une base de données prenant en charge les instructions SQL statiques.
  3. L'option -generateScriptOnly ne peut pas être utilisée avec l'option -report.

Description des options relatives aux opérations de niveau référentiel

La liste suivante décrit les options et variables ManageRepository prises en charge.

-create repository
L'utilitaire ManageRepository utilise les informations de connexion pour déterminer le type de plateforme de base de données et émettre les instructions DDL appropriées afin de créer les tables dans le schéma spécifié.

Un message indiquant que les données seront remplacées par cette commande s'affiche. L'utilisateur peut alors choisir d'annuler l'action.

-repositoryType
Permet de spécifier le type de référentiel à créer. Les types de référentiel suivants sont pris en charge :
  • pureQueryOnly. Valeur par défaut. Le référentiel contient des informations provenant de fichiers pureQuery utilisés par les options d'optimisation client pureQuery, les options de liaison et de génération de données SQL capturées pureQuery, ainsi que des données pureQueryXML.
  • pureQueryRuntimeOnly Le référentiel ne contient que des informations provenant de fichiers pureQuery utilisés par l'optimisation client pureQuery.

Utilisez l'option -generateScriptOnly pour générer un script SQL avec les instructions SQL permettant de créer un référentiel, sans créer de référentiel. Après avoir passé le script en revue, vous pour l'exécuter pour créer le référentiel. Si vous modifiez les instructions SQL et exécutez le script, vous pouvez utiliser l'option -verify repository pour vérifier le référentiel.

-bind packages
Sur les plateformes de base de données prenant en charge les instructions SQL statiques, indique que des packages de base de données sont créés pour gérer l'accès au référentiel. Le nom de collection et les noms de package sont choisis par l'utilitaire et ne peuvent pas être modifiés par l'utilisateur.

Une fois le référentiel créé, les options -grant et -revoke de l'utilitaire ManageRepository sont utilisées pour accorder des privilèges à ces packages et en révoquer. Pour plus d'informations sur l'accès aux packages, voir Opérations de gestion des privilèges des groupes d'exécution

Utilisez l'option -generateScriptOnly uniquement pour générer un script, sans exécuter d'opération de définition des accès.

-report repositoryData | repositoryVersion
Affiche des informations sur le référentiel.
repositoryData -file nom-fichier
Génère un rapport HTML décrivant les informations de groupe d'exécution dans le référentiel. nom-fichier est le chemin et le nom du fichier qui contiendra le rapport.
repositoryVersion
Affiche la version du référentiel.
-verify repository
Vérifie les tables dans le référentiel pour s'assurer que les tables ont été correctement créées, avec les colonnes et types de colonne prévus. Des tests sont également réalisées pour vérifier que les droits d'accès en lecture et en écriture au référentiel sont corrects et donc s'assurer que l'ID utilisateur en charge de l'exécution dispose des autorisations appropriées.

Entre autres données, des information relatives aux différents composants dans le référentiel et des messages indiquant des problèmes avec le référentiel, notamment les autorisations incorrectes ou les tables pour lesquelles il manque des colonnes, sont retournés.

Utilisez l'option -generateScriptOnly pour générer un script SQL, sans vérifier le référentiel.

-delete repository
Supprime toutes les tables utilisées par le référentiel. Toutes les données dans le référentiel sont supprimées.
Un message demandant à l'utilisateur de confirmer la suppression des tables de base de données s'affiche.
-force TRUE|FALSE
Valeur booléenne permettant de confirmer la suppression du référentiel.

Utilisez -force TRUE pour confirmer la suppression, sans qu'aucun message ne s'affiche.

Utilisez l'option -generateScriptOnly pour générer un script SQL, sans supprimer le référentiel.

-generateScriptOnly chemin-fichier-script
Génère un script SQL avec les instructions SQL permettant d'exécuter l'opération ManageRepository, sans exécuter l'opération. Vous devez indiquer les informations de connexion à la base de données du référentiel.

Vous pouvez modifier le script de création d'un référentiel pour changer certains noms d'objet. Cependant, vous ne pouvez pas modifier le nom du schéma, le nom des tables ou des colonnes. Pour plus d'informations sur l'utilisation de scripts ManageRepository, voir Remarques sur l'utilisation.

Après avoir passé en revue et modifié le script, un administrateur de base de données peut créer le référentiel en exécutant le script. Par exemple, l'administrateur de base de données peut ajouter un espace de table aux instructions SQL dans le script.

Une fois le référentiel créé, l'option -verify repository peut être utilisée pour vérifier le référentiel.

Pour l'option -bind packages, le nom de collection et les noms de package sont choisis par l'utilitaire et ne peuvent pas être modifiés par l'utilisateur.

-help
Affiche un récapitulatif des informations d'utilisation.

Description des options relatives aux informations de connexion

La liste suivante décrit les informations requises pour se connecter à la base de données d'un référentiel :

-repositoryURL URL-base de données-référentiel
URL de la base de données du référentiel
-repositoryUsername ID-utilisateur -repositoryPassword mot de passe
ID et mot de passe utilisés pour se connecter à la base de données
-repositoryDriverClass classe de pilote
Nom de classe qualifié complet du pilote JDBC à utiliser pour se connecter à la base de données du référentiel.

Opérations de gestion des groupes d'exécution

Les opérations ManageRepository de niveau groupe d'exécution incluent la création, la gestion et la suppression de groupes d'exécution et des versions de groupes dans un référentiel.

Les données pureQuery stockées dans un groupe d'exécution comprennent des informations de configuration pureQuery, des données pureQueryXML et éventuellement des données SQL capturées à partir d'applications activées avec l'optimisation client pureQuery.

Les versions de groupe d'exécution contiennent également d'autres informations utilisées par pureQuery Runtime pour identifier l'exécution et la version active du groupe.

Syntaxe des opérations de gestion de groupes d'exécution

Lire le diagrammeSauter le diagramme
    (1)                                             
>>-------java--com.ibm.pdq.tools.ManageRepository--------------->

>--+- -create runtimeGroup--+--------------------+----------------------------------------------------+-->
   |                        '-| pureQuery data |-'                                                    |   
   +- -update runtimeGroup--+--------------------+----------------------------------------------------+   
   |                        '-| pureQuery data |-'                                                    |   
   +- -delete runtimeGroup--+--------------------+----------------------------------------------------+   
   |                        |          .-FALSE-. |                                                    |   
   |                        '- -force--+-TRUE--+-'                                                    |   
   +- -delete incremental-- -inputDirectory--chemin-répertoire-- -incrementalCapture--préfixe-fichier-+   
   +- -list runtimeGroupVersions----------------------------------------------------------------------+   
   +- -activate runtimeGroup--------------------------------------------------------------------------+   
   +- -deactivate runtimeGroup------------------------------------------------------------------------+   
   '- -copy runtimeGroup--+---------------------------------+-- -targetVersion--version-cible---------'   
                          '- -sourceVersion--version-source-'                                             

>-- -runtimeGroupId--ID groupe---------------------------------->

    (2)                                   
>-------- -runtimeGroupVersion--version------------------------->

>--+---------------------------------+--+--------+-------------->
   '- -contact--informations-contact-'  '- -help-'   

>--| connection information |----------------------------------><

Données pureQuery

    (3)                                        
|-------- -inputDirectory--chemin-répertoire-------------------->

>--+------------------------------------------+----------------->
   '- -pureQueryXml--nom-fichier-pureQueryXML-'   

>--+-----------------------------------------------+------------>
   '- -pureQueryProperties--fichier-prop-exécution-'   

>--+---------------------------------------------+-------------->
   '- -optionsFileForConfigure -fichier-genProps-'   

>--+-----------------------------------------+------------------|
   '- -optionsFileForBind -fichier-bindProps-'   

connection information

|-- -repositoryURL--URL-base de données-référentiel------------->

>-- -repositoryUsername--ID-utilisateur-- -repositoryPassword--mot de passe-->

>-- -repositoryDriverClass--classe de pilote--------------------|

Remarques:
  1. Vous pouvez spécifier les options dans n'importe quel ordre.
  2. L'option -runtimeGroupVersion ne peut pas être définie avec l'option -copy runtimeGroup.
  3. Lors de la mise à jour de données pureQuery, au moins un fichier doit être spécifié.

Description des options relatives aux opérations de gestion de groupes d'exécution

La liste suivante décrit les options et variables ManageRepository prises en charge.

-create runtimeGroup
Permet de créer un groupe d'exécution avec l'ID de groupe et la version indiqués.

Si l'ID de groupe d'exécution existe déjà dans le référentiel, un message d'erreur s'affiche.

Lors de la création d'une version de groupe d'exécution, les paramètres pureQuery suivants correspondent aux paramètres par défaut :
  • La propriété executionMode correspond à DYNAMIC (pour exécuter des instructions SQL dynamiques).
  • La propriété captureMode est définie sur ON (mode de capture de type incrémentiel).

Pour redéfinir les paramètres par défaut et spécifier d'autres propriétés, indiquez les fichiers contenant les propriétés et leurs valeurs.

-update runtimeGroup
Permet de mettre à jour les données contenues dans la version du groupe d'exécution avec les données pureQuery provenant des fichiers spécifiés.
-delete runtimeGroup
Permet de supprimer le l'ID de groupe du groupe d'exécution du référentiel.
Un message demandant à l'utilisateur de confirmer la suppression du groupe d'exécution s'affiche. L'utilisateur peut alors choisir d'annuler l'action.
-force TRUE|FALSE
Indiquez TRUE ou FALSE pour confirmer la suppression du groupe d'exécution. Si vous indiquez TRUE, le groupe d'exécution est supprimé sans confirmation. La valeur par défaut est FALSE.

Utilisez l'option -force TRUE pour confirmer la suppression, sans qu'aucun message ne s'affiche.

-delete incremental
Permet de supprimer les données SQL capturées à partir de la version d'un groupe d'exécution. Les données dans les fichiers SQL capturés spécifiés sont comparées aux données du référentiel et les données SQL capturées du référentiel sont supprimées en cas de correspondance.

Une fois les données SQL capturées fusionnées avec les données pureQueryXML de la version d'un groupe d'exécution, les données SQL capturées pour la version peuvent être supprimées.

-inputDirectory chemin-répertoire
Chemin d'accès complet au répertoire contenant les fichiers SQL capturés.
-incrementalCapture préfixe-fichier
Préfixe utilisé par les fichiers SQL capturés.
-list runtimeGroupVersions
Affiche des informations sur les versions de groupe d'exécution.
-activate runtimeGroup
Permet d'activer une version de groupe d'exécution.

Lorsque pureQuery Runtime accède à un groupe d'exécution dans le référentiel, il utilise les informations pureQuery dans la version de groupe d'exécution active.

-deactivate runtimeGroup
Permet de désactiver un groupe d'exécution.

Lorsque pureQuery Runtime accède à un groupe d'exécution dans le référentiel, il ignore les informations pureQuery dans les groupes d'exécution non actifs.

-copy runtimeGroup
Permet de copier les données du groupe d'exécution de la version spécifiée dans l'option -sourceVersion dans le même groupe dont le nom de version est indiqué par l'option -targetVersion.
-sourceVersion version-source
Indique une version existante du groupe d'exécution utilisé pour créer une nouvelle version de groupe d'exécution.

Si aucune version-source n'est indiquée, la version de groupe d'exécution active est utilisée. Si aucune version-source n'est indiquée et qu'il n'y a pas de version de groupe d'exécution active, un message d'erreur s'affiche.

-targetVersion version-cible
Indique la version de groupe d'exécution créée lors de la copie de la version de groupe d'exécution version-source.
-runtimeGroup ID groupe
Indique l'identifiant du groupe d'exécution du référentiel.
-runtimeGroupVersion version
Indique un nom de version de groupe d'exécution. L'option -runtimeGroupVersion ne peut pas être définie avec l'option -copy runtimeGroup.
-contact informations-contact
Chaîne spécifiant des informations de contact facultatives stockées avec la version de groupe d'exécution.
-help
Affiche un récapitulatif des informations d'utilisation.

Description des options relatives aux données pureQuery

La liste suivantes décrit les options relatives aux données pureQuery :

-inputDirectory chemin-répertoire
Chemin d'accès complet au répertoire contenant les fichiers pureQuery.
-pureQueryXml nom-fichier-pureQueryXML
Nom du fichier pureQueryXML.
-pureQueryProperties nom-fichier-prop-exécution
Nom du fichier de propriétés de pureQuery Runtime.
-optionsFileForConfigure fichier-genProps
Fichier contenant les options utilisées par l'utilitaire Configure.
-optionsFileForBind fichier-bindProps
Fichier contenant les options utilisées par l'utilitaire StaticBinder pour lier des instructions SQL dans le fichier pureQueryXML.

Description des options relatives aux informations de connexion

La liste suivante décrit les informations requises pour se connecter à la base de données d'un référentiel :

-repositoryURL URL-base de données-référentiel
URL de la base de données du référentiel
-repositoryUsername ID-utilisateur -repositoryPassword mot de passe
ID et mot de passe utilisés pour se connecter à la base de données
-repositoryDriverClass classe de pilote
Nom de classe qualifié complet du pilote JDBC à utiliser pour se connecter à la base de données du référentiel.

Opérations de gestion des privilèges des groupes d'exécution

Les opérations de gestion des privilèges sont effectuées une fois les données SQL capturées stockées dans la base de données du référentiel. Un administrateur doit accorder des droits pour les applications pour pouvoir lire et écrire des données dans les tables de la base de données du référentiel.

Syntaxe des opérations de gestion des privilèges

Lire le diagrammeSauter le diagramme
    (1)                                             
>>-------java--com.ibm.pdq.tools.ManageRepository--------------->

>--+- -revoke-+------------------------------------------------->
   '- -grant--'   

                     .-,---------------.           
                     V                 |           
>----"--grantees--(----ID-autorisation-+--) -"------------------>

>-- -privilege--+-tableAccess----------+------------------------>
                |  (2)                 |   
                '-------executePackage-'   

>-- -accessLevel -+-APPLICATION-+--| connection information |--->
                  '-MANAGER-----'                               

>--+--------+--------------------------------------------------->
   '- -help-'   

>--+---------------------------------------------+-------------><
   '- -generateScriptOnly--chemin-fichier-sortie-'   

connection information

|-- -repositoryURL--URL-base de données-référentiel------------->

>-- -repositoryUsername--ID-utilisateur-- -repositoryPassword--mot de passe-->

>-- -repositoryDriverClass--classe de pilote--------------------|

Remarques:
  1. Vous pouvez spécifier les options dans n'importe quel ordre.
  2. Sur les plateformes prenant en charge les instructions SQL statiques, executePackage est la seule option prise en charge après l'émission de -bind packages.

Description des options relatives à la gestion des privilèges du référentiel

La liste suivante décrit les options et variables ManageRepository prises en charge :

-grant
Accorde l'accès spécifié par l'option -privilege aux utilisateurs indiqués dans la liste grantees.
-revoke
Révoque toutes les privilèges relatifs aux tables du référentiel de métadonnées pour les utilisateurs indiqués dans la liste grantees.

Il est inutile de spécifier un rôle pour l'option -revoke.

"grantees(premier_ID, deuxième_ID, ...)"
Mot clé indiquant la liste des utilisateurs de base de données concernés. La clause grantees, le mot clé et la liste des utilisateurs doivent commencer et se terminer par des guillemets ("). Les noms d'utilisateur doivent être séparés par des virgules. Dans l'exemple suivant, trois ID d'autorisation sont spécifiés en tant que titulaires.
"grantees(test1, test2, user1)" 
ID-autorisation
ID utilisateur de base de données auquel des privilèges sont accordés ou pour lequel il sont révoqués.

L'ID PUBLIC peut être indiqué.

L'ID-autorisation doit présenter la même casse que l'ID utilisateur de base de données. Par exemple, si l'ID utilisateur DB2 est en lettres majuscules, l'ID-autorisation doit être saisi en lettres majuscules.

-privilege tableAccess|executePackage
Indique le type de privilège accordé. Les valeurs de privilège suivantes sont prises en charge :
tableAccess
Privilège pour les plateformes ne prenant en charge que les instructions SQL dynamiques. Permet aux applications dynamiques d'accéder aux tables sous-jacentes du référentiel de métadonnées. tableAccess s'applique aux environnements SQL dynamiques exigeant des privilèges sur les tables de référentiel.
executePackage
Privilège pour les plateformes prenant en charge les instructions SQL statiques où l'option -bind packages de ManageRepository a été émise. Permet aux applications d'accéder au référentiel de métadonnées à l'aide des instructions SQL liées de façon statique, créées par l'utilitaire ManageRepository.
-accessLevel MANAGER|APPLICATION
Les valeurs suivantes sont prises en charge pour l'option -accessLevel :
APPLICATION
Un ID utilisateur auquel les droits d'accès APPLICATION ont été accordés peut lire les données pureQueryXML et écrire dans les tables utilisées pour stocker les données SQL capturées.
MANAGER
Les droits d'accès MANAGER permettent d'accéder à toutes les tables du référentiel de métadonnées. Les privilèges sont accordés aux titulaires figurant dans la liste des ID utilisateur.

Si un référentiel Optim Performance Manager est ciblé, seul le niveau d'accès MANAGER est disponible.

-generateScriptOnly chemin-fichier-script
Génère un script SQL avec les instructions SQL permettant d'exécuter l'opération ManageRepository, sans exécuter l'opération.

Après avoir passé en revue et modifié le script, un administrateur de base de données peut créer le référentiel en exécutant le script. Une fois le référentiel créé, l'option -verify repository peut être utilisée pour vérifier le référentiel.

Pour l'option -bind packages, le nom de collection et les noms de package sont choisis par l'utilitaire et ne peuvent pas être modifiés par l'utilisateur.

-help
Affiche un récapitulatif des informations d'utilisation.

Description des options relatives aux informations de connexion

La liste suivante décrit les informations requises pour se connecter à la base de données d'un référentiel :

-repositoryURL URL-base de données-référentiel
URL de la base de données du référentiel
-repositoryUsername ID-utilisateur -repositoryPassword mot de passe
ID et mot de passe utilisés pour se connecter à la base de données
-repositoryDriverClass classe de pilote
Nom de classe qualifié complet du pilote JDBC à utiliser pour se connecter à la base de données du référentiel.

Opérations d'extraction, d'exportation et d'importation

Avec un ensemble de capture incrémentiel, l'optimiseur client pureQuery continue de capturer de nouvelles instructions SQL et d'enregistrer les activités SQL de sorte que les instructions SQL obsolètes puissent être supprimées. Selon les paramètres figurant dans le fichier de propriétés de pureQuery Runtime, les données SQL capturées peuvent être stockées dans le même référentiel que celui dans lequel les données pureQueryXML sont stockées ou dans un référentiel différent. Une fois capturées, les données SQL peuvent être fusionnées avec les données pureQueryXML de sorte qu'un nouveau fichier pureQueryXML puisse être téléchargé. La procédure est composée des étapes suivantes :
  1. Procédez à l'extraction des données incrémentielles.
  2. Utilisez l'utilitaire Merge pour combiner les fichiers SQL capturés au fichier pureQueryXML.
  3. Utilisez l'utilitaire Configure pour configurer le fichier pureQueryXML mis à jour.
  4. Vous pouvez éventuellement utiliser le fichier StaticBind pour créer des packages d'instructions SQL dans une base de données à partir des ensembles d'instructions dans le fichier pureQueryXML file et lier les packages dans une base de données.
  5. Mettez le groupe d'exécution à jour avec les nouvelles données.

Syntaxe des opérations d'exportation, d'extraction et d'importation de données

Lire le diagrammeSauter le diagramme
    (1)                                             
>>-------java--com.ibm.pdq.tools.ManageRepository--------------->

>--+- -export data-- -file--chemin-nom-fichier-zip-+------------>
   +- -extract runtimeGroup--| pureQuery data |----+   
   '- -import data-- -file--chemin-nom-fichier-zip-'   

>-- -runtimeGroupId--ID-groupe---------------------------------->

>-- -runtimeGroupVersion--ID-version---------------------------->

>--| connection information |----------------------------------->

>--+---------------------------------------------------+-------->
   |  (2)                                              |   
   '-------| informations de connexion SQL capturées |-'   

>--+--------+--------------------------------------------------><
   '- -help-'   

Données pureQuery

    (3)                                         
|-------- -outputDirectory--chemin-répertoire------------------->

>--+------------------------------------------+----------------->
   '- -pureQueryXml--nom-fichier-pureQueryXML-'   

>--+-----------------------------------------------+------------>
   '- -pureQueryProperties--fichier-prop-exécution-'   

>--+---------------------------------------------+-------------->
   '- -optionsFileForConfigure -fichier-genProps-'   

>--+-----------------------------------------+------------------>
   '- -optionsFileForBind -fichier-bindProps-'   

>--+-------------------------------+----------------------------|
   '- -incrementalCapture--préfixe-'   

connection information

|-- -repositoryURL--URL-base de données-référentiel------------->

>-- -repositoryUsername--ID-utilisateur-- -repositoryPassword--mot de passe-->

>-- -repositoryDriverClass--classe de pilote--------------------|

informations de connexion SQL capturées

|-- -incrementalRepositoryURL--URL-base de données-référentiel-->

>-- -incrementalRepositoryUsername--ID-utilisateur-- -incrementalRepositoryPassword--mot de passe-->

>-- -incrementalRepositoryDriverClass--classe de pilote---------|

Remarques:
  1. Vous pouvez spécifier les options dans n'importe quel ordre.
  2. A utiliser uniquement avec l'option -extract runtimeGroup. Indiquez les informations requises pour extraire les données SQL capturées si elles résident dans un référentiel distinct de celui contenant les autres données pureQuery.
  3. Lors de la mise à jour de données pureQuery, au moins un fichier doit être spécifié.

Description des options relatives à l'exportation et à l'extraction de données

La liste suivante décrit les options et variables ManageRepository prises en charge :

-export data
Exporte des données pureQuery de toutes les versions d'un groupe d'exécution vers un fichier zip. Ce dernier peut être utilisé comme fichier source lors de l'importation de de données.
-file chemin-nom-fichier-zip
Chemin complet et nom du fichier zip qui contiendra les données pureQuery extraites du groupe d'exécution.
-extract runtimeGroup
Permet d'extraire tout ou partie des données pureQuery de la version spécifiée du groupe d'exécution dans un ou plusieurs fichiers. Le type des données pureQuery est extrait de la version du groupe d'exécution dans le fichier spécifié.
-import data
Permet d'importer des données pureQuery depuis le fichier zip créé lors de l'exportation des données pureQuery d'un référentiel.

Si les données ont été exportées via l'interface utilisateur d'exportation ODS et que plus d'un projet pureQuery a été sélectionné aux fins de l'exportation, seules les données pureQuery du dernier projet sont importées dans le groupe d(exécution spécifié par l'option -runtimeGroupId.

-file chemin-nom-fichier-zip
Indique le chemin et le nom du fichier zip contenant les données exportées. le fichier est utilisé pour exporter des données pureQuery depuis une version d'un groupe d'exécution d'un référentiel ou pour importer des données pureQuery dans une version d'un groupe d'exécution d'un référentiel.
-runtimeGroupId ID groupe
Indique l'identifiant du groupe d'exécution du référentiel.
-runtimeGroupVersion version
Indique l'identifiant de la version du groupe d'exécution.
-help
Affiche un récapitulatif des informations d'utilisation.

Description des options relatives aux données pureQuery

La liste suivantes décrit les options relatives aux données pureQuery :

-outputDirectory chemin-répertoire
Indique le chemin d'accès complet au répertoire contenant les fichiers pureQuery.
-pureQueryXml nom-fichier-pureQueryXML
Indique le nom du fichier pureQueryXML.
-pureQueryProperties nom-fichier-prop-exécution
Indique le nom du fichier de propriétés de pureQuery Runtime.
-optionsFileForConfigure fichier-genProps
Indique le fichier contenant les propriétés pureQuery pour générer les fichiers de saisie SQL.
-optionsFileForBind fichier-bindProps
Indique le fichier contenant les propriétés pureQuery utilisées pour lier des des instructions SQL dans le fichier pureQueryXML.
-incrementalCapture préfixe
Indique le préfixe de fichier utilisé lors de l'exportation de jeux de données SQL capturées dans des fichiers. Les noms de fichier contenant les données SQL capturées extraites sont au format préfixe_N.pdqxml, où N est un nombre entier commençant par 1 et utilisé pour chaque fichier créé lors de l'exportation.
Par exemple, pour l'option -incrementalCapture "testApp", les fichiers suivants peuvent être générés :
testApp_1.pdqxml
testApp_2.pdqxml

Les données SQL capturées peuvent être extraites d'un référentiel différent du référentiel contenant les données pureQueryXML. Indiquez les informations de connexion sur la ligne de commande pour le référentiel contenant la base de données SQL capturée.

Description des options relatives aux informations de connexion

La liste suivante décrit les informations requises pour se connecter à la base de données d'un référentiel :

-repositoryURL URL-base de données-référentiel
Indique l'URL de la base de données du référentiel.
-repositoryUsername ID-utilisateur -repositoryPassword mot de passe
Indique l'ID et le mot de passe pour se connecter à la base de données.
-repositoryDriverClass classe de pilote
Indique le nom de classe qualifié complet du pilote JDBC à utiliser pour se connecter à la base de données du référentiel.

Description des options relatives aux informations de connexion pour les instructions SQL capturées

A utiliser uniquement avec l'option extract runtimeGroup. Lors de l'extraction de données pureQuery, le référentiel contenant les instructions SQL capturées peut être la base de données d'un référentiel distincte de celle contenant les autres données pureQuery. La liste suivante décrit les informations de connexion requises pour se connecter à la base de données d'un référentiel contenant les instructions SQL capturées.

-incrementalRepositoryURL URL-base de données-référentiel
Indique l'URL de la base de données du référentiel.
-incrementalRepositoryUsername ID-utilisateur -incrementalRepositoryPassword mot de passe
Indique l'ID et le mot de passe pour se connecter à la base de données du référentiel.
-incrementalRepositoryDriverClass classe de pilote
Indique le nom de classe qualifié complet du pilote JDBC à utiliser pour se connecter à la base de données du référentiel.

Rapport comparant deux fichiers pureQueryXML

L'option -report pureQueryXMLChanges de ManageRepostiory crée un rapport HTML des différences entre deux fichiers pureQueryXML.

Vous pouvez créer un rapport qui compare deux versions d'un fichier pureQueryXML. Le rapport contient des informations récapitulatives et détaillées des modifications entre les deux fichiers. Ce rapport comprend :
  • Des informations sur les packages ajoutés, supprimés et modifiés notamment l'ID version et l'ID de collecte, l'état de liaison et le nombre d'instructions SQL ajoutées, supprimées et modifiées.
  • Des informations sur les instructions SQL ajoutées, supprimés et modifiés dans les packages notamment le numéro de section, l'heure de dernière exécution de l'instruction et le nombre de fois que l'instruction a été exécutée.

Les fichiers pureQueryXML que l'utilitaire ManageRepository compare doivent se trouver sur votre système de fichiers. Une connexion à une base de données est obligatoire.

Syntaxe dé génération d'un rapport de comparaison de fichiers pureQueryXML

Lire le diagrammeSauter le diagramme
    (1)                                             
>>-------java--com.ibm.pdq.tools.ManageRepository--------------->

>-- -report pureQueryXMLChanges-- -oldPureQueryXml--pureQueryXML-file-- -newPureQueryXml--pureQueryXML-file-- -file--report-file-><

informations de connexion

|-- -repositoryURL--URL-base de données-référentiel------------->

>-- -repositoryUsername--ID-utilisateur-- -repositoryPassword--mot de passe-->

>-- -repositoryDriverClass--classe de pilote--------------------|

Remarques:
  1. Vous pouvez spécifier les options dans n'importe quel ordre.

Description des options permettant de générer un rapport de comparaison entre deux fichiers pureQueryXML

La liste suivante décrit les options et variables ManageRepository qui sont utilisées pour générer le rapport :

-report pureQueryXMLChanges
Génère un rapport HTML de comparaison entre deux fichiers pureQueryXML.
-oldPureQueryXml original-pureQueryXML-file
Spécifie le nom du fichier pureQueryXML d'origine.
-newPureQueryXml updated-pureQueryXML-file
Spécifie le nom du fichier pureQueryXML mis à jour.
-file file-name
Spécifie le nom du fichier qui contiendra le rapport.
-help
Affiche un récapitulatif des informations d'utilisation.

Description des options relatives aux informations de connexion

La liste suivante décrit les informations requises pour se connecter à la base de données d'un référentiel :

-repositoryURL URL-base de données-référentiel
Indique l'URL de la base de données du référentiel.
-repositoryUsername ID-utilisateur -repositoryPassword mot de passe
Indique l'ID et le mot de passe pour se connecter à la base de données.
-repositoryDriverClass classe de pilote
Indique le nom de classe qualifié complet du pilote JDBC à utiliser pour se connecter à la base de données du référentiel.

Remarques sur l'utilisation

Prise en charge par le référentiel des instructions SQL dynamiques et statiques
Les instructions SQL sont utilisées pour accéder à un référentiel et le manipuler. Ces instructions peuvent liées de façon statique à la base de données pour les plateformes prenant en charge les instructions SQL statiques. Les instructions sont émises de façon dynamique pour les autres plateformes.

Pour les plateformes prenant en charge les instructions SQL statiques, l'utilisation des options -grant privilege et -privilege EXECUTEPACKAGE permet aux applications d'accéder aux référentiel de métadonnées à l'aide d'instructions liées de façon statique. Pour les plateformes prenant en charge les instructions SQL statiques, l'utilitaire ManageRepository peut utiliser les packages liés ou émettre des instructions SQL dynamiques après avoir émis -bind packages. S'il n'existe pas de packages liés ou que l'utilisateur ne dispose pas de privilèges d'exécution sur les packages liés, ManageRepository utilise des instructions SQL dynamiques pour accéder aux tables du référentiel.

Pour les plateformes dynamiques, l'utilisation des options -grant privilege et -privilege TABLEACCESS permettent aux applications dynamiques d'accéder aux tables sous-jacentes du référentiel de métadonnées. C'est la seule option disponible pour ces plateformes qui ne prennent pas en charge les instructions SQL statiques.

Prise en charge de ManageRepository pour le référentiel Optim Performance Manager

Optim Performance Manager et Optim Performance Manager Extended Insight peuvent utiliser les données pureQueryXML. L'utilitaire ManageRepository peut télécharger des données pureQueryXML dans un référentiel Optim Performance Manager.

Vous pouvez lancer l'utilitaire ManageRepository pour télécharger uniquement des données pureQueryXML dans un référentiel Optim Performance Manager. Les autres données, telles que les propriétés de pureQuery Runtime, ne peuvent pas être téléchargées.

Vous pouvez lancer l'utilitaire ManageRepository pour créer, mettre à jour, supprimer et répertorier des groupes d'exécution dans un référentiel Optim Performance Manager. Les autres commande de ManageRepository ne sont pas prises en charge.

Bases de données Oracle
Sur les bases de données Oracle, vous devez créer un schéma de référentiel avant de créer le référentiel avec l'option ManageRepository -create repository. Le schéma par défaut est IBMPDQ. Par exemple, l'exécution de la commande suivante Oracle SQL*Plus crée un utilisateur et un schéma nommé IBMPDQ sur une base de données Oracle :
create user IBMPDQ identified by password

Lors de la création d'un référentiel, tout utilisateur dotés des droits d'administration de la base de données peut créer un référentiel.

La commande ManageRepository de l'exemple suivant suppose que l'utilisateur tiger possède des droits d'administration sur la base de données Oracle TEST et que le schéma IBMPDQ est créé sur la base de données :
java com.ibm.pdq.tools.ManageRepository 
  -create repository -repositoryType pureQueryOnly
  -repositoryURL jdbc:db2://test.ora.com:17593/test 
  -repositoryUsername tiger 
  -repositoryPassword testpwd 
  -repositoryDriverClass com.ibm.db2.jcc.DB2Driver
Script ManageRepository pour créer un référentiel
Vous pouvez générer un script de création d'un référentiel en indiquant l'option -generateScriptOnly dans la commande de création d'un référentiel. Vous pouvez personnaliser certains noms d'objet mais d'autres noms d'objet ne peuvent pas être modifiés.

Si vous modifiez les instructions SQL et exécutez le script, vous pouvez utiliser l'option -verify repository pour vérifier le référentiel.

Si vous utilisez un script personnalisé pour créer un référentiel, vous devez supprimer le référentiel avec un script personnalisé. Vous pouvez créer un script de suppression d'un référentiel en indiquant l'option -generateScriptOnly avec la commande de suppression d'un référentiel. Avant d'exécuter le script, modifiez les noms d'objet qui ont été changés dans le script utilisé pour créer un référentiel.

Vous pouvez modifier les noms des éléments suivants dans le script pour créer un référentiel :
  • Le nom de la base de données. Le nom de la base de données est indiqué dans la clause IN des instructions CREATE TABLESPACE.
  • Les noms des espaces table. Les noms d'espace table sont indiqués dans la clause IN des instructions CREATE TABLE.
  • L'ID du groupe de stockage. L'ID du groupe de stockage est indiqué dans la clause USING STOGROUP des instructions CREATE.
  • L'ID du pool de mémoire tampon. L'ID du pool de mémoire tampon est indiqué dans les clauses BUFFERPOOL et INDEXBP.
Vous ne pouvez pas modifier les éléments suivants dans le script pour créer un référentiel :
  • Le nom du schéma IBMPDQ.
  • Les noms de table, les noms de vue et leurs définitions de schéma.
  • Le nom de collection et les noms de package ne peuvent pas être modifiés si vous indiquez l'option -bind packages.
La section ci-dessous présente deux méthodes pour exécuter le script :
  • Exécutez le script à partir d'un fichier script SQL avec l'éditeur SQL et XQuery disponible dans Optim Development Studio. Pour plus d'informations sur l'éditeur SQL et XQuery, voir Utilisation d'instructions SQL.
  • Exécutez le script à partir d'un fichier sur la ligne de commande DB2. Sur la ligne de commande DB2, connectez-vous à la base de données du référentiel et exécutez le script. L'exemple suivant permet de se connecter à la base de données SAMPLE et d'exécuter le script dans le fichier testcreate.sql.
    db2 connect to sample
    db2 -tvf nomfichier

    Pour plus d'informations sur la ligne de commande DB2, voir Command line processor (CLP) dans le centre de documentation DB2.

Exemples

La commande suivante permet d'établir une connexion avec la base de données à l'aide des informations de connexion et de créer un référentiel.
java com.ibm.pdq.tools.ManageRepository 
  -create repository -repositoryType pureQueryOnly
  -repositoryURL jdbc:db2://test.user.com:17593/SAMPLE 
  -repositoryUsername mytestid 
  -repositoryPassword testpwd 
  -repositoryDriverClass com.ibm.db2.jcc.DB2Driver
La commande suivante crée une connexion à la base de données et génère un script SQL qui peut créer un référentiel dans la base de données :
java com.ibm.pdq.tools.ManageRepository 
  -create repository -repositoryType pureQueryOnly
  -repositoryURL jdbc:db2://test.user.com:17593/SAMPLE 
  -repositoryUsername mytestid 
  -repositoryPassword testpwd 
  -repositoryDriverClass com.ibm.db2.jcc.DB2Driver
  -generateScriptOnly D:\test\scripts\createtest.sql
La commande suivante permet de supprimer un référentiel :
java com.ibm.pdq.tools.ManageRepository –delete repository
  -repositoryURL jdbc:db2://test.user.com:17593/SAMPLE 
  -repositoryUsername mytestid 
  -repositoryPassword testpwd 
  -repositoryDriverClass com.ibm.db2.jcc.DB2Driver

Commentaires