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

(1)
>>-------java--com.ibm.pdq.tools.ManageRepository--------------->
>--+- -create repository-- -repositoryType--+-pureQueryOnly--------+------------------+-->
| '-pureQueryRuntimeOnly-' |
| (2) |
+------- -bind packages------------------------------------------------------------+
+- -verify repository--------------------------------------------------------------+
+- -report--+-repositoryData--+---------------------------+-- -file--nom-fichier-+-+
| | | .-long--. | | |
| | '- -reportlength--+-short-+-' | |
| '-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:
- 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 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 [-reportLength short|long]
-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.
Utilisez l'option
facultative
-reportLength pour spécifier les informations
dans le rapport.
- long
- Il s'agit de la valeur par défaut. Le rapport de référentiel répertorie les informations
de package et les instructions SQL contenues dans les packages.
- short
- Le rapport de référentiel répertorie les informations de package. Les instructions SQL
dans les packages ne sont pas répertoriées.
- 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 des informations sur l'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

(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:
- 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 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 des informations sur l'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

(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:
- 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 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 InfoSphere 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 des informations sur l'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 :
- 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 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.
- 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-'
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:
- 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 à 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 des informations sur l'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 collection, 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---->
>--| 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:
- 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 des informations sur l'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 InfoSphere Optim Performance Manager
InfoSphere Optim Performance Manager et InfoSphere 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 InfoSphere Optim Performance Manager.
Vous pouvez lancer l'utilitaire ManageRepository pour télécharger
uniquement des données pureQueryXML dans un référentiel InfoSphere 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 InfoSphere 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 externeType 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 d'archivage. L'ID du groupe d'archivage 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 Utilisation d'instructions SQL.
- 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