Conectar-se a bancos de dados Oracle em fluxos de trabalho no Aplicativos Lógicos do Azure

Aplica-se a: Aplicativos Lógicos do Azure (Consumo + Padrão)

Quando seus fluxos de trabalho precisarem trabalhar com dados do Oracle, conecte-se ao banco de dados Oracle usando o conector Oracle Database no Aplicativos Lógicos do Azure. Você pode acessar bancos de dados hospedados localmente ou em uma máquina virtual Azure.

O conector do Oracle Database ajuda você a resolver tarefas comuns de integração de dados, como:

Adicione registros de cliente ao banco de dados.
Atualize os registros de pedidos em seu banco de dados.
Obtenha, insira ou exclua linhas de tabela como parte do fluxo de trabalho.

Versões do Oracle Database com suporte

A tabela a seguir lista as versões do Oracle DB compatíveis com cada conector:

Connector	Aplicativo lógico	Versões do Oracle DB com suporte
Gerenciado	-Consumo - Padrão	- Oracle 9 e posterior - Oracle Data Access Client (ODAC) 11.2 e posterior
Interno (versão preliminar)	Standard	Oracle Database 11 e posterior

Referência técnica do conector

O conector do Oracle Database tem versões diferentes, com base no tipo de fluxo de trabalho do aplicativo lógico e no ambiente do host.

Aplicativo lógico	Ambiente	Versão do conector
Consumo	Aplicativos Lógicos do Azure multilocatários	Conector gerenciado, que aparece na galeria de conectores sob o filtro Compartilhado . Para obter mais informações, consulte a referência do conector gerenciado do Oracle Database.
Standard	Aplicativos Lógicos do Azure de locatário único, Ambiente do Serviço de Aplicativo v3 (somente planos do Windows) e Híbrido	Conector gerenciado, que aparece na galeria de conectores sob o filtro Compartilhado e conector interno (versão prévia pública), que aparece na galeria de conectores sob o filtro Interno . A versão integrada é executada no mesmo processo que o runtime do Aplicativos Lógicos do Azure e não requer o gateway de dados local, pois o runtime pode acessar seu ponto de extremidade Oracle pela rede. Para obter mais informações, consulte: - Referência do conector gerenciado do Oracle Database - Referência do conector integrado

Operações do conector integrado (versão preliminar)

Atualmente, o conector interno dá suporte às seguintes ações:

Nome	Parameters	Description	Devoluções
Executar consulta (`executeQuery`)	- Consulta (`query`): obrigatório com `string` o tipo. A consulta SQL a ser executada. - Parâmetros de consulta (`queryParameters`): opcional com o tipo `object`. Os parâmetros de consulta a serem incluídos.	Executa uma consulta SQL.	O resultado da consulta SQL como um `array`.
Executar procedimento armazenado (`executeStoredProcedure`)	- Nome do procedimento armazenado (`storedProcedure`): obrigatório com o tipo `string`. O nome do procedimento armazenado a ser executado. - Parâmetros de procedimento armazenado (`storedProcedureParameters`): opcional com tipo `object`. Os parâmetros do procedimento armazenado a serem incluídos.	Executa um procedimento armazenado e retorna os conjuntos de resultados e os parâmetros de saída.	- Conjuntos de resultados (`resultSets`) com `string` tipo. A lista de conjuntos de resultados retornados pelo procedimento armazenado. - Parâmetros de saída (`outputParmaters`) tipo `string`. Os valores dos parâmetros de saída retornados pelo procedimento armazenado.
Obter linhas (`getRows`)	- Nome da tabela (`tableName`): obrigatório do tipo `string`. O nome da tabela de origem. - Condição WHERE (`columnValuesForWhereCondition`): opcional com o tipo `object`. O par de colunas chave-valor que identifica as linhas a serem obtidas. - Deslocamento para Obter Linhas (`skipCount`): opcional com o tipo `string`. O número de entradas a serem ignoradas. O padrão é 0. - Linhas máximas (`maxcount`): opcional com `string` tipo. O número máximo de linhas a serem obtidas. O padrão é 0. - Coluna de Ordenação (`orderBy`): opcional com o tipo `string`. O nome da coluna a ser usado para ordenar o resultado da consulta. - Selecione Colunas (`filterBy`): Opcional para o tipo `string`. O valor da coluna a ser obtida da tabela ou exibição.	Obtém uma ou mais linhas com base na condição especificada.	As linhas buscadas como um `array`.
Obter tabelas (`getTables`)	Retornar somente tabelas pertencentes ao usuário atual (`ownedTables`): opcional do tipo `string`. Retorna apenas tabelas em que o proprietário é o usuário fornecido.	Obtém uma lista de tabelas.	A lista de tabelas como um `array`.
Inserir linha (`insertRow`)	- Nome da tabela (`tableName`): obrigatório do tipo `string`. O nome da tabela. - Definir colunas (`setColumns`): opcional para o tipo `object`. Os valores dos campos de linha.	Insere uma linha.	A linha inserida com tipo `object`.

Pré-requisitos

Uma conta Azure e uma assinatura. Obtenha uma conta gratuita do Azure.
O recurso de aplicativo lógico e o fluxo de trabalho a partir do qual você se conecta ao banco de dados Oracle.

Esse conector só fornece ações, não gatilhos. Você pode usar qualquer gatilho que desejar para iniciar seu fluxo de trabalho. Para criar o recurso de aplicativo lógico e o fluxo de trabalho e, em seguida, adicionar um gatilho, consulte:

Pré-requisitos do conector gerenciado (Consumo e Padrão)

Baixe e instale o gateway de dados local.

Esse gateway atua como uma ponte e fornece uma transferência de dados segura entre dados locais e seu aplicativo ou cliente. Você pode usar a mesma instalação de gateway com vários serviços e fontes de dados, o que significa que talvez você só precise instalar o gateway uma vez.
Instale seu cliente Oracle no computador onde você instalou o gateway de dados local. Caso contrário, ocorrerá um erro ao tentar criar ou usar a conexão.
Crie um recurso de gateway do Azure para a instalação do seu gateway.

Pré-requisitos de conectores integrados (Padrão, versão prévia)

Certifique-se de que seu fluxo de trabalho de aplicativo lógico Padrão possa alcançar seu ponto de extremidade Oracle, incluindo host, porta, resolução de DNS e regras de firewall.

Ao criar a conexão de banco de dados Oracle, você precisará dos seguintes valores:

Endereço IP do servidor de banco de dados Oracle
Nome de usuário
Senha

Para o endereço IP do servidor, especifique esse valor nos seguintes formatos:

Formatar	Sintaxe	Example
Conexão Fácil (não SSL)	< host>:<port>/<database-service-name>	`localhost:1522/XE`
Descritor TNS (Transparent Network Substrate) (SSL): o descritor completo do Oracle Datasource	(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 a ação Obter linha usada neste exemplo, você precisa saber o identificador da tabela a ser acessada.

Se você não souber essas informações, entre em contato com o administrador do Oracle Database ou obtenha a saída da seguinte instrução: select * from <table-name>.

Limitações e problemas conhecidos

As versões atuais do conector não dão suporte a gatilhos. Use qualquer gatilho que se ajuste ao seu cenário para iniciar seu fluxo de trabalho e, em seguida, adicione ações do Oracle.

Connector	Limitações
Gerenciado	- Tabelas com chaves compostas - Tabelas com tipos de objeto aninhados - Funções de banco de dados com valores nãocalares
Interna	- Nenhuma atualização dedicada ou ações de exclusão. Para cenários de atualização e exclusão, use Executar consulta ou Executar procedimento armazenado. - Alguns problemas de conexão podem aparecer apenas no runtime do fluxo de trabalho, em vez de no momento da criação da conexão.

Adicionar uma ação

As etapas para adicionar e usar uma ação oracle diferem com base em se você usa o conector interno ou o conector gerenciado.

Adicionar uma ação de conector embutido (Padrão, versão prévia)

No portal do Azure, abra seu recurso de aplicativo lógico Padrão.
Na ferramenta designer, abra o fluxo de trabalho.
Siga as etapas genéricas para adicionar a ação do Banco de Dados Oracle que você deseja ao fluxo de trabalho.

Este exemplo continua com a ação Obter linhas .
No painel de informações de conexão, insira as informações necessárias, como o nome de conexão desejado, o endereço IP do servidor de banco de dados Oracle, o nome de usuário e a senha, por exemplo:
Quando terminar, selecione Criar.
No painel de informações de ação, insira os valores de parâmetro necessários para a ação selecionada.

Por exemplo, se você selecionar a ação Obter linhas, insira o nome da tabela:
Adicione outras ações necessárias para concluir seu fluxo de trabalho.
Salve o fluxo de trabalho. Selecione Salvar na barra de ferramentas do designer.

Adicione uma ação de conector gerenciado (Consumo e Padrão)

No portal do Azure, abra o recurso do seu aplicativo lógico de Consumo ou Padrão.
Na ferramenta designer, abra o fluxo de trabalho.
Siga as etapas genéricas para adicionar a ação do Banco de Dados Oracle que você deseja ao fluxo de trabalho.

Este exemplo continua com a ação Obter linha.
No painel de informações de conexão, insira as informações de conexão necessárias.
Para a propriedade Gateway, selecione a assinatura do Azure e o recurso de gateway do Azure a ser usado.
Depois de concluir a conexão, na lista de nomes de tabela , selecione uma tabela.
Para a propriedade ID de Linha, insira a ID da linha desejada em sua tabela.

No exemplo a seguir, os dados do trabalho retornam de um banco de dados de Recursos Humanos:
Adicione outras ações necessárias para concluir seu fluxo de trabalho.
Salve o fluxo de trabalho. Selecione Salvar na barra de ferramentas do designer.

Solucionar problemas de conexão de banco de dados Oracle

Erro: não é possível acessar o Gateway

Causa: o gateway de dados local não pode se conectar à nuvem.

Mitigação: Certifique-se de que o gateway está em execução no computador local onde você instalou o gateway e que possui conectividade com a Internet. Evite instalar o gateway em um computador que pode ser desligado ou entrar em modo de espera. Você também pode tentar reiniciar o serviço de gateway de dados local (PBIEgwService).

Erro: o provedor que está sendo usado é preterido: 'O System.Data.OracleClient exige o software cliente da Oracle versão 8.1.7 ou posterior.' Para instalar o provedor oficial, veja https://go.microsoft.com/fwlink/p/?LinkID=272376.

Causa: o SDK do cliente da Oracle não está instalado no computador onde o gateway de dados local está em execução.

Resolução: baixe e instale o SDK do cliente da Oracle no mesmo computador que o gateway de dados local.

Erro: a tabela '[Nome_da_tabela]' não define colunas de chave

Causa: uma tabela não tem uma chave primária.

Resolução: o conector do Oracle Database exige que você use uma tabela com uma coluna de chave primária.

Comentários

Esta página foi útil?

Last updated on 2026-05-06