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
>>-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.
Para acceder a la línea de mandatos de IBM® i, utilice el mandato STRQSH para iniciar una sesión Qshell.
Para obtener más información, consulte Configuración de Qshell para ejecutar scripts de WebSphere mediante el script wsadmin.
Parámetros opcionales
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
- -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:- 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.
- 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.
- El DDL generado para Oracle utilizando los valores 10g y 11g del parámetro -version es idéntico.
- 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.
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
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.