Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Se aplica a: Azure Logic Apps (Consumo + Estándar)
Cuando tu flujo de trabajo automatizado de integración necesite funcionar con recursos de tu base de datos DB2, utiliza un conector DB2 para realizar operaciones en tu base de datos. Por ejemplo, tu flujo de trabajo puede listar tablas o filas, añadir filas, actualizar filas, eliminar filas, ejecutar consultas y ejecutar procedimientos almacenados. Estas acciones pueden devolver datos de la base de datos para que otras acciones del flujo de trabajo los utilicen.
Azure Logic Apps ofrece las siguientes versiones de conectores DB2:
- Conector administrado: Disponible para flujos de trabajo de tipo consumo y estándar. Para un servidor DB2 local, este conector requiere la pasarela de datos local.
- Conector integrado: Disponible solo para flujos de trabajo estándar. Este conector se ejecuta en proceso con el runtime de Azure Logic Apps y se conecta directamente a DB2 a través de TCP/IP sin la pasarela de datos local.
Ambas versiones se comunican con servidores DB2 remotos a través de una red TCP/IP. Puedes usar cualquiera de las dos versiones para acceder a bases de datos en la nube como IBM DB2 para Windows que se ejecutan en virtualización en Azure.
Importante
Para sistemas críticos que utilizan flujos de trabajo estándar, utiliza el conector integrado. El conector integrado evita la dependencia adicional de la puerta de enlace y proporciona las ventajas de rendimiento y capacidad de procesamiento al ejecutarse en proceso con el entorno de ejecución de Azure Logic Apps. Utiliza el conector gestionado cuando necesites sus operaciones específicas o cuando utilices un flujo de trabajo de Consumo.
Esta guía describe las operaciones y la configuración de conexión para ambas versiones de conectores.
Versiones y plataformas compatibles
El conector DB2 admite las siguientes plataformas y versiones de IBM DB2 junto con productos compatibles con IBM DB2 que admiten las versiones 10 y 11 de SQL Access Manager (DRDA) de Arquitectura de bases de datos relacionales distribuidas (DRDA):
| Plataforma | Versión |
|---|---|
| IBM DB2 para z/OS | 12, 11.1, 10.1 |
| IBM DB2 para i | 7.4, 7.3, 7.2, 7.1 |
| IBM DB2 para LUW | 11,5, 11,1, 10,5 |
Referencia técnica del conector
El conector DB2 tiene diferentes versiones, según el tipo de aplicación lógica y el entorno del host.
| Logic App | Medio ambiente | Versión de conexión |
|---|---|---|
| Consumo | Azure Logic Apps multiinquilino | Conector gestionado, que aparece en la galería bajo el filtro Compartido. Este conector proporciona únicamente acciones, no desencadenadores. Para un servidor DB2 local, el conector gestionado requiere la pasarela de datos local. Para más información, consulte la siguiente documentación: - Referencia de conectores administrados de DB2 - Conectores administrados en Azure Logic Apps |
| Standard | Plan de Servicio de Flujo de Trabajo, App Service Environment v3 (ASE v3 solo con planes de Windows) y despliegue híbrido en Kubernetes habilitado para Azure Arc | Conector administrado, que aparece en la galería de conectores en el filtro Compartido y el conector integrado, que aparece en la galería de conectores en el filtro integrado y se basa en el proveedor de servicios. Ambas versiones solo ofrecen acciones, no disparadores. Para cargas de trabajo críticas, utiliza el conector integrado, que se ejecuta en proceso con el runtime de Azure Logic Apps y se conecta directamente a DB2 por TCP/IP sin la pasarela de datos local. Para más información, consulte la siguiente documentación: - Referencia de conectores administrados de DB2 - Referencia de conector integrado DB2 - Conectores integrados en Azure Logic Apps |
Operaciones de conectores administrados
El conector gestionado DB2 soporta las siguientes 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 | Eliminar fila |
Para más información sobre el conector gestionado y estas acciones, consulte la referencia de conectores gestionados DB2.
Operaciones de conectores integradas
El conector integrado DB2 soporta las siguientes acciones:
| Action | Descripción |
|---|---|
| Tablas DB2 | Tablas de retorno en un esquema DB2. |
| Eliminar fila | Elimina una o más filas. |
| Ejecución de un procedimiento almacenado | Ejecuta un procedimiento almacenado y devuelve la salida. |
| Ejecutar comando sin consulta | Ejecuta una instrucción SQL que no devuelva un conjunto de resultados. |
| Ejecutar consulta | Ejecuta una consulta SQL y devuelve el conjunto de resultados. |
| Insertar fila | Inserta una fila en una tabla DB2. |
| Actualizar filas | Actualiza una o más filas en una tabla DB2. |
Para más información sobre el conector incorporado y estas acciones, consulte la referencia de conector integrado DB2.
Requisitos previos
Una cuenta y una suscripción de Azure. Obtenga una cuenta gratuita de Azure.
Una base de datos IBM DB2, ya sea basada en la nube o local.
El recurso y el flujo de trabajo de la aplicación lógica desde donde desea acceder a la base de datos DB2.
El conector DB2 solo proporciona acciones. Si tiene un flujo de trabajo vacío, primero debe agregar un desencadenador que funcione mejor para su escenario.
En los ejemplos de esta guía se utiliza el desencadenador Recurrence.
Para obtener más información, consulte:
Los requisitos de conexión dependen de la versión del conector:
Conector gestionado: Para conectarse a una base de datos DB2 local, primero instala y configura la pasarela de datos local. La pasarela no es necesaria cuando el servidor DB2 está disponible públicamente o es accesible en Azure.
Conector integrado: No se requiere la pasarela de datos local. El entorno de alojamiento de aplicaciones de lógica estándar necesita acceso en red al servidor y puerto DB2.
Añadir una acción gestionada de conector DB2
El siguiente ejemplo utiliza el conector gestionado DB2 y muestra cómo añadir la acción Get tables . Para usar el conector integrado con un flujo de trabajo Estándar, selecciona Integrado en la galería de conectores y luego selecciona una acción integrada de DB2, como tablas DB2.
Nota:
Los pasos para agregar cualquier otra acción de DB2 son similares, excepto los parámetros y valores de la acción que proporcione.
En Azure Portal, abra el recurso de la aplicación lógica y el flujo de trabajo en el diseñador.
Siga los pasos generales para agregar la acción DB2 denominada Obtener tablas.
Se abre el panel de información de conexión para que pueda proporcionar detalles para conectar la base de datos DB2.
Siga los pasos para crear una conexión para una base de datos basada en la nube o una base de datos local y, a continuación, vuelva aquí para continuar.
Después de crear correctamente la conexión, aparece el panel de información de la acción Get tables y muestra que no es necesaria ninguna otra información.
Continúe con Probar el flujo de trabajo y ver las tablas de salida.
Configura una conexión para el conector gestionado DB2
Siga los pasos en función de si tiene una base de datos db2 local o en la nube. Después de proporcionar los detalles de conexión necesarios, seleccione Crear nuevo y vuelva a los pasos anteriores.
Antes de crear una conexión conectora gestionada a una base de datos local, asegúrate de instalar y configurar la pasarela de datos local. Este requisito de pasarela no se aplica al conector integrado.
| Propiedad | Obligatorio | Descripción |
|---|---|---|
| Conexión mediante puerta de enlace local | No | Solo se aplica a las conexiones locales. |
| Nombre de la conexión | Sí | Nombre de la conexión, por ejemplo, DB2-connection. |
| Servidor | Sí | La dirección o alias y el número de puerto de tu servidor DB2, por ejemplo, myDB2server.example.com: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 IBM DB2 para la ubicación z/OS . - DB2 para i 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 | Sí | Nombre de usuario de la base de datos. Nota: Este valor es una cadena cuya longitud se basa en una 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 | Sí | Contraseña de la base de datos. |
Por ejemplo:
Configura una conexión para el conector integrado del DB2
Para flujos de trabajo estándar críticos, utiliza el conector integrado. El conector integrado se conecta directamente desde el runtime de Azure Logic Apps a tu servidor DB2 vía TCP/IP y no utiliza la pasarela de datos local. Asegúrate de que el entorno de alojamiento de la app de lógica estándar tenga acceso en red al servidor y puerto DB2.
En el diseñador de flujo de trabajo, selecciona Incorporado, selecciona la acción DB2 que quieres y crea una conexión. Proporciona la siguiente información aplicable a tu entorno DB2:
| Propiedad | Descripción |
|---|---|
| Nombre de la conexión | Nombre de la conexión. |
| Nombre de servidor | El nombre del servidor DB2. |
| Número de puerto | El número de puerto de la base de datos en el servidor DB2. |
| Base de datos | El nombre de la base de datos en el servidor DB2. |
| Nombre de usuario | El nombre de usuario para acceder al servidor DB2. |
| Contraseña | La contraseña del nombre de usuario DB2. |
| Colección de paquetes | La colección de paquetes. Si está vacío, se usa por defecto el nombre de usuario. |
| Esquema predeterminado | El esquema predeterminado para las llamadas de esquema toma por defecto el nombre de usuario si está vacío. |
| CCSID del host | El identificador de conjunto de caracteres codificado por host (CCSID) para la base de datos DB2 se configura por defecto en 1208 si está vacío. |
| Página de códigos de PC | La página de códigos del PC para la conexión DB2 por defecto es 1208 si está vacía. |
| Palabras clave adicionales de cadena de conexión | Palabras clave opcionales de cadena de conexión, separadas por puntos y coma. |
| Cadena de conexión | La cadena de conexión de DB2, que si no está vacía, el resto de las propiedades se ignoran. |
Prueba del flujo de trabajo y visualización de tablas de salida
El siguiente ejemplo muestra el resultado de la acción Obtener tablas del conector gestionado. Puedes probar un flujo de trabajo que use una acción de conector integrada de la misma manera. Para ejecutar manualmente el flujo de trabajo, en la barra de herramientas del diseñador, en la lista Ejecutar , seleccione Ejecutar. Una vez finalizado el flujo de trabajo, puede ver los resultados de la ejecución.
Si la página de detalles de ejecución no se abre, siga estos pasos en función de la aplicación lógica:
Consumo: en la barra lateral de la aplicación lógica, en Herramientas de desarrollo, seleccione Diseñador de aplicaciones lógicas.
Estándar: en la barra lateral del flujo de trabajo, seleccione Historial de ejecuciones.
En la lista Historial de ejecuciones , seleccione la ejecución de flujo de trabajo más reciente, por ejemplo:
Consumo
Standard
En la página de detalles de ejecución, revise el estado de cada paso del flujo de trabajo. Para ver las entradas y salidas de cada paso, seleccione ese paso, por ejemplo:
Para ver las entradas en JSON, seleccione Mostrar entradas sin procesar.
Para ver las salidas en JSON, seleccione Mostrar salidas sin procesar.
Las salidas incluyen una lista de tablas, por ejemplo:
