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 los flujos de trabajo necesiten trabajar con datos de Oracle, conéctese a la base de datos de Oracle mediante el conector Oracle Database en Azure Logic Apps. Puede acceder a las bases de datos hospedadas en el entorno local o en una máquina virtual Azure.
El conector de Oracle Database le ayuda a resolver tareas comunes de integración de datos, como:
- Agregue registros de cliente a la base de datos.
- Actualice los registros de pedido en la base de datos.
- Obtenga, inserte o elimine filas de tabla como parte del flujo de trabajo.
Versiones admitidas de Oracle Database
En la tabla siguiente se enumeran las versiones de base de datos de Oracle admitidas que admite cada conector:
| Connector | Aplicación lógica | Versiones de base de datos de Oracle admitidas |
|---|---|---|
| Managed | - Consumo -Estándar |
- Oracle 9 y versiones posteriores - Cliente de acceso a datos de Oracle (ODAC) 11.2 y versiones posteriores |
| Integrado (versión preliminar) | Estándar | Oracle Database 11 y versiones posteriores |
Referencia técnica del conector
El conector de Oracle Database tiene versiones diferentes, basadas en el tipo de flujo de trabajo de la aplicación lógica y el entorno de host.
| Aplicación lógica | Ambiente | Versión del conector |
|---|---|---|
| Consumo | Azure Logic Apps multiinquilino | Conector gestionado, que aparece en la galería bajo el filtro Compartido. Para más información, consulte Referencia del conector administrado de Oracle Database. |
| Estándar | Azure Logic Apps de inquilino único, App Service Environment v3 (Windows únicamente) y entorno híbrido | Conector administrado, que aparece en la galería de conectores en el filtro Compartido, y el conector integrado (versión preliminar pública), que aparece en la galería de conectores en el filtro Integrado. La versión integrada se ejecuta en proceso con el runtime de Azure Logic Apps y no requiere la puerta de enlace de datos en las instalaciones porque el runtime puede alcanzar el punto de conexión de Oracle a través de la red. Para obtener más información, consulte: - Referencia del conector administrado de Oracle Database - Referencia del conector integrado |
Operaciones de conector integradas (versión preliminar)
Actualmente, el conector integrado admite las siguientes acciones:
| Nombre | Parámetros | Descripción | Devoluciones |
|---|---|---|---|
Ejecutar consulta (executeQuery) |
-
Consulta (query): requerido con el tipo string. La consulta SQL para ejecutar. - Parámetros de consulta ( queryParameters): opcional con object tipo. Parámetros de consulta que se van a incluir. |
Ejecuta una consulta SQL. | El resultado de la consulta SQL como array. |
Ejecutar procedimiento almacenado (executeStoredProcedure) |
-
Nombre del procedimiento almacenado (storedProcedure): obligatorio con string tipo. Nombre del procedimiento almacenado que se va a ejecutar. - Parámetros de procedimiento almacenado ( storedProcedureParameters): opcional con object tipo. Parámetros de procedimiento almacenado que se van a incluir. |
Ejecuta un procedimiento almacenado y devuelve los conjuntos de resultados y los parámetros de salida. |
-
Conjuntos de resultados (resultSets) de tipo string. Lista de conjuntos de resultados devueltos por el procedimiento almacenado. - Parámetros de salida ( outputParmaters) de tipo string. Los valores de los parámetros de salida devueltos por el procedimiento almacenado. |
Obtener filas (getRows) |
-
Nombre de tabla (tableName): se requiere con el tipo string. Nombre de la tabla de origen. - Condición Where ( columnValuesForWhereCondition): opcional con object tipo. El par clave-valor de las columnas que identifica las filas a obtener. - Desplazamiento para Get Rows ( skipCount): opcional con tipo string. Número de entradas que se van a omitir. El valor predeterminado es 0. - Número máximo de filas ( maxcount): opcional con el tipo string. Número máximo de filas que se van a obtener. El valor predeterminado es 0. - Columna de ordenación ( orderBy): opcional con string tipo. Nombre de columna que se va a usar para ordenar el resultado de la consulta. - Seleccione Columnas ( filterBy): opcional con string tipo. Valor de columna que se va a obtener de la tabla o vista. |
Obtiene una o varias filas en función de la condición especificada. | Las filas capturadas como array. |
Obtener tablas (getTables) |
Devuelve solo las tablas que pertenecen al usuario actual (ownedTables): opcional con el tipo string. Devuelve solo las tablas en las que el propietario es el usuario proporcionado. |
Obtiene una lista de tablas. | Lista de tablas como un array. |
Insertar fila (insertRow) |
-
Nombre de tabla (tableName): tipo string requerido. Nombre de la tabla. - Establecer columnas ( setColumns): opcional con tipo object. Valores de los campos de fila. |
Inserta una fila. | La fila insertada con tipo object. |
Requisitos previos
Una cuenta y una suscripción de Azure. Obtenga una cuenta gratuita de Azure.
El recurso y el flujo de trabajo de la aplicación lógica desde el cual conectarse a la base de datos de Oracle.
Este conector proporciona únicamente acciones, no desencadenadores. Puede usar cualquier desencadenador que quiera para iniciar el flujo de trabajo. Para crear el recurso y el flujo de trabajo de la aplicación lógica y, a continuación, agregue un desencadenador, consulte:
Requisitos previos del conector administrado (consumo y estándar)
Descargue e instale la puerta de enlace de datos local.
Esta puerta de enlace actúa como puente y proporciona una transferencia de datos segura entre los datos locales y la aplicación o el cliente. Puede usar la misma instalación de puerta de enlace con varios servicios y orígenes de datos, lo que significa que es posible que solo tenga que instalar la puerta de enlace una vez.
Instale el cliente Oracle en el equipo en el que instaló la puerta de enlace de datos local. De lo contrario, se produce un error al intentar crear o usar la conexión.
Cree un recurso de puerta de enlace de Azure para la instalación de su puerta de enlace.
Requisitos previos del conector integrado (estándar, versión preliminar)
Asegúrese de que el flujo de trabajo de la aplicación lógica estándar pueda llegar al punto de conexión de Oracle, incluidos cualquier host, puerto, resolución DNS y reglas de firewall.
Al crear la conexión de base de datos de Oracle, necesita los siguientes valores:
- Dirección IP del servidor de base de datos de Oracle
- Nombre de usuario
- Contraseña
Para la dirección IP del servidor, especifique este valor en los siguientes formatos:
Formato Syntax Example Easy Connect (no SSL) < host>:<port>/<database-service-name> localhost:1522/XEDescriptor de sustrato de red transparente (TNS) (SSL): el descriptor de origen de datos de Oracle completo (description=(retry_count=<retries>)(retry_delay=<delay-duration>)(address=(protocol=tcps)(port=<port-number>)(host=<host>))(connect_data=(service_name=<service-name>))(security=(ssl_server_dn_match=yes))) (description=(retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522)(host=localhost))(connect_data=(service_name=XE))(security=(ssl_server_dn_match=yes))) Para la acción Obtener fila que se usa en este ejemplo, debe conocer el identificador de la tabla a la que se va a acceder.
Si no conoce esta información, póngase en contacto con el administrador de Oracle Database u obtenga la salida de la siguiente instrucción:
select * from <table-name>.
Problemas y limitaciones conocidos
Las versiones actuales del conector no admiten desencadenadores. Use cualquier desencadenador que se ajuste a su escenario para iniciar el flujo de trabajo y, a continuación, agregue acciones de Oracle.
| Connector | Limitaciones |
|---|---|
| Managed | - Tablas con claves compuestas - Tablas con tipos de objetos anidados - Funciones de base de datos con valores no escalados |
| Integrado | - No hay acciones de actualización ni eliminación dedicadas. Para escenarios de actualización y eliminación, use las acciones Ejecutar consulta o Ejecutar procedimiento almacenado . - Algunos problemas de conexión pueden aparecer solo en tiempo de ejecución de flujo de trabajo, en lugar de en el momento de la creación de la conexión. |
Agregar una acción
Los pasos para agregar y usar una acción de Oracle difieren en función de si se usa el conector integrado o el conector administrado.
Adición de una acción de conector integrada (Estándar, versión preliminar)
En el portal de Azure, abra su recurso de aplicación lógica estándar.
En el diseñador, abra el flujo de trabajo.
Siga los pasos genéricos para agregar la acción Base de datos de Oracle que desea para el flujo de trabajo.
Este ejemplo continúa con la acción Obtener filas .
En el panel de información de conexión, escriba la información necesaria, como el nombre de conexión que desee, la dirección IP del servidor de bases de datos de Oracle, el nombre de usuario y la contraseña, por ejemplo:
Cuando termine, seleccione Crear nueva.
En el panel de información de acciones, escriba los valores de parámetro necesarios para la acción seleccionada.
Por ejemplo, si selecciona la acción Obtener filas , escriba el nombre de la tabla:
Agregue cualquier otra acción necesaria para finalizar el flujo de trabajo.
Guarde el flujo de trabajo. En la barra de herramientas del diseñador, seleccione Save (Guardar).
Agregar una acción de conector administrado (consumo y estándar)
En el portal Azure, abra su recurso de aplicación lógica de tipo Consumption o de tipo Standard.
En el diseñador, abra el flujo de trabajo.
Siga los pasos genéricos para agregar la acción Base de datos de Oracle que desea para el flujo de trabajo.
Este ejemplo continúa con la acción Obtener fila.
En el panel de información de conexión, escriba la información de conexión necesaria.
En la propiedad Puerta de enlace, seleccione la suscripción de Azure y el recurso de puerta de enlace de Azure que se va a usar.
Después de finalizar la conexión, en la lista Nombre de tabla, seleccione una tabla.
En la propiedad Id. de fila, escriba el identificador de fila que desee en la tabla.
En el ejemplo siguiente, se devuelven los datos de trabajo de una base de datos de recursos humanos:
Agregue cualquier otra acción necesaria para finalizar el flujo de trabajo.
Guarde el flujo de trabajo. En la barra de herramientas del diseñador, seleccione Save (Guardar).
Solución de problemas de conexión de base de datos de Oracle
Error: No se puede alcanzar la puerta de enlace
Causa: la puerta de enlace de datos local no se puede conectar a la nube.
Mitigación: Asegúrese de que la puerta de enlace se ejecuta en el equipo en las instalaciones donde instaló la puerta de enlace y que tenga conectividad a Internet. Evite instalar la pasarela en un equipo que puede estar apagado o en reposo. También puede intentar 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”. Consulte https://go.microsoft.com/fwlink/p/?LinkID=272376 para instalar el proveedor oficial.
Causa: el SDK del cliente Oracle no está instalado en el equipo en el 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 Oracle Database requiere que se utilice una tabla con una columna de clave principal.