Acceso y administración de recursos de IBM DB2 mediante el uso de Azure Logic Apps

Se aplica a: Azure Logic Apps (consumo)

Con Azure Logic Apps y el conector de IBM DB2, puede crear tareas y flujos de trabajo automatizados en función de los recursos almacenados en la base de datos de DB2. Los flujos de trabajo pueden conectarse a los recursos de la base de datos, leer y enumerar las tablas de base de datos, agregar filas, cambiar filas, eliminar filas y mucho más. Puede incluir acciones en las aplicaciones lógicas que obtengan respuestas de la base de datos y que permitan que la salida esté disponible para otras acciones.

En este artículo se explica cómo puede crear una aplicación lógica que lleve a cabo diversas operaciones de base de datos. Si no está familiarizado con las aplicaciones lógicas, consulte ¿Qué es Azure Logic Apps?

Versiones y plataformas compatibles

El conector de DB2 incluye un cliente de Microsoft para comunicarse con servidores de DB2 remotos a través de una red TCP/IP. Puede usar este conector para acceder a bases de datos en la nube, como IBM DB2 para Windows, que se ejecutan en la plataforma de virtualización de Azure. También puede acceder a bases de datos de DB2 locales después de instalar y configurar la puerta de enlace de datos local.

El conector de IBM DB2 admite las siguientes plataformas y versiones de IBM DB2, así como los productos compatibles de este, que admiten las versiones 10 y 11 de SQL Access Manager (SQLAM) de la arquitectura distribuida de bases de datos relacionales (DRDA):

Plataforma Versión
IBM DB2 para z/OS 12, 11.1, 10.1
IBM DB2 para i 7.3, 7.2, 7.1
IBM DB2 para LUW 11, 10.5

Operaciones compatibles de base de datos

El conector de IBM DB2 admite estas operaciones de base de datos, que se asignan a las acciones correspondientes en el conector:

Operación de base de datos Acción del conector
Mostrar tablas de base de datos Obtener tablas
Leer una fila mediante SELECT Obtener fila
Leer todas las filas mediante SELECT Obtener filas
Agregar una fila mediante INSERT Insertar fila
Editar una fila mediante UPDATE Actualizar fila
Quitar una fila mediante DELETE Delete row

Requisitos previos

  • Una cuenta y una suscripción de Azure. Si no tiene una suscripción de Azure, regístrese para obtener una cuenta gratuita de Azure.

  • Una base de datos de IBM DB2, ya sea local o en la nube

  • Conocimientos básicos acerca de cómo crear aplicaciones lógicas. Para obtener más información, consulte Creación de un flujo de trabajo de aplicación lógica de consumo de ejemplo.

  • La aplicación lógica donde quiere acceder a la base de datos de DB2. Este conector ofrece únicamente las acciones, por lo que, para iniciar la aplicación lógica, debe seleccionar un desencadenador independiente, por ejemplo, el de periodicidad. Los ejemplos de este artículo usan el desencadenador de periodicidad.

Adición de acción de DB2: Obtener tablas

  1. En Azure Portal, abra la aplicación lógica en el diseñador de aplicaciones lógicas, si aún no lo ha hecho.

  2. En el desencadenador, elija New step (Nuevo paso).

  3. En el cuadro de búsqueda, escriba "db2" como filtro. En este ejemplo, en la lista de acciones, seleccione esta acción: Obtener tablas (versión preliminar)

    Select action

    Ahora se le pedirá que proporcione los detalles de conexión para la base de datos de DB2.

  4. Siga estos pasos para crear conexiones para las bases de datos en la nube o las bases de datos locales.

Conexión a DB2 en la nube

Para establecer la conexión, proporcione estos detalles de conexión cuando se le solicite, elija Crear y después guarde la aplicación lógica:

Propiedad Obligatorio Descripción
Conexión mediante puerta de enlace local No Solo se aplica a conexiones locales.
Nombre de la conexión El nombre de la conexión; por ejemplo, "MyLogicApp-DB2-connection"
Server Número de puerto de dos puntos de dirección o alias para el servidor DB2, por ejemplo, "myDB2server.cloudapp.net:50000"

Nota: Este valor es una cadena que representa una dirección TCP/IP o alias en formato IPv4 o IPv6, seguido de dos puntos y un número de puerto TCP/IP.

Base de datos Nombre de la base de datos

Nota: Este valor es una cadena que representa un nombre de base de datos relacional de DRDA (RDBNAM):

- DB2 para z/OS acepta una cadena de 16 bytes, donde la base de datos se conoce como una ubicación "IBM DB2 para z/OS".
- DB2 para DB2/OS acepta una cadena de 18 bytes, donde la base de datos se conoce como una base de datos relacional "IBM DB2 para i".
- DB2 para LUW acepta una cadena de 8 bytes.

Nombre de usuario Nombre de usuario de la base de datos

Nota: Este valor es una cadena cuya longitud se basa en la base de datos específica:

- DB2 para z/OS acepta una cadena de 8 bytes.
- DB2 para i acepta una cadena de 10 bytes.
- DB2 para Linux o UNIX acepta una cadena de 8 bytes.
- DB2 para Windows acepta una cadena de 30 bytes.

Contraseña La contraseña de la base de datos

Por ejemplo:

Connection details for cloud-based databases

Conexión a DB2 local

Antes de crear la conexión, ya debe tener la puerta de enlace de datos local instalada. En caso contrario, no puede terminar de configurar la conexión. Si ya dispone de la instalación de la puerta de enlace, proporcione estos detalles de conexión y después elija Crear.

Propiedad Obligatorio Descripción
Conexión mediante puerta de enlace local Se aplica cuando se desea una conexión local y se muestra las propiedades de la conexión local.
Nombre de la conexión El nombre de la conexión; por ejemplo, "MyLogicApp-DB2-connection"
Server Número de puerto de dos puntos de dirección o alias para el servidor DB2, por ejemplo, "myDB2server:50000"

Nota: Este valor es una cadena que representa una dirección TCP/IP o alias en formato IPv4 o IPv6, seguido de dos puntos y un número de puerto TCP/IP.

Base de datos Nombre de la base de datos

Nota: Este valor es una cadena que representa un nombre de base de datos relacional de DRDA (RDBNAM):

- DB2 para z/OS acepta una cadena de 16 bytes, donde la base de datos se conoce como una ubicación "IBM DB2 para z/OS".
- DB2 para DB2/OS acepta una cadena de 18 bytes, donde la base de datos se conoce como una base de datos relacional "IBM DB2 para i".
- DB2 para LUW acepta una cadena de 8 bytes.

Autenticación El tipo de autenticación de la conexión, por ejemplo, "Básico"

Nota: Seleccione este valor en la lista, que incluye Basic o Windows (Kerberos).

Nombre de usuario Nombre de usuario de la base de datos

Nota: Este valor es una cadena cuya longitud se basa en la base de datos específica:

- DB2 para z/OS acepta una cadena de 8 bytes.
- DB2 para i acepta una cadena de 10 bytes.
- DB2 para Linux o UNIX acepta una cadena de 8 bytes.
- DB2 para Windows acepta una cadena de 30 bytes.

Contraseña La contraseña de la base de datos
Gateway El nombre de la puerta de enlace de datos local instalada

Nota: Seleccione este valor en la lista, que incluye todas las puertas de enlace de datos instaladas en el grupo de recursos y las suscripciones de Azure.

Por ejemplo:

Connection details for on-premises databases

Visualización de las tablas de salida

Para ejecutar manualmente la aplicación lógica, en la barra de herramientas del diseñador, elija Ejecutar. Cuando finalice la ejecución de la aplicación lógica, puede ver la salida de la ejecución.

  1. En el menú de la aplicación lógica, seleccione Introducción.

  2. En Resumen, en la sección Historial de ejecuciones, seleccione la ejecución más reciente, que es el primer elemento de la lista.

    View run history

  3. En Ejecución de aplicación lógica, ahora puede revisar el estado, las entradas y las salidas para cada paso de la aplicación lógica. Expanda la acción Obtener tablas.

    Expand action

  4. Para ver las entradas, elija Mostrar entradas sin procesar.

  5. Para ver las salidas, elija Mostrar salidas sin procesar.

    Las salidas incluyen una lista de tablas.

    View output tables

Obtener fila

Para capturar un registro de una tabla de base de datos de DB2, use la acción Obtener fila en la aplicación lógica. Esta acción ejecuta una instrucción SELECT WHERE de DB2; por ejemplo, SELECT FROM AREA WHERE AREAID = '99999'.

  1. Si nunca antes ha usado las acciones de DB2 en la aplicación lógica, revise los pasos de la sección Adición de acción de DB2: Obtener tablas, pero, en su lugar, agregue la acción Obtener fila y luego vuelva aquí para continuar.

    Después de agregar la acción Obtener fila, esta será la apariencia de la aplicación lógica de ejemplo:

    Get row action

  2. Especifique los valores de todas las propiedades obligatorias (*). Después de seleccionar una tabla, la acción muestra las propiedades pertinentes que son específicas de los registros de esa tabla.

    Propiedad Obligatorio Descripción
    Nombre de la tabla La tabla que tiene el registro deseado, como "AREA" en este ejemplo
    Id. de área El identificador del registro que desee, como "99999" en este ejemplo

    Screenshot that shows the

  3. Cuando esté listo, elija Guardar en la barra de herramientas del diseñador.

Visualización de la fila de salida

Para ejecutar manualmente la aplicación lógica, en la barra de herramientas del diseñador, elija Ejecutar. Cuando finalice la ejecución de la aplicación lógica, puede ver la salida de la ejecución.

  1. En el menú de la aplicación lógica, seleccione Introducción.

  2. En Resumen, en la sección Historial de ejecuciones, seleccione la ejecución más reciente, que es el primer elemento de la lista.

  3. En Ejecución de aplicación lógica, ahora puede revisar el estado, las entradas y las salidas para cada paso de la aplicación lógica. Expanda la acción Obtener fila.

  4. Para ver las entradas, elija Mostrar entradas sin procesar.

  5. Para ver las salidas, elija Mostrar salidas sin procesar.

    Las salidas incluyen la fila especificada.

    View output row

Obtener filas

Para capturar todos los registros de una tabla de base de datos de DB2, use la acción Obtener filas en la aplicación lógica. Esta acción ejecuta una instrucción SELECT de DB2; por ejemplo, SELECT * FROM AREA.

  1. Si nunca antes ha usado las acciones de DB2 en la aplicación lógica, revise los pasos de la sección Adición de acción de DB2: Obtener tablas, pero, en su lugar, agregue la acción Obtener filas y luego vuelva aquí para continuar.

    Después de agregar la acción Obtener filas, esta será la apariencia de la aplicación lógica de ejemplo:

    Get rows action

  2. Abra la lista Nombre de tabla y luego seleccione la tabla que desee, que es "AREA" en este ejemplo:

    Screenshot that shows the

  3. Para especificar un filtro o consultar resultados, elija Mostrar opciones avanzadas.

  4. Cuando esté listo, elija Guardar en la barra de herramientas del diseñador.

Visualización de filas de salida

Para ejecutar manualmente la aplicación lógica, en la barra de herramientas del diseñador, elija Ejecutar. Cuando finalice la ejecución de la aplicación lógica, puede ver la salida de la ejecución.

  1. En el menú de la aplicación lógica, seleccione Introducción.

  2. En Resumen, en la sección Historial de ejecuciones, seleccione la ejecución más reciente, que es el primer elemento de la lista.

  3. En Ejecución de aplicación lógica, ahora puede revisar el estado, las entradas y las salidas para cada paso de la aplicación lógica. Expanda la acción Obtener filas.

  4. Para ver las entradas, elija Mostrar entradas sin procesar.

  5. Para ver las salidas, elija Mostrar salidas sin procesar.

    Las salidas incluyen todos los registros de la tabla especificada.

    View output rows

Insertar fila

Para agregar un único registro de una tabla de base de datos de DB2, use la acción Insertar fila en la aplicación lógica. Esta acción ejecuta una instrucción INSERT de DB2; por ejemplo, INSERT INTO AREA (AREAID, AREADESC, REGIONID) VALUES ('99999', 'Area 99999', 102).

  1. Si nunca antes ha usado las acciones de DB2 en la aplicación lógica, revise los pasos de la sección Adición de acción de DB2: Obtener tablas, pero, en su lugar, agregue la acción Insertar fila y luego vuelva aquí para continuar.

    Después de agregar la acción Insertar fila, esta será la apariencia de la aplicación lógica de ejemplo:

    Insert row action

  2. Especifique los valores de todas las propiedades obligatorias (*). Después de seleccionar una tabla, la acción muestra las propiedades pertinentes que son específicas de los registros de esa tabla.

    Para este ejemplo, estas son las propiedades:

    Propiedad Obligatorio Descripción
    Nombre de la tabla La tabla a la que agregar el registro, como "AREA"
    Id. de área El identificador del área que se va a agregar, como "99999"
    Descripción del área La descripción del área que se va a agregar, como "Area 99999"
    Id. de región El identificador de la región que se va a agregar, como "102"

    Por ejemplo:

    Screenshot that shows the Logic Apps Designer with the

  3. Cuando esté listo, elija Guardar en la barra de herramientas del diseñador.

Visualización de las salidas de Insertar filas

Para ejecutar manualmente la aplicación lógica, en la barra de herramientas del diseñador, elija Ejecutar. Cuando finalice la ejecución de la aplicación lógica, puede ver la salida de la ejecución.

  1. En el menú de la aplicación lógica, seleccione Introducción.

  2. En Resumen, en la sección Historial de ejecuciones, seleccione la ejecución más reciente, que es el primer elemento de la lista.

  3. En Ejecución de aplicación lógica, ahora puede revisar el estado, las entradas y las salidas para cada paso de la aplicación lógica. Expanda la acción Insertar fila.

  4. Para ver las entradas, elija Mostrar entradas sin procesar.

  5. Para ver las salidas, elija Mostrar salidas sin procesar.

    Las salidas incluyen el registro agregado a la tabla especificada.

    View output with inserted row

Actualizar fila

Para actualizar un único registro de una tabla de base de datos de DB2, use la acción Actualizar fila en la aplicación lógica. Esta acción ejecuta una instrucción UPDATE de DB2; por ejemplo, UPDATE AREA SET AREAID = '99999', AREADESC = 'Updated 99999', REGIONID = 102).

  1. Si nunca antes ha usado las acciones de DB2 en la aplicación lógica, revise los pasos de la sección Adición de acción de DB2: Obtener tablas, pero, en su lugar, agregue la acción Actualizar fila y luego vuelva aquí para continuar.

    Después de agregar la acción Actualizar fila, esta será la apariencia de la aplicación lógica de ejemplo:

    Update row action

  2. Especifique los valores de todas las propiedades obligatorias (*). Después de seleccionar una tabla, la acción muestra las propiedades pertinentes que son específicas de los registros de esa tabla.

    Para este ejemplo, estas son las propiedades:

    Propiedad Obligatorio Descripción
    Nombre de la tabla La tabla en la que actualizar el registro, como "AREA"
    Id. de fila Identificador del registro que se va a actualizar, como "99999"
    Id. de área El nuevo identificador de área, como "99999"
    Descripción del área La nueva descripción del área, como "Updated 99999"
    Id. de región El nuevo identificador de región, como "102"

    Por ejemplo:

    Screenshot that shows the Logic Apps Designer with the

  3. Cuando esté listo, elija Guardar en la barra de herramientas del diseñador.

Visualización de las salidas de Actualizar fila

Para ejecutar manualmente la aplicación lógica, en la barra de herramientas del diseñador, elija Ejecutar. Cuando finalice la ejecución de la aplicación lógica, puede ver la salida de la ejecución.

  1. En el menú de la aplicación lógica, seleccione Introducción.

  2. En Resumen, en la sección Historial de ejecuciones, seleccione la ejecución más reciente, que es el primer elemento de la lista.

  3. En Ejecución de aplicación lógica, ahora puede revisar el estado, las entradas y las salidas para cada paso de la aplicación lógica. Expanda la acción Actualizar fila.

  4. Para ver las entradas, elija Mostrar entradas sin procesar.

  5. Para ver las salidas, elija Mostrar salidas sin procesar.

    Las salidas incluyen el registro actualizado en la tabla especificada.

    View output with updated row

Delete row

Para eliminar un único registro de una tabla de base de datos de DB2, use la acción Eliminar fila en la aplicación lógica. Esta acción ejecuta una instrucción DELETE de DB2; por ejemplo, DELETE FROM AREA WHERE AREAID = '99999'.

  1. Si nunca antes ha usado las acciones de DB2 en la aplicación lógica, revise los pasos de la sección Adición de acción de DB2: Obtener tablas, pero, en su lugar, agregue la acción Eliminar fila y luego vuelva aquí para continuar.

    Después de agregar la acción Eliminar fila, esta será la apariencia de la aplicación lógica de ejemplo:

    Delete row action

  2. Especifique los valores de todas las propiedades obligatorias (*). Después de seleccionar una tabla, la acción muestra las propiedades pertinentes que son específicas de los registros de esa tabla.

    Para este ejemplo, estas son las propiedades:

    Propiedad Obligatorio Descripción
    Nombre de la tabla La tabla de la que eliminar el registro, como "AREA"
    Id. de fila Identificador del registro que se va a eliminar, como "99999"

    Por ejemplo:

    Screenshot that shows the Logic Apps Designer with the

  3. Cuando esté listo, elija Guardar en la barra de herramientas del diseñador.

Visualización de las salidas de Eliminar fila

Para ejecutar manualmente la aplicación lógica, en la barra de herramientas del diseñador, elija Ejecutar. Cuando finalice la ejecución de la aplicación lógica, puede ver la salida de la ejecución.

  1. En el menú de la aplicación lógica, seleccione Introducción.

  2. En Resumen, en la sección Historial de ejecuciones, seleccione la ejecución más reciente, que es el primer elemento de la lista.

  3. En Ejecución de aplicación lógica, ahora puede revisar el estado, las entradas y las salidas para cada paso de la aplicación lógica. Expanda la acción Eliminar fila.

  4. Para ver las entradas, elija Mostrar entradas sin procesar.

  5. Para ver las salidas, elija Mostrar salidas sin procesar.

    Las salidas ya no incluyen el registro eliminado de la tabla especificada.

    View output without deleted row

Referencia de conector

Si necesita más detalles técnicos sobre este conector, como los desencadenadores, las acciones y los límites que se describen en el archivo de Swagger del conector, vea la página de referencia del conector.

Nota:

En el caso de las aplicaciones lógicas de un entorno de servicio de integración (ISE), la versión con la etiqueta ISE de este conector usa en su lugar los límites de mensajes de ISE.

Pasos siguientes