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.
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

(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:
- Vous pouvez spécifier les options dans n'importe quel ordre.
- L'option -bind packages ne peut être utilisées
qu'avec une base de données prenant en charge les instructions SQL statiques.
- 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

(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:
- Vous pouvez spécifier les options dans n'importe quel ordre.
- L'option -runtimeGroupVersion ne peut pas être
définie avec l'option -copy runtimeGroup.
- 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

(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:
- Vous pouvez spécifier les options dans n'importe quel ordre.
- 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 :
- Procédez à l'extraction des données incrémentielles.
- Utilisez l'utilitaire Merge pour combiner les fichiers SQL capturés au fichier
pureQueryXML.
- Utilisez l'utilitaire Configure pour configurer le fichier pureQueryXML
mis à jour.
- 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.
- 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

(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:
- Vous pouvez spécifier les options dans n'importe quel ordre.
- 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.
- 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

(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:
- 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