Ahora, el Centro de depósito de datos permite acceder a datos de una cola de mensajes MQSeries como una vista de una base de datos DB2. Se proporciona un asistente para crear una función de tabla DB2 y la vista de DB2 mediante la cual se puede acceder a los datos. Cada uno de los mensajes MQSeries se trata como una serie delimitada, que se analiza en función de las especificaciones del usuario y se devuelve como una fila de resultado. Además, se puede acceder a los mensajes MQSeries que son documentos XML como fuente del depósito. Mediante el Centro de depósito de datos, puede importar metadatos de una cola de mensajes MQSeries y de un archivo de Definición de acceso a documento (DAD) de DB2 XML Extender.
DB2 Universal Database Versión 7.2.
DB2 Warehouse Manager Versión 7.2
Soporte de MQSeries. Consulte más información sobre los requisitos de MQSeries en el apartado MQSeries. Para obtener información sobre el establecimiento de la fuente de depósito, consulte el apartado de configuración de las funciones definidas por el usuario.
Cuando se cataloga una base de datos de fuente de depósito, en la máquina agente se cataloga el alias de la base de datos. Sin embargo, cuando se crean vistas de MQSeries y XML, el Centro de depósito de datos supone que el alias de la base de datos también está definido en la máquina cliente, e intentará conectar con ésta utilizando el id de usuario y la contraseña de la base de datos fuente del depósito. Si lo consigue, se invocará al asistente y se podrá crear la vista. Si no lo consigue, se visualizará un mensaje de aviso y deberá catalogar el alias o elegir otro alias de base de datos en el asistente.
Para conocer la longitud máxima de los mensajes MQ, consulte el apartado de las Notas del release que hace referencia a la Consulta de SQL.
Para crear una vista para mensajes MQSeries:
Se abre el asistente para MQSeries. Cuando haya terminado con el asistente, se creará una nueva vista en el Centro de depósito de datos. Cuando se seleccione dicha vista, se accederá a la cola de MQSeries y se analizará cada mensaje como una serie delimitada en función de las especificaciones del usuario indicadas en el asistente.
DB2 Universal Database Versión 7.2.
DB2 XML Extender Versión 7.2.
Soporte de MQSeries. Consulte más información sobre los requisitos de MQSeries en el apartado MQSeries. Para obtener información sobre el establecimiento de la fuente del depósito, consulte el apartado de configuración de las funciones definidas por el usuario.
La importación fallará si las tablas de destino existen con claves primarias o foráneas. Antes de realizar la importación, deberá suprimir manualmente las definiciones de dichas claves en el Depósito de datos.
Para importar metadatos de MQSeries al Centro de depósito de datos:
Si desea que el paso sustituya al contenido de la tabla de destino durante la ejecución, pulse el botón de selección Sustituir el contenido de la tabla.
Si desea que el paso se añada al contenido de la tabla de destino durante la ejecución, pulse el botón de selección Añadir al contenido de la tabla.
Se cierra la ventana Importar metadatos.
Cuando finaliza la operación de importación, se añaden al árbol del Depósito los objetos de depósito siguientes:
Si el sitio agente de destino del Depósito es distinto de la máquina local, debe cambiar el parámetro de paso:
El procedimiento almacenado de MQSeries y XML se denomina MQXMLXF y se incluye con DB2 Data Warehouse Center Versión 7.2 para Windows NT y UNIX. El paso que se crea al importar metadatos de MQSeries y XML ejecutará el procedimiento almacenado. En la tabla siguiente se describen sus parámetros:
Parámetro | Valores |
NombreServicio MQSeries | Nombre del punto de servicio al que se envía un mensaje o del que se recupera. |
NombrePolítica MQSeries | Nombre de la política que utilizará el sistema de gestión de mensajes para realizar la operación. |
Nombre de archivo DAD | Nombre del archivo DAD de DB2 XML Extender |
ListaTablasDestino | Lista de las tablas de destino del paso, separadas por comas. |
Opción | REPLACE o APPEND |
RUN ID | Número de edición del paso (a efectos de registro cronológico) |
|
El procedimiento almacenado suprime todas las filas de las tablas de destino si Opción tiene el valor REPLACE. También llama al procedimiento almacenado de DB2 XML Extender para llenar las tablas de destino para todos los mensajes MQSeries existentes.
Al ejecutar el paso, el procedimiento almacenado puede devolver el código
de error SQLCODE -443 y SQLSTATE 38600. Para diagnosticar el error,
consulte la tabla siguiente de textos de diagnóstico posibles.
Número de error | Descripción |
AMIRC=xxxxx;<nombre archivo anotaciones cronológicas> | xxxxx es el código de retorno de la capa AMI. Para conocer más detalles, consulte la documentación de MQSeries. <nombre archivo anotaciones cronológicas> indica la ubicación del archivo de anotaciones cronológicas. |
XMLRC=xxxxx;<nombre archivo anotaciones cronológicas> | xxxxx es el código de retorno de DB2 XML Extender. Para ver descripciones de los códigos de retorno, consulte la documentación de DB2 XML Extender. <nombre archivo anotaciones cronológicas> indica la ubicación del archivo de anotaciones cronológicas. |
SQLCODE=xxxxx;<nombre archivo anotaciones cronológicas> | xxxxx es el SQLCODE distinto de cero devuelto cuando se realiza una petición de SQL. <nombre archivo anotaciones cronológicas> indica la ubicación del archivo de anotaciones cronológicas. |
Para todos los errores, vea si hay más información en el archivo de anotaciones cronológicas.
El Centro de depósito de datos almacena toda la información de diagnóstico en un archivo de anotaciones cronológicas cuando se ejecuta MQXMLXF. El nombre del archivo de anotaciones cronológicas es mqxf<nnnnnnnn>.log, donde <nnnnnnnn> es el RunID que se ha pasado al procedimiento almacenado. El Centro de depósito de datos creará el archivo en el directorio indicado por la variable de entorno VWS_LOGGING. Si no está definido este entorno, el archivo de anotaciones cronológicas se creará en el directorio temporal.
Para hacer que la variable de entorno VWS_LOGGING resulte visible para el procedimiento almacenado en una plataforma Unix, debe añadir VWS_LOGGING a la variable de entorno DB2ENVLIST utilizando el mandato db2set antes que el mandato db2start. La figura siguiente es un mandato de entorno de ejemplo.
Figura 6. Ejemplo de mandato de variable de entorno
db2set DB2ENVLIST="AMT_DATA_PATH VWS_LOGGING"
El archivo de anotaciones cronológicas se suprime si el paso se ejecuta satisfactoriamente.