Llamada a un procedimiento almacenado desde una correlación

Utilice el editor de correlaciones de datos gráficas para llamar a un procedimiento almacenado utilizando la transformación de Rutina de base de datos.

Antes de empezar:
Realice la siguiente tarea:

Puede utilizar la transformación de Rutina de base de datos para llamar a un procedimiento almacenado de una base de datos.

Nota: Sólo los procedimientos almacenados de IBM® DB2 están soportados en IBM Integration Bus v9.0.

La transformación de Rutina de base de datos actúa como una correlación anidada, en la que puede conectar entradas para construir correlaciones para establecer los valores de los parámetros de entrada para la llamada de procedimiento almacenado . Los parámetros de entrada de la rutina se visualizan como salida de la correlación anidada Rutina de base de datos. No se puede conectar ninguna salida desde la transformación de Rutina de base de datos.

Utilice la transformación Return del grupo Transformación de la Rutina de base de datos para correlacionar los parámetros de salida, valores de retorno o Conjuntos de resultados que se generen al llamar la Rutina de base de datos. Puede conectar todas las entradas adicionales que desee correlacionar cuando la llamada de la Rutina de base de datos finalice correctamente. Los parámetros de salida, cualquier valor de retorno y los conjuntos de resultados devueltos que se definen para la Rutina de base de datos se proporcionan como entradas en la correlación Return anidada. Puede conectar la correlación Return con uno o varios elementos de salida hermanos para que los datos devueltos se puedan correlacionar con la salida de correlación.

Mediante el editor de correlaciones de datos gráficas, realice los pasos siguientes:

  1. Con un archivo de correlación de datos gráfica (.map) abierto en el editor de correlaciones de datos gráficas, pulse con el botón derecho del ratón en el lienzo y seleccione Base de datos > Llamar rutina de base de datos.
    • Como alternativa, seleccione un elemento (o elementos) de esquema como valor de parámetro de entrada. Opcionalmente, seleccione un elemento (o elementos) de esquema como valor de salida.
    • También puede utilizar la función de arrastrar y soltar para crear la transformación de Rutina de base de datos. Conecte el objeto de entrada con el objeto de salida, y se creará automáticamente una transformación. Seleccione la transformación y seleccione Rutina de base de datos de la lista Transformaciones.
    • También puede hacer clic en el icono Llamar un procedimiento almacenado en una base de datos.Icono Llamar un procedimiento almacenado en una base de datos
    Se visualiza el asistente de Rutina de base de datos.
  2. En el campo Base de datos, seleccione la base de datos desde la que desea llamar a la rutina. Para añadir un archivo de definición de base de datos, o para descubrir una nueva base de datos conectando IBM Integration Toolkit mediante JDBC con un servidor de base de datos, pulse Añadir base de datos.... Para obtener más información, consulte Crear una definición de base de datos utilizando el asistente Nuevo archivo de definición de base de datos. Debe seleccionar la opción Rutinas durante el proceso de descubrimiento. Para utilizar un nombre de base de datos en el tiempo de ejecución distinto del nombre utilizado en el kit de herramientas, puede sobrescribir este valor estableciendo la propiedad databaseName del servicio configurable JDBCProvider que define cómo conectarse a la base de datos; consulte Configuración de un proveedor JDBC para conexiones de tipo 4.
  3. En el campo Esquema, seleccione el esquema de base de datos que define el procedimiento almacenado que desea llamar desde la correlación. Para llamar al procedimiento almacenado desde un esquema de base de datos distinto en tiempo de ejecución, puede alterar temporalmente este valor estableciendo la propiedad databaseSchemaNames del servicio configurable JDBCProvider que define cómo conectarse a la base de datos; consulte Configuración de un proveedor JDBC para conexiones de tipo 4.
  4. En el campo Rutina, seleccione el procedimiento almacenado que desea llamar a la transformación de Rutina de base de datos en la correlación.
    1. Opcional: Si la rutina seleccionada puede devolver un valor, se visualizará el recuadro de selección Valor de retorno. Si desea que el valor de retorno esté disponible para correlación en la transformación Return, marque este recuadro.
    Nota: Entones, la Rutina seleccionada rellenará los siguientes campos bloqueados:
    • Tipo: indica si el tipo de la Rutina seleccionada es un procedimiento almacenado .
    • Parámetros: detalles de los nombres de parámetro, modo y tipo de la Rutina seleccionada.
    • Max ResultSets: si el archivo de definición de base de datos para la Rutina proporciona esta información, establecerá el número máximo de conjuntos de resultados. De lo contrario, estará en blanco.

    Estos campos se pueden visualizar pulsando Visualizar detalles de parámetros de rutina...

  5. Opcional: Seleccione Tratar aviso como error. Si esta opción está seleccionada y la llamada de la Rutina de base de datos en la base de datos de tiempo de ejecución configurada devuelve un aviso de SQL, se tratará como si la base de datos generara una excepción. Si la transformación Failure está presente, introducirá su correlación anidada. De lo contrario, se detendrá la ejecución de la correlación y se generará una excepción desde el nodo Mapping que ejecuta la correlación.
    Importante: Los avisos de base de datos son específicos de proveedor. Para obtener más información sobre los avisos de base de datos, consulte la documentación del producto de base de datos.
  6. Opcional: Si la Rutina seleccionada puede devolver conjuntos de resultados, y desea correlacionar valores de los mismos, deberá definir su orden y el contenido de las columnas.
    1. Si en el archivo de definición de base de datos se define el número de conjuntos de resultados, la Lista de conjuntos de resultados se prellenará con un Conjunto de resultados, y mostrará el número máximo que se puede devolver. Utilice los botones Añadir y Suprimir para rellenar la Lista de conjuntos de resultados hasta el número máximo definido en el archivo de definición de base de datos. Debe ordenar los conjuntos de resultados como se define en el código de la Rutina de base de datos. Si sólo desea correlacionar datos de, por ejemplo, el segundo conjunto de resultados, debe incluir el primer conjunto de resultados en la tabla porque se accede a ellos por su orden posicional.
    2. Seleccione cada uno de los conjuntos de resultados y utilice los recuadros de selección de las Columnas de tabla disponibles para añadir definiciones de columna al conjunto de resultados para que coincidan con lo que devuelve la Rutina de base de datos. Sólo es necesario definir las columnas del conjunto de resultados que desea que estén disponibles para la correlación.
  7. Pulse Aceptar. La Rutina de base de datos y su transformación Return agrupada se visualizan en la correlación de datos gráfica. Si ha realizado selecciones en la entrada/salida de correlación, todas las entradas seleccionadas se conectarán a la Rutina de base de datos, y las salidas se conectarán a la transformación Return. Si no ha realizado selecciones, la nueva transformación aparecerá en la correlación desconectada.
  8. Proporcione los valores necesarios para los parámetros de modalidad IN e INOUT para la Rutina de base de datos. Los parámetros de entrada para el procedimiento almacenado seleccionado se visualizan como salidas de la transformación anidada Rutina de base de datos.
    1. Conecte los elementos de entrada necesarios a la Rutina de base de datos, y en la correlación anidada proporcione transformaciones para establecer un valor para cada parámetro. La Rutina de base de datos sólo se registra una vez, realizando una llamada al sistema de base de datos. Debe establecer la cardinalidad para los elementos repetitivos que están conectados a la transformación de Rutina de base de datos, o utilice una transformación de función para proporcionar un valor individual al parámetro.
      Nota: si no se proporciona ningún valor a algún parámetro, es posible que el servidor de base de datos devuelva una excepción si no puede proporcionar un valor predeterminado. Si el valor de salida resultante de las transformaciones que establecen los parámetros no es el tipo correcto para la Rutina de base de datos, o el contenido no es válido, por ejemplo, porque excede una longitud máxima, podría producirse una excepción de base de datos.
  9. Proporcione la correlación necesaria para los elementos de salida desde los datos devueltos de la Rutina de base de datos. Estos datos pueden incluir los parámetros de modalidad OUT e INOUT, valores de retorno de la Rutina opcionales y uno o varios conjuntos de resultados. Los resultados de la Rutina se visualizan como entradas en la transformación Return anidada.
    1. Opcional: conecte los elementos de entrada adicionales que deba tener fusionados con los datos de la Rutina de base de datos a la transformación Return. Conecte la transformación Return con uno o varios elementos de salida de la correlación. Proporcione transformaciones dentro de la correlación Return anidada para establecer las salidas conectadas desde los valores de salida de la Rutina de base de datos proporcionados.
A continuación:
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        Última actualización:
        
        Última actualización: 2013-07-16 12:54:55


Tema de tareaTema de tarea | IBM Integration Bus Versión 9.0.0.0 | cm28838_