Commande sibDDLGenerator

Des instructions DDL (data definition language) sont nécessaires à un moteur de messagerie pour créer les ressources du système de gestion de base de données (SGBD). Ces ressources du système de gestion de base de données sont générées à l'aide de la commande sibDDLGenerator.

Syntaxe

Lire le diagrammeSauter le diagramme
>>-sibDDLGenerator--+---------------------+--------------------->
                    '- -system--nomduSGBD-'   

>--+--------------------------+--------------------------------->
   '- -version--versionduSGBD-'   

>--+------------------------------+----------------------------->
   '- -platform--plateformeduSGBD-'   

>--+-----------------------+--+--------------------------+------>
   '- -schema--nomduschéma-'  '- -user--nomd'utilisateur-'   

>--+----------+--+-----------------------------+---------------->
   +- -create-+  '- -database--base de données-'   
   '- -drop---'                                    

>--+----------------------------------+------------------------->
   '- -storagegroup--groupedestockage-'   

>--+------------------------------------+----------------------->
   '- -catalog--qualifiantdeniveauélevé-'   

>--+--------------------------------------+--------------------->
   '- -bufferpool--pool de mémoire tampon-'   

>--+-----------------------------------+--+----------------+---->
   '- -statementend--fin d'instruction-'  '- -nolinebreaks-'   

>--+----------------+--+----------------------------+----------->
   '- -noblanklines-'  '- -firstline--premièreligne-'   

>--+----------------------------+--+---------------------+------>
   '- -lastline--dernière ligne-'  '- -permanent--nombre-'   

>--+---------------------+-------------------------------------><
   '- -temporary--nombre-'   

Fonction

Un moteur de messagerie a besoin de ressources SGBD, telles que des tables de base de données, qu'il crée au démarrage. Si votre installation est soumise à une règle spécifiant que seul un administrateur de base de données est autorisé à créer des tables de base de données, utilisez la commande sibDDLGenerator pour permettre à votre administrateur de base de données de créer les ressources SGDB requises par le moteur de messagerie. La commande sibDDLGenerator génère les instructions DDL que l'administrateur de votre base de données peut sauvegarder, et traiter ultérieurement, pour créer les ressources DBMS répertoriées dans Tables des magasins de données.

Cette commande génère également les instructions DDL qui octroient les autorisations appropriées permettant à un moteur de messagerie d'utiliser ces tables.

[IBM i]Pour accéder à la ligne de commande IBM® i, utilisez la commande STRQSH afin de lancer une session Qshell. [IBM i]Pour plus d'informations, voir Configuration de Qshell pour exécuter des scripts WebSphere à l'aide de l'outil de scriptage wsadmin.

Remarque : La commande sibDDLGenerator permet de générer les instructions DDL permettant de créer ou de supprimer toutes les tables du magasin de données. Elle convient moins à l'ajout de tables supplémentaires à un magasin de données existant. Toutefois, il est possible de lancer à nouveau les instructions DDL pour créer des tables existantes sans endommager le magasin de données.

Paramètres optionnels

Conseil : La casse doit être respectée dans la commande sibDDLGenerator. Par exemple, la valeur de paramètre Oracle est différente de la valeur de paramètre oracle.

Certains paramètres s'appliquent à un système de gestion de base de données spécifique uniquement, comme il est indiqué dans la liste des paramètres. Par exemple : -database [s'applique uniquement à DB2 for z/OS]

-system
Identifie le type de système SGBD sur lequel l'administrateur traitera les instructions DDL. Les valeurs valides sont les suivantes :
  • db2
  • oracle
  • sqlserver
  • sybase
  • informix
  • derby
Si vous ne fournissez pas de paramètre -system, la valeur derby est utilisée par défaut.
-version
Numéro de version du système SGBD identifié par le paramètre -system. La table suivante indique la valeur par défaut utilisée si vous ne fournissez pas de paramètre -version.

Si une erreur CWSIS1595E ou CWSIS1503E est générée pendant l'exécution de l'outil, consultez les remarques figurant après la table pour déterminer si une autre valeur du paramètre -version peut être utilisée pour la version de votre base de données.

Tableau 1. Valeurs du paramètre -version. La première colonne du tableau répertorie les valeurs du paramètre -system. La deuxième colonne du tableau répertorie les valeurs du paramètre -platform. La troisième colonne du tableau répertorie les valeurs par défaut des paramètres -version. La quatrième colonne du tableau répertorie les autres valeurs admises des paramètres -version.
Valeur du paramètre -system Valeur du paramètre -platform Valeur par défaut du paramètre -version Autres valeurs acceptées du paramètre -version
db2 zos 7.1 8.1, 9.1 (voir Remarque 1)
db2 unix, windows 8.1 9.1 (voir la remarque 1)
db2 iseries 5.2 (voir Remarque 2) 5.3 (voir Remarque 2)
oracle   8i 10g, 11g (voir la remarque 3)
sqlserver   2000 2005
sybase   12.0 12.5, 15.0
informix   9.3 7.3, 9.4, 10.0, 11.0 (voir Remarque 4)
derby   10.1  
Remarques :
  1. Le fichier DDL généré pour DB2 for UNIX ou Windows à l'aide des valeurs de paramètre -version 8.1 et 9.1 est identique. Le fichier DDL généré pour DB2 for z/OS à l'aide des valeurs de paramètre -version 7.1, 8.1 et 9.1 est identique.
  2. Pour IBM i, la base de données DB2 fait partie intégrante du système d'exploitation. Le numéro de version indiqué est destiné à la version OS/400.
  3. Le fichier DDL généré pour Oracle avec les valeurs de paramètre -version 10g et 11g est identique.
  4. Le fichier DDL généré pour Informix avec les valeurs de paramètre -version 10.0 et 11.0 est identique.
