Notas del release

22.15 Integración de MQSeries con el Centro de depósito de datos

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.

22.15.1 Creación de vistas para mensajes MQSeries

22.15.1.1 Requisitos

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.

22.15.1.2 Restricciones

22.15.1.3 Creación de una vista para mensajes MQSeries

Para crear una vista para mensajes MQSeries:

  1. En la ventana Centro de depósito de datos, expanda el árbol Orígenes del depósito.
  2. Expanda la fuente de depósito que deberá contener la vista.
  3. Pulse la carpeta Vistas con el botón derecho del ratón y pulse Crear 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.

22.15.2 Importación de mensajes MQSeries y metadatos XML

22.15.2.1 Requisitos

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.

22.15.2.2 Restricciones

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.

22.15.2.3 Importación de mensajes MQSeries y metadatos XML

Para importar metadatos de MQSeries al Centro de depósito de datos:

  1. Prepare la base de datos de destino del depósito:
  2. Pulse Depósito con el botón derecho del ratón y pulse Importar metadatos --> MQSeries para abrir la ventana Importar metadatos.
  3. En el campo Servicio AMI, escriba el punto de servicio al que se envía un mensaje o del que se recupera.
  4. En el campo Política AMI, escriba la política que utilizará el sistema de gestión de mensajes para realizar la operación.
  5. En el campo Archivo DAD, escriba el nombre del archivo DAD de DB2 XML Extender, o busque un archivo a seleccionar pulsando la elipse (...). Este archivo tiene que ser local.
  6. En el campo Destino del depósito, seleccione en la lista de cuadro combinado el nombre del destino del depósito en que se ejecutará el paso. El destino del depósito debe estar ya definido.
  7. En el campo Esquema, escriba el nombre de un esquema para calificar los nombres de tabla del archivo DAD que no tengan calificador. Por omisión, se toma como esquema el id de usuario de conexión del destino del depósito seleccionado previamente.
  8. Elija una Opción de destino:

    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.

  9. Pulse en Aceptar.

    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:

  1. Pulse el paso con el botón derecho del ratón y seleccione Propiedades. Pulse la pestaña Parámetros del cuaderno de propiedades.
  2. Cambie el nombre del parámetro de archivo DAD por el nombre del mismo archivo DAD en el sitio agente de destino del depósito remoto.
  3. Asegúrese de que el Sitio agente de la pestaña Opciones de proceso contiene el sitio agente que desea.

22.15.2.4 Utilización del programa de MQSeries definido por el usuario

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)
Nota:
El tipo de datos de todos los parámetros de esta tabla es CHARACTER.

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.

22.15.2.5 Códigos de retorno de error

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.

22.15.2.6 Archivo de registro de errores

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.


[ Principio de página | Página anterior | Página siguiente ]