Conectarse a Oracle Database desde Azure Logic Apps

Artículo
01/04/2024

Se aplica a: Azure Logic Apps (consumo)

Mediante el conector de una base de datos de Oracle, crea flujos de trabajo organizativos que utilizan datos de la base de datos existente. Este conector puede conectarse a una base de datos de Oracle local o a una máquina virtual de Azure con una base de datos de Oracle instalada. Con este conector, puede hacer lo siguiente:

Agregue un nuevo cliente a una base de datos de clientes o actualice un pedido en una base de datos de pedidos para crear el flujo de trabajo.
Use acciones para obtener una fila de datos, insertar una fila nueva e incluso eliminarla. Por ejemplo, al crear un registro en Dynamics CRM Online (un desencadenador), inserte una fila en una base de datos de Oracle (una acción).

Este conector no admite los elementos siguientes:

Todas las tablas con claves compuestas
Tipos de objetos anidados en tablas
Funciones de base de datos con valores no escalares

Este artículo le muestra cómo usar el conector de una base de datos de Oracle en una aplicación lógica.

Requisitos previos

Versiones de Oracle compatibles:
- Oracle 9 y versiones posteriores
- Oracle Data Access Client (ODAC) 11.2 y versiones posteriores
Instalar la puerta de enlace de datos local Puede ver los pasos en Conexión a datos locales desde aplicaciones lógicas. Esta puerta de enlace puede conectarse a una base de datos de Oracle local o a una VM de Azure con una base de datos de Oracle instalada.

Nota:

La puerta de enlace de datos local actúa como un puente, proporcionando una transferencia de datos segura entre los datos locales (datos que no están en la nube) y las aplicaciones lógicas. La misma puerta de enlace se puede utilizar con varios servicios y varios orígenes de datos. Por lo tanto, solo debe instalar la puerta de enlace una vez.
Instale el cliente Oracle en la misma máquina en la que instaló la puerta de enlace de datos local. Asegúrese de instalar el proveedor de datos de Oracle de 64 bits para .NET desde Oracle y seleccione la versión del instalador de Windows, ya que la versión xcopy no funciona con la puerta de enlace de datos local:

64-bits ODAC 12c versión 4 (12.1.0.2.4) para Windows x64

Sugerencia

Si no se instala el cliente Oracle, se producirá un error cuando intente crear o usar la conexión. Consulte los errores comunes en este artículo.

Agregar el conector

Importante

Este conector no tiene ningún desencadenador. Solo tiene acciones. Por lo tanto, cuando cree la aplicación lógica, agregue otro desencadenador para iniciar la aplicación lógica, como Programación: periodicidad o Solicitud/Respuesta: respuesta.

En Azure Portal, cree una aplicación lógica en blanco.
Al principio de la aplicación lógica, seleccione el desencadenador Solicitud/Respuesta: respuesta:
Seleccione Guardar. Cuando lo guarde, se generará automáticamente la URL de solicitud.
Seleccione Nuevo paso y seleccione Agregar una acción. Escriba en oracle para ver las acciones disponibles:

Sugerencia

Esta también es la forma más rápida para ver los desencadenadores y las acciones disponibles para cualquier conector. Escriba parte del nombre del conector, como oracle. El diseñador muestra todos los desencadenadores y las acciones.
Seleccione una de las acciones, como Base de datos de Oracle: obtener fila. Seleccione Connect via on-premises data gateway (Conectarse a través de la puerta de enlace de datos local). Escriba el nombre del servidor de Oracle, el método de autenticación, el nombre de usuario, la contraseña y seleccione la puerta de enlace:
Una vez conectado, seleccione una tabla de la lista y escriba el ID de la fila en la tabla. Debe conocer el identificador de la tabla. Si no lo sabe, póngase en contacto con el administrador de la base de datos de Oracle y obtenga el resultado de select * from yourTableName. Esto le ofrece la información de identificación que necesita para continuar.

En el ejemplo siguiente, se devuelven los datos de trabajo de una base de datos de recursos humanos:
En este paso, puede usar cualquiera de los demás conectores para crear el flujo de trabajo. Si desea probar la obtención de datos de Oracle, envíese un correo con los datos de Oracle mediante uno de los conectores de envío de correo electrónico, como Office 365 Outlook. Use los tokens dinámicos de la tabla de Oracle para generar el Subject y Body de su correo electrónico:
Guarde la aplicación lógica y, a continuación, seleccione Ejecutar. Cierre el diseñador y observe el historial de ejecuciones para el estado. Si se produce un error, seleccione la fila del mensaje con errores. El diseñador se abre y muestra en qué paso se produjo el error. También muestra la información de error. Si se realiza correctamente, debería recibir un correo electrónico con la información que agregó.

Ideas de flujo de trabajo

Le recomendamos supervisar el hashtag #oracle y poner los tweets en una base de datos para que se pueden consultar y usar en otras aplicaciones. En una aplicación lógica, agregue el desencadenador Twitter - When a new tweet is posted y escriba el hashtag #oracle. A continuación, agregue la acción Oracle Database - Insert row y seleccione la tabla:
Los mensajes se envían a la cola de Service Bus. Le recomendamos recibir estos mensajes y colocarlos en una base de datos. En una aplicación lógica, agregue el desencadenador Service Bus - when a message is received in a queue y seleccione la cola. A continuación, agregue la acción Oracle Database - Insert row y seleccione la tabla:

Errores comunes

Error: No se puede alcanzar la puerta de enlace

Causa: La puerta de enlace de datos local no puede conectarse con la nube.

Mitigación: Asegúrese de que la puerta de enlace se esté ejecutando en el equipo local donde la instaló y que se pueda conectar a Internet. Se recomienda no instalar la puerta de enlace en un equipo que pueda apagarse o suspenderse. También puede reiniciar el servicio de la puerta de enlace de datos local (PBIEgwService).

Error: El proveedor que está usando está en desuso: 'System.Data.OracleClient requiere la versión 8.1.7 del software cliente de Oracle o una versión posterior'. Vea https://go.microsoft.com/fwlink/p/?LinkID=272376 para instalar el proveedor oficial.

Causa: El SDK del cliente Oracle no está instalado en la misma máquina en la que se ejecuta la puerta de enlace de datos local.

Resolución: Descargue e instale el SDK del cliente Oracle en la misma máquina que la puerta de enlace de datos local.

Error: La tabla '[Tablename]' no define las columnas clave.

Causa: La tabla no tiene ninguna clave principal.

Resolución: El conector de la base de datos de Oracle requiere que se utilice una tabla con una columna de clave principal.

Detalles específicos del conector

Vea los desencadenadores y las acciones definidos en Swagger y vea también todos los límites en los detalles del conector.

Obtener ayuda

La página de preguntas y respuestas de Microsoft sobre Azure Logic Apps es un excelente lugar para formular preguntas, o responderlas, y ver lo que hacen otros usuarios de Logic Apps.

Puede ayudar a mejorar Logic Apps y conectores al votar y enviar sus ideas en https://aka.ms/logicapps-wish.