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
En Azure Portal, abra la aplicación lógica en el diseñador de aplicaciones lógicas, si aún no lo ha hecho.
En el desencadenador, elija New step (Nuevo paso).
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)
Ahora se le pedirá que proporcione los detalles de conexión para la base de datos de DB2.
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 | Sí | El nombre de la conexión; por ejemplo, "MyLogicApp-DB2-connection" |
Server | Sí | 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 | Sí | 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". |
Nombre de usuario | Sí | 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. |
Contraseña | Sí | La contraseña de la base de datos |
Por ejemplo:
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 | Sí | Se aplica cuando se desea una conexión local y se muestra las propiedades de la conexión local. |
Nombre de la conexión | Sí | El nombre de la conexión; por ejemplo, "MyLogicApp-DB2-connection" |
Server | Sí | 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 | Sí | 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". |
Autenticación | Sí | 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 | Sí | 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. |
Contraseña | Sí | La contraseña de la base de datos |
Gateway | Sí | 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:
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.
En el menú de la aplicación lógica, seleccione Introducción.
En Resumen, en la sección Historial de ejecuciones, seleccione la ejecución más reciente, que es el primer elemento de la lista.
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.
Para ver las entradas, elija Mostrar entradas sin procesar.
Para ver las salidas, elija Mostrar salidas sin procesar.
Las salidas incluyen una lista de tablas.
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'
.
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:
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 Sí La tabla que tiene el registro deseado, como "AREA" en este ejemplo Id. de área Sí El identificador del registro que desee, como "99999" en este ejemplo 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.
En el menú de la aplicación lógica, seleccione Introducción.
En Resumen, en la sección Historial de ejecuciones, seleccione la ejecución más reciente, que es el primer elemento de la lista.
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.
Para ver las entradas, elija Mostrar entradas sin procesar.
Para ver las salidas, elija Mostrar salidas sin procesar.
Las salidas incluyen la fila especificada.
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
.
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:
Abra la lista Nombre de tabla y luego seleccione la tabla que desee, que es "AREA" en este ejemplo:
Para especificar un filtro o consultar resultados, elija Mostrar opciones avanzadas.
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.
En el menú de la aplicación lógica, seleccione Introducción.
En Resumen, en la sección Historial de ejecuciones, seleccione la ejecución más reciente, que es el primer elemento de la lista.
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.
Para ver las entradas, elija Mostrar entradas sin procesar.
Para ver las salidas, elija Mostrar salidas sin procesar.
Las salidas incluyen todos los registros de la tabla especificada.
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)
.
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:
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 Sí La tabla a la que agregar el registro, como "AREA" Id. de área Sí El identificador del área que se va a agregar, como "99999" Descripción del área Sí La descripción del área que se va a agregar, como "Area 99999" Id. de región Sí El identificador de la región que se va a agregar, como "102" Por ejemplo:
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.
En el menú de la aplicación lógica, seleccione Introducción.
En Resumen, en la sección Historial de ejecuciones, seleccione la ejecución más reciente, que es el primer elemento de la lista.
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.
Para ver las entradas, elija Mostrar entradas sin procesar.
Para ver las salidas, elija Mostrar salidas sin procesar.
Las salidas incluyen el registro agregado a la tabla especificada.
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)
.
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:
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 Sí La tabla en la que actualizar el registro, como "AREA" Id. de fila Sí Identificador del registro que se va a actualizar, como "99999" Id. de área Sí El nuevo identificador de área, como "99999" Descripción del área Sí La nueva descripción del área, como "Updated 99999" Id. de región Sí El nuevo identificador de región, como "102" Por ejemplo:
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.
En el menú de la aplicación lógica, seleccione Introducción.
En Resumen, en la sección Historial de ejecuciones, seleccione la ejecución más reciente, que es el primer elemento de la lista.
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.
Para ver las entradas, elija Mostrar entradas sin procesar.
Para ver las salidas, elija Mostrar salidas sin procesar.
Las salidas incluyen el registro actualizado en la tabla especificada.
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'
.
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:
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 Sí La tabla de la que eliminar el registro, como "AREA" Id. de fila Sí Identificador del registro que se va a eliminar, como "99999" Por ejemplo:
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.
En el menú de la aplicación lógica, seleccione Introducción.
En Resumen, en la sección Historial de ejecuciones, seleccione la ejecución más reciente, que es el primer elemento de la lista.
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.
Para ver las entradas, elija Mostrar entradas sin procesar.
Para ver las salidas, elija Mostrar salidas sin procesar.
Las salidas ya no incluyen el registro eliminado de la tabla especificada.
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.