WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

Nodo Database

Utilice el nodo Database para interactuar con una base de datos en el origen de datos ODBC especificado.

Finalidad

Defina la naturaleza de la interacción codificando sentencias ESQL que especifican los datos del mensaje de entrada y quizás los transforman de alguna manera (por ejemplo, para realizar un cálculo), y asignan el resultado a una tabla de base de datos.

Puede establecer una propiedad para controlar si la actualización de la base de datos se confirma inmediatamente o si se difiere hasta que el flujo de mensajes se complete, momento en el que la actualización se confirma o se restituye, según el estado general de realización del flujo de mensajes.

El nodo Database está contenido en la bandeja Base de datos de la paleta y se representa en el WebSphere Message Broker Toolkit con el siguiente icono:

Icono de nodo Database

Utilización de este nodo en un flujo de mensajes

Consulte los ejemplos siguientes para ver cómo se debe utilizar este nodo:

Puede ver información sobre los ejemplos sólo cuando utilice el Information Center que está integrado en WebSphere Message Broker Toolkit o el Information Center en línea. Puede ejecutar ejemplos sólo cuando utilice el Information Center que está integrado en WebSphere Message Broker Toolkit.

Por ejemplo, supongamos que recibe un pedido de 20 monitores. Si tiene suficientes monitores en el almacén, desea reducir las existencias en el almacén. Puede utilizar el nodo Database para comprobar si tiene suficientes monitores disponibles, y reducir el valor de campo de cantidad en la base de datos.

Terminales y propiedades

Cuando haya colocado una instancia del nodo Database en un flujo de mensajes, podrá configurarlo; consulte el apartado Configurar un nodo de flujo de mensajes. Las propiedades del nodo se visualizan en la vista Propiedades. Todas las propiedades obligatorias para las que debe especificar un valor (las que no tienen un valor predeterminado definido) están marcadas con un asterisco.

Los terminales del nodo Database se describen en la tabla siguiente. Para obtener más información sobre la sentencia PROPAGATE, incluida su sintaxis, consulte Sentencia PROPAGATE.

Terminal Descripción
In (de entrada) El terminal de entrada que acepta un mensaje para que lo procese el nodo.
Failure (de anomalías) El terminal de salida al que se propaga el mensaje de entrada si se detecta una anomalía durante el cálculo. Si ha seleccionado Tratar los avisos como errores, el nodo propaga el mensaje a este terminal aunque el proceso se complete satisfactoriamente.
Out (de salida) El terminal de salida al que se direcciona el mensaje transformado cuando se completa el proceso en el nodo. Es posible que una sentencia PROPAGATE también direccione el mensaje transformado a este terminal.
Out1 El primer terminal de salida alternativo al que es posible que una sentencia PROPAGATE direccione el mensaje transformado.
Out2 El segundo terminal de salida alternativo al que es posible que una sentencia PROPAGATE direccione el mensaje transformado.
Out3 El tercer terminal de salida alternativo al que es posible que una sentencia PROPAGATE direccione el mensaje transformado.
Out4 El cuarto terminal de salida alternativo al que es posible que una sentencia PROPAGATE direccione el mensaje transformado.

Las tablas siguientes describen las propiedades de nodo. La columna con la cabecera O indica si la propiedad es obligatoria (marcada con un asterisco si tiene que entrar un valor cuando no hay definido ningún valor predeterminado); la columna con la cabecera C indica si la propiedad es configurable (puede cambiar el valor cuando añade el flujo de mensajes al archivo BAR para desplegarlo).

En la tabla siguiente se describen las propiedades de descripción del nodo Database.

Propiedad O C Valor predeterminado Descripción
Nombre de nodo No No El tipo de nodo, Database El nombre del nodo.
Descripción corta No No   Descripción breve del nodo.
Descripción larga No No   Texto que describe la finalidad del nodo en el flujo de mensajes.

Las propiedades básicas del nodo Database se describen en la siguiente tabla.

Propiedad O C Valor predeterminado Descripción Propiedad de mandato mqsiapplybaroverride
Origen de datos No   El nombre del origen de datos ODBC de la base de datos que contiene las tablas a las que se hace referencia en el ESQL asociado a este nodo (identificado por la propiedad Sentencia).

Este nombre identifica la base de datos apropiada tal como se la conoce en el sistema en el que se va a ejecutar el flujo de mensajes. El intermediario se conecta a esta base de datos con la información de ID de usuario y contraseña que ha especificado en el mandato mqsisetdbparms.

Si el ESQL que está asociado a este nodo incluye una sentencia PASSTHRU o una función SELECT y una referencia a base de datos, debe especificar un valor para la propiedad Origen de datos.

dataSource
Sentencia No No Database Nombre del módulo dentro del archivo ESQL que contiene las sentencias que se van a utilizar con la base de datos. Si desea que el nombre del módulo incluya uno o varios espacios, escriba el nombre entre comillas.

El archivo ESQL, que, de forma predeterminada tiene el nombre <nombre_flujo_mensajes>.esql, contiene ESQL para cada nodo del flujo de mensajes que lo necesite. Cada parte del código relacionada con un nodo específico se denomina módulo. Cuando codifica sentencias ESQL que interactúan con tablas, se da por hecho que esas tablas existen dentro de esta base de datos. Si no existen, el intermediario genera un error de base de datos durante la ejecución.

Codifique las sentencias ESQL para personalizar el comportamiento del nodo Database en un archivo ESQL que esté asociado al flujo de mensajes en el que ha incluido esta instancia del nodo Database. Si no existe ningún archivo ESQL para este flujo de mensajes, efectúe una doble pulsación en el nodo Database o pulse con el botón derecho del ratón en el nodo y pulse Abrir ESQL para crear y abrir un nuevo archivo ESQL en la vista de editor ESQL.

Si el archivo existe, pulse Examinar al lado de la propiedad Sentencia para visualizar el recuadro de diálogo Selección de módulo, que lista los módulos disponibles del nodo Database definidos en los archivos ESQL a los que este flujo de mensajes puede acceder (pueden definirse archivos ESQL en otros proyectos dependientes). Seleccione el módulo apropiado y pulse Aceptar. Si no hay disponibles módulos apropiados, la lista está vacía.

Si el módulo que ha especificado no existe, se crea automáticamente y el editor lo muestra. Si el archivo y el módulo existen, el editor resalta el módulo adecuado. Si se crea un esqueleto de módulo para este nodo en un archivo ESQL nuevo o ya existente, consta del ESQL siguiente. En este ejemplo se muestra el nombre de módulo predeterminado:

CREATE DATABASE MODULE <nombre_flujo>_Database
       CREATE FUNCTION Main() RETURNS BOOLEAN
       BEGIN
               RETURN TRUE; 
       END;
END MODULE;

Si crea su propio módulo ESQL, debe crear este esqueleto exactamente tal como se muestra. Puede actualizar el nombre predeterminado, pero asegúrese de que el nombre que especifique coincida con el nombre de la propiedad de nodo Sentencia correspondiente.

Para personalizar este nodo, añada su propio ESQL después de la sentencia BEGIN y antes de RETURN TRUE. En este módulo puede utilizar todas las sentencias ESQL incluidas SET, WHILE, DECLARE e IF, pero (a diferencia del nodo Compute) el nodo Database propaga el mensaje que recibe en su terminal de entrada al terminal de salida, sin modificar. Por lo tanto, del mismo modo que en el nodo Filter, en un nodo Database sólo tendrá un mensaje al que hacer referencia.

 
Transacción No Automática La modalidad de transacción para el nodo. Los valores son los siguientes:
  • Automática (el valor predeterminado). El flujo de mensajes del que forma parte el nodo Database, se confirma si es satisfactorio; es decir, que se realizan las acciones que se definen en el módulo ESQL y el mensaje continúa a través del flujo de mensajes. Si el flujo de mensajes da error, la acción se restituye. Si selecciona Automática, la posibilidad de confirmar o restituir la acción del nodo Database en la base de datos depende del éxito o el error de todo el flujo de mensajes.
  • Confirmar. Para confirmar todas las acciones no confirmadas realizadas en este flujo de mensajes en la base de datos conectada a este nodo, independientemente del éxito o error del flujo de mensajes como un todo, seleccione Confirmar. Los cambios en la base de datos se confirman incluso si el flujo de mensajes propiamente dicho no se ejecuta correctamente.
 
Tratar los avisos como errores No No seleccionado Para que los mensajes de aviso de base de datos se traten como errores y que el nodo propague el mensaje de salida al terminal de anomalías, seleccione Tratar los avisos como errores. Inicialmente, el recuadro está vacío.

Cuando selecciona el recuadro, el nodo gestiona todos los códigos de retorno positivos de la base de datos como errores y genera excepciones igual que si se tratase de errores negativos o más graves. Si no selecciona el recuadro, el nodo trata los avisos como códigos de retorno normales y no emite ninguna excepción. El aviso más significativo es no encontrado que, en la mayoría de los casos, puede tratarse de forma segura como un código de retorno habitual.

 
Generar excepción en error de la base de datos No Seleccionado Para que el intermediario genere una excepción cuando se detecte un error de base de datos, seleccione Generar excepción en error de base de datos. Inicialmente, el recuadro está seleccionado.

Si deselecciona el recuadro, incluya ESQL para comprobar si hay errores de base de datos que puedan devolverse después de cada llamada de base de datos que efectúe (para obtener esta información, puede utilizar SQLCODE y SQLSTATE). Si se ha producido un error, deberá gestionarlo en el flujo de mensajes para asegurarse de la integridad del intermediario y de la base de datos; el error se ignora si no lo gestiona a través de su propio proceso, debido a que ha elegido no utilizar el manejo de errores predeterminado mediante el intermediario. Por ejemplo, puede incluir la sentencia THROW de ESQL para generar una excepción o puede utilizar el nodo Throw para generar posteriormente una excepción propia.

 

Conectarse antes de iniciar el flujo

No

No seleccionado

De forma predeterminada, el intermediario se conecta al origen de datos cuando es necesario en un flujo de mensajes.

Si marca el recuadro de selección, las conexiones del origen de datos se establecerán antes de que el flujo reciba un mensaje, en lugar de hacerlo durante el proceso del flujo de mensajes.

 
Las propiedades de supervisión del nodo se describen en la siguiente tabla.
Propiedad O C Valor predeterminado Descripción
Sucesos No No Ninguno Los sucesos que se han definido para el nodo se visualizan en este separador. De forma predeterminada, no se define ningún suceso de supervisión en ningún nodo en un flujo de mensajes. Utilice Añadir, Editar y Suprimir para crear, cambiar o suprimir sucesos de supervisión para el nodo; consulte Configuración de orígenes de sucesos de supervisión utilizando propiedades de supervisión para obtener detalles.

Puede habilitar e inhabilitar sucesos que se muestran aquí seleccionando o deseleccionando el recuadro Habilitado.

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 16:58:20


Tema de referenciaTema de referencia | Versión 8.0.0.5 | ac04670_