-platform
Système d'exploitation sur lequel le système SGBD est exécuté. Les valeurs admises sont les suivantes :
  • iseries
  • unix
  • windows
  • zos
-schema
Nom du schéma contenant tous les objets utilisés par le moteur de messagerie. Si vous ne fournissez pas de paramètre -schema, la valeur IBMWSSIB est utilisée par défaut.
-user
Nom de l'ID utilisateur utilisé pour interagir avec le système SGBD. Si vous ne fournissez pas de paramètre -user, la valeur IBMUSER est utilisée par défaut.
-create | -drop
Indique si les instructions DDL créent les ressources SGBD ou les suppriment. Si vous ne fournissez pas l'un de ces paramètres, la valeur -create est utilisée par défaut.
-database [s'applique uniquement à DB2 for z/OS]
Nom de la base de données affectée aux tables du moteur de messagerie. Si vous ne fournissez pas de paramètre -database, la valeur SIBDB est utilisée par défaut.
-storagegroup [s'applique uniquement à DB2 for z/OS]
Nom du groupe de stockage affecté aux tables du moteur de messagerie.
  • Si vous fournissez le paramètre -storagegroup et le paramètre -catalog, la commande sibDDLGenerator insère ces deux valeurs dans l'instruction CREATE STOGROUP.
  • Si vous fournissez uniquement le paramètre -storagegroup, la commande sibDDLGenerator utilise le nom du groupe de stockage dans d'autres instructions, mais ne crée pas d'instruction CREATE STOGROUP.
  • Si vous fournissez uniquement le paramètre -catalog, la commande sibDDLGenerator affiche la ligne de syntaxe et prend fin.
  • Si vous omettez les deux paramètres, la commande sibDDLGenerator utilise par défaut la valeur SIBSG pour le nom du groupe de stockage dans les autres instructions, mais ne crée par d'instruction CREATE STOGROUP.
-catalog [s'applique uniquement à DB2 for z/OS]
Nom du qualifiant de niveau élevé du groupe de stockage affecté aux tables du moteur de messagerie. Pour obtenir des informations sur les valeurs par défaut, voir le paramètre -storagegroup.
-bufferpool [s'applique uniquement à DB2 for z/OS]
Nom du pool de mémoire tampon affecté aux tables du moteur de messagerie. Si vous ne fournissez pas de paramètre -bufferpool, la valeur BP1 est utilisée par défaut.
-statementend
Ajoute fin_instruction à la fin de chaque instruction DDL. Par exemple, vous pouvez utiliser ; pour ajouter un point-virgule à la fin de chaque instruction DDL. Par défaut, la commande sibDDLGenerator n'ajoute rien à la fin des instructions.
Conseil : Sous UNIX, vous devez précéder le point-virgule d'un caractère d'échappement pour empêcher le shell de l'interpréter.
-nolinebreaks
Place chaque instruction sur une seule ligne, sans passage à la ligne. Par défaut, la commande sibDDLGenerator fait passer les instructions à la ligne pour en améliorer la lisibilité.
-noblanklines
N'insère pas de lignes vierges entre chaque instruction. Par défaut, la commande sibDDLGenerator insère une ligne vierge entre chaque instruction pour améliorer la lisibilité.
-firstline
Génère première_ligne comme première ligne de sortie. Par exemple, vous pouvez utiliser première_ligne pour identifier la base de données cible. Par défaut, la commande sibDDLGenerator ne génère pas de première ligne.
-lastline
Génère dernière_ligne comme dernière ligne de sortie. Par exemple, vous pouvez utiliser dernière_ligne pour appeler une commande qui exécute les commandes du script. Par défaut, la commande sibDDLGenerator ne génère pas de dernière ligne.
Conseil : Les paramètres facultatifs qui contrôlent le format des instructions DDL, par exemple -statementend, permettent de générer une sortie appropriée pour des outils de script particuliers (par exemple, le CLP DB2). Par défaut, la commande sibDDLGenerator génère des lignes vierges entre chaque instruction DDL, mais n'ajoute pas de point-virgule à la fin de chaque instruction DDL.

Les deux paramètres facultatifs ci-dessous permettent d'étendre le magasin de données sur plusieurs tables :

-permanent
Le nombre de tables permanentes :
  • Valeur par défaut : 1
  • Valeur minimale : 1
  • Valeur maximum : voir Remarque
-temporary
Le nombre de tables permanentes :
  • Valeur par défaut : 1
  • Valeur minimale : 1
  • Valeur maximum : voir Remarque
Remarque : Un moteur de messagerie peut utiliser jusqu'à 32 tables SIBnnn. Il s'agit notamment de toutes les tables de flux, ainsi que des tables permanentes et temporaires.

Exemples

  • sibDDLGenerator -system db2 -version 8.1 -platform zos

    Génère des instructions DDL pour DB2 8.1, sous z/OS , avec un ID utilisateur, une base de données, un groupe de stockage, un pool de mémoire tampon et un schéma par défaut.

  • sibDDLGenerator -system db2 -version 8.1 -platform windows -statementend ;

    Génère des instructions DDL pour DB2 8.1, sous Windows, avec un schéma par défaut, un ID utilisateur et une base de données. Vous pouvez entrer directement les instructions dans le CLP DB2, ce qui nécessite que chaque instruction se termine par un point-virgule.

  • sibDDLGenerator -system oracle -version 8i -schema SIB -user fred

    Génère des instructions DDL pour Oracle 8i.

  • sibDDLGenerator -system oracle -schema SIB -user fred

    Version concise de l'exemple précédent.


Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjm0630_
Nom du fichier : rjm0630_.html