Mandato sibDDLGenerator

El motor de mensajería necesita las sentencias DDL (lenguaje de definición de datos) para crear los recursos DBMS (sistema de gestión de bases de datos). Estos recursos DBMS son generados por el mandato sibDDLGenerator.

Sintaxis

Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
>>-sibDDLGenerator--+--------------------------+---------------->
                    '- -system--nombre de DBMS-'   

>--+----------------------------+------------------------------->
   '- -version--versión de DBMS-'   

>--+--------------------------------+--------------------------->
   '- -platform--plataforma de DBMS-'   

>--+-----------------------------+------------------------------>
   '- -schema--nombre de esquema-'   

>--+---------------------------+--+----------+------------------>
   '- -user--nombre de usuario-'  +- -create-+   
                                  '- -drop---'   

>--+---------------------------+-------------------------------->
   '- -database--base de datos-'   

>--+-----------------------------------------+------------------>
   '- -storagegroup--grupo de almacenamiento-'   

>--+--------------------------------------+--------------------->
   '- -catalog--calificador de alto nivel-'   

>--+-------------------------------------------------------+---->
   '- -bufferpool--agrupación de almacenamiento intermedio-'   

>--+-------------------------------+--+----------------+-------->
   '- -statementend--fin_sentencia-'  '- -nolinebreaks-'   

>--+----------------+--+----------------------------+----------->
   '- -noblanklines-'  '- -firstline--primera línea-'   

>--+--------------------------+--+---------------------+-------->
   '- -lastline--última línea-'  '- -permanent--número-'   

>--+---------------------+-------------------------------------><
   '- -temporary--número-'   

Finalidad

Un motor de mensajería necesita recursos DBMS, como tablas de bases de datos, que puede crear al iniciar. Si la instalación tiene una política que sólo un administrador de base de datos tiene la autoridad para crear tablas de bases de datos, utilice el mandato sibDDLGenerator para permitir al administrador de su base de datos crear los recursos DBMS que necesita el motor de mensajería. El mandato sibDDLGenerator genera las sentencias DDL que el administrador de base de datos puede guardar y procesar posteriormente para crear los recursos DBMS que se listan en Tablas de almacén de datos.

El mandato también genera sentencias DDL que conceden las autorizaciones necesarias para utilizar estas tablas.

[IBM i]Para acceder a la línea de mandatos de IBM® i, utilice el mandato STRQSH para iniciar una sesión Qshell. [IBM i]Para obtener más información, consulte Configuración de Qshell para ejecutar scripts de WebSphere mediante el script wsadmin.

Nota: El mandato sibDDLGenerator puede generar las sentencias DDL para la creación y el despliegue de todas las tablas del almacén de datos. Es menos adecuado para añadir más tablas de elementos en un almacén de datos existente. Sin embargo, es posible volver a emitir las sentencias DDL para crear tablas existentes sin causar ningún daño al almacén de datos.

Parámetros opcionales

Consejo: El mandato sibDDLGenerator es sensible a las mayúsculas y minúsculas. Por ejemplo, el valor del parámetro Oracle no es el mismo que el valor del parámetro oracle.

Algunos parámetros se aplican sólo a un DBMS específico, tal como se indica en la lista de parámetros; por ejemplo: -database [se aplica sólo a DB2 para z/OS]

-system
Identifica el tipo de DBMS en el que el administrador procesará las sentencias DDL. Los valores válidos son:
  • db2
  • oracle
  • sqlserver
  • sybase
  • informix
  • derby
Si no proporciona un parámetro -system, el valor predeterminado es derby.
-version
Número de versión de DBMS identificado por el parámetro -system. La tabla siguiente muestra el valor predeterminado que se utiliza si no proporciona un parámetro -version.

Si recibe un error CWSIS1595E o CWSIS1503E cuando ejecuta la herramienta, consulte las notas que se encuentran después de la tabla para determinar si se puede utilizar un valor de parámetro -version alternativo para su versión de la base de datos.

Tabla 1. Valores para el parámetro -version. La primera columna de la tabla muestra los valores de parámetro -system. La segunda columna de la tabla muestra los valores del parámetro -platform. La tercera columna de la tabla muestra los valores predeterminados de los parámetros -version. La cuarta columna de la tabla muestra los otros valores aceptados de los parámetros -version.
Valor del parámetro -system Valor del parámetro -platform Valor predeterminado para el parámetro -version Otros valores del parámetro -version aceptados
db2 zos 7.1 8.1, 9.1 (consulte la Nota 1)
db2 unix, windows 8.1 9.1 (consulte la Nota 1)
db2 iseries 5.2 (consulte la Nota 2) 5.3 (consulte la Nota 2)
oracle   8i 10g, 11g (consulte la Nota 3)
sqlserver   2000 2005
sybase   12.0 12.5, 15.0
informix   9.3 7.3, 9.4, 10.0, 11.0 (consulte la Nota 4)
derby   10.1  
Notas:
  1. El DDL generado para DB2 para UNIX o Windows mediante los valores del parámetro -version 8.1 y 9.1 son idénticos. El DDL generado para DB2 para z/OS utilizando los valores del parámetro -version 7.1, 8.1 y 9.1 son idénticos.
  2. Para IBM i, la base de datos DB2 forma parte del sistema operativo, por lo tanto, el número de versión especificado es para la versión de OS/400.
  3. El DDL generado para Oracle utilizando los valores 10g y 11g del parámetro -version es idéntico.
  4. El DDL generado para Informix utilizando los valores 10.0 y 11.0 del parámetro -version es idéntico.
-platform
Plataforma del sistema operativo en el que se ejecuta DBMS. Los valores válidos son:
  • iseries
  • unix
  • windows
  • zos
-schema
Nombre del esquema que contiene todos los objetos utilizados por el motor de mensajería. Si no proporciona un parámetro -schema, el valor predeterminado es IBMWSSIB.
-user
Nombre del ID de usuario que se utiliza para interactuar con DBMS. Si no proporciona un parámetro -user, el valor predeterminado es IBMUSER.
-create | -drop
Indica si las sentencias DDL crean los recursos DBMS o los suprimen. Si no proporciona ninguno de los dos parámetros, el valor predeterminado es -create.
-database [sólo se aplica a DB2 for z/OS]
Nombre de la base de datos asignado a las tablas del motor de mensajería. Si no proporciona un parámetro -database, el valor predeterminado es SIBDB.
-storagegroup [sólo se aplica a DB2 for z/OS]
Nombre del grupo de almacenamiento asignado a las tablas del motor de mensajería.
  • Si proporciona los parámetros -storagegroup y -catalog, el mandato sibDDLGenerator incluye ambos valores en la sentencia CREATE STOGROUP.
  • Si sólo proporciona un parámetro -storagegroup, el mandato sibDDLGenerator utiliza el nombre del grupo de almacenamiento de otras sentencias, pero no crea una sentencia CREATE STOGROUP.
  • Si sólo proporciona un parámetro -catalog, el mandato sibDDLGenerator muestra la sentencia de uso y, a continuación, termina.
  • Si omite ambos parámetros, el mandato sibDDLGenerator utiliza el valor predeterminado SIBSG para el nombre del grupo de almacenamiento en otras sentencias, pero no crea una sentencia CREATE STOGROUP.
-catalog [sólo se aplica a DB2 for z/OS]
El nombre del calificador de alto nivel correspondiente al grupo de almacenamiento que se asigna para las tablas del motor de mensajería. Si desea más información sobre los valores predeterminados, consulte el parámetro -storagegroup.
-bufferpool [sólo se aplica a DB2 for z/OS]
Nombre de la agrupación del almacenamiento intermedio asignado a las tablas del motor de mensajería. Si no proporciona un parámetro -bufferpool, el valor predeterminado es BP1.
-statementend
Añade fin_sentencia a cada sentencia DDL. Por ejemplo, puede utilizar ; para añadir un punto y coma a cada sentencia DDL. De forma predeterminada,el mandato sibDDLGenerator no añade nada a cada sentencia.
Consejo: En las plataformas, UNIX añada un carácter de escape al punto y coma para evitar que el shell lo interprete.
-nolinebreaks
Coloca cada sentencia en una línea individual, sin división de líneas. De forma predeterminada,el mandato sibDDLGenerator divide las líneas para facilitar su lectura.
-noblanklines
Omite las líneas en blanco entre cada sentencia. De forma predeterminada,el mandato sibDDLGenerator inserta una línea en blanco entre cada sentencia para facilitar su lectura.
-firstline
Genera la primera_línea como la primera línea de la salida. Por ejemplo, puede utilizar la primera_línea para identificar la base de datos de destino. De forma predeterminada,el mandato sibDDLGenerator no genera una primera línea.
-lastline
Genera la última_línea como la última línea de la salida. Por ejemplo, puede utilizar la última_línea para invocar un mandato que ejecuta los mandatos en el script. De forma predeterminada,el mandato sibDDLGenerator no genera una última línea.
Consejo: Los parámetros opcionales que controlan el formato de las sentencias DDL, por ejemplo, -statementend, le permiten generar una salida apta para herramientas de script determinadas, por ejemplo DB2 CLP. De forma predeterminada,el mandato sibDDLGenerator genera líneas en blanco entre cada sentencia DDL pero no añade un punto y coma al final de cada sentencia DDL.

Los dos parámetros opcionales siguientes se utilizan para distribuir el almacén de datos entre diferentes tablas:

-permanent
El número de tablas permanentes, con
  • Valor predeterminado: 1
  • Valor mínimo: 1
  • Valor máximo: consultar la Nota
-temporary
El número de tablas temporales, con
  • Valor predeterminado: 1
  • Valor mínimo: 1
  • Valor máximo: consultar la Nota
Nota: El número máximo de tablas SIBnnn que puede utilizar un motor de mensajería es 32. Esto incluye todas las tablas de corriente de datos, permanentes y temporales.

Ejemplos

  • sibDDLGenerator -system db2 -version 8.1 -platform zos

    Genera sentencias DDL para DB2 8.1, que se ejecuta en z/OS, con un esquema, ID de usuario, base de datos, grupo de almacenamiento y agrupación de almacenamiento intermedio predeterminados.

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

    Genera sentencias DDL para DB2 8.1, que se ejecuta en Windows, con un esquema, ID de usuario y una base de datos predeterminada. Puede especificar las sentencias directamente en DB2 CLP, que requiere que cada sentencia debe finalizar con un punto y coma.

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

    Genera sentencias DDL para Oracle 8i.

  • sibDDLGenerator -system oracle -schema SIB -user fred

    Versión concisa del ejemplo anterior.


Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjm0630_
File name: rjm0630_.html