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 InfoSphere Optim pureQuery Runtime.

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 ManageRepository incluent la création, la mise à niveau et la suppression d'un référentiel dans une base de données, le contrôle de validité 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 les émettez, vous pouvez utiliser l'option -verify repository pour contrôler le référentiel.

Pour créer un référentiel contenant uniquement les informations issues des fichiers pureQuery utilisés pour l'optimisation de client pureQuery, utilisez l'option -repositoryType en définissant la valeur pureQueryRuntimeOnly.

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--+--------------------+---------------------+   
   |                      '- -force--+-FALSE-+-'                     |   
   |                                 '-TRUE--'                       |   
   '- -upgrade-------------------------------------------------------'   

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

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

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

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.
  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 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
Il s'agit de la valeur par défaut. Le référentiel peut contenir des informations issues de fichiers pureQuery utilisés par les applications activées avec l'optimisation de client pureQuery, les propriétés pureQuery Runtime et les données pureQueryXML. Le référentiel peut également contenir des options de liaison et des options de configuration de fichiers pureQueryXML.

Lorsque vous téléchargez les contenus d'un fichier pureQueryXML sur un référentiel, l'utilitaire ManageRepository extrait les instructions SQL des données pureQueryXML et les stocke séparément dans le référentiel.

Le référentiel peut contenir les données SQL qui ont été exportées depuis IBM® Data Studio vers le référentiel.

pureQueryRuntimeOnly
Le référentiel peut contenir des informations issues de fichiers pureQuery utilisés par les applications activées avec l'optimisation de client pureQuery, les propriétés pureQuery Runtime et les données pureQueryXML. Le référentiel peut également contenir des options de liaison et des options de configuration de fichiers pureQueryXML.

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. La valeur nom-fichier correspond au nom et à l'emplacement 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.

La sortie renvoyée inclut les informations des différents composants du référentiel. La sortie inclut également des messages indiquant des problèmes avec le référentiel tel que des autorisations incorrectes ou des tables avec des colonnes manquantes.

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 obtenir des informations sur l'utilisation des 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.

-upgrade
Mettez à niveau un référentiel pour qu'il prenne en charge le stockage d'événements de journaux pureQuery. Si le référentiel se trouve déjà au niveau correct, aucune action n'est entreprise.

Si vous avez utilisé l'option -bind packages de ManageRepository pour créer des packages de base de données afin de gérer l'accès au référentiel, vous devez utiliser l'option -bind packages pour lier à nouveau les packages.

Pour un référentiel prenant en charge le stockage d'événements de journal, vous pouvez spécifier la propriété de journalisation com.ibm.pdq.database de pureQuery pour écrire des événements pureQuery sur le référentiel.

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

-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-basededonné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 la version de groupe d'exécution incluent les informations de configuration pureQuery, les données pureQueryXML et le cas échéant, les données SQL capturées à partir d'applications activées avec l'optimisation de 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-'   

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.
  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 dans le référentiel, une 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 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 la version existante du groupe d'exécution utilisé pour créer une version de groupe d'exécution.

Si aucune valeur source-version n'est spécifiée, la version de groupe d'exécution active est utilisée. Si aucune valeur 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-basededonné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-'   

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.
  2. Sur les plateformes prenant en charge les instructions SQL statiques, executePackage est la seule option prise en charge après l'émission de l'option -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 prenant en charge uniquement 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-basededonné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 l'utilitaire StaticBind pour créer des packages d'instructions SQL dans une base de données à partir des ensembles d'instructions du fichier pureQueryXML et lier les packages dans la 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-'   

informations de connexion

|-- -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 à l'aide de la fonction d'export de Data Studio et que plusieurs projets pureQuery ont été sélectionnés pour exportation, seules les données pureQuery des derniers projets sont importées dans le groupe d'exécution indiqué 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 fichiers contenant les données SQL capturées extraites ont le format suivant : préfixe_N.pdqxml, où la valeur 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 de 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---->

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

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 le langage SQL statique, l'utilisation des options -grant privilege et -privilege EXECUTEPACKAGE permet aux applications d'accéder au référentiel de métadonnées à l'aide d'instructions liées de façon statique. Pour les plateformes prenant en charge le langage SQL statique, 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 permet 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.

Gestion d'un référentiel avec un mécanisme de sécurité DB2 externe
Lors de la création d'un référentiel, l'utilitaire ManageRepository crée des packages pour gérer ce référentiel. L'utilitaire crée des packages différents en fonction du type de référentiel créé. Si vous utilisez un mécanisme de sécurité DB2 externe pour gérer un référentiel, vous devez accorder les privilèges aux packages dans leur outil de sécurité. La table suivante répertorie le nom du package et les privilèges requis pour le type de référentiel :
Tableau 1. Privilèges requis pour les packages de référentiel lors de la gestion d'un référentiel avec mécanisme de sécurité DB2 externe
Type de référentiel Nom de package de référentiel Privilèges de niveau gestionnaire (complets) Privilèges de niveau application (restreints)
pureQueryRuntimeOnly AMDL X  
pureQueryRuntimeOnly ou pureQueryOnly AMDA X X
pureQueryOnly AMD X  
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 IBM Data Studio. Pour plus d'informations sur l'éditeur SQL et XQuery, voir Working with SQL statements.
  • Exécutez le script à partir d'un fichier sur la ligne de commande DB2. A partir de la ligne de commande DB2, connectez-vous à la base de données de 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 obtenir des informations sur la ligne de commande DB2, voir Command line processor (CLP) dans le centre de documentation DB2.

Exemples de scripts ManageRepository
Des exemples de scripts de ligne de commande présentant l'utilisation de commandes ManageRepository figurent dans le répertoire d'installation de pureQuery Runtime pour Linux, UNIX et Windows.

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