Partilhar via

Oracle Database

Oracle Database é um sistema de gerenciamento de banco de dados relacional desenvolvido pela Oracle. Conecte-se ao Oracle Database local para executar várias ações, como criar, atualizar, obter e excluir linhas de uma tabela.

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regiões
Estúdio Copiloto Premium Todas as Power Automate regiões
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps
Automatize o poder Premium Todas as Power Automate regiões
Contato
Nome Microsoft
URL Suporte do Microsoft LogicApps
Microsoft Power Automate Suporte
Suporte do Microsoft Power Apps
Metadados do conector
Editora Microsoft
Sítio Web https://www.oracle.com/database/
Política de privacidade https://www.oracle.com/legal/privacy/

Este artigo descreve as operações para o conector Oracle Database, que está disponível para Azure Logic Apps, Microsoft Power Apps e Microsoft Power Automate. Você pode usar esse conector para se conectar a um Banco de Dados Oracle local ou a uma máquina virtual do Azure com o Banco de Dados Oracle instalado.

O que há de novo

A tabela a seguir descreve as novas atualizações e recursos para o Oracle Databaseconnector:

Atualização Description
Outubro de 2018 Suporta procedimento armazenado Oracle.
Janeiro de 2018 Suporta a visualização Oracle como tabela somente leitura.

Pré-requisitos

  • Versões Oracle suportadas:

    • Oracle 9 e posterior
    • Oracle Data Access Client (ODAC) 11.2 e posterior

  • Para se conectar a um banco de dados Oracle local ou a uma máquina virtual do Azure com o Banco de Dados Oracle instalado, você deve instalar 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 só seja necessário instalar o gateway uma vez.

  • Instale o cliente Oracle no computador onde você instalou o gateway de dados local. Certifique-se de instalar o Oracle Data Provider for .NET de 64 bits da Oracle e selecione a versão do instalador do Windows porque a xcopy versão não funciona com o gateway de dados local: ODAC 12c Release 4 de 64 bits (12.1.0.2.4) para Windows x64. Você pode verificar a instalação executando o seguinte comando do PowerShell: [System.Data.Common.DbProviderFactories]::GetFactoryClasses(). Se um cliente Oracle estiver instalado, você verá "OracleClient Data Provider" nos resultados.

    Observação

    Se o cliente Oracle não estiver instalado, ocorrerá um erro quando você tentar criar ou usar a conexão. Para obter mais informações, consulte a seção Erros comuns de conexão.

  • Antes de executar qualquer operação de conector, em seu cliente Oracle, defina a variável de ambiente chamada ORA_NCHAR_LITERAL_REPLACE como TRUE.

    Essa configuração permite a substituição literal da cadeia de caracteres NCHAR, o que impede a perda de dados quando literais de cadeia de caracteres que contêm caracteres além do conjunto de caracteres do banco de dados são inseridos na coluna do tipo NCHAR/NVARCHAR/NCLOB . Quando a instrução é executada, literais de cadeia de caracteres são convertidos em um formato interno e, em seguida, são decodificados corretamente para Unicode.

Problemas conhecidos e limitações

A lista a seguir descreve algumas limitações conhecidas para o conector Oracle Datbase:

  • Não suportado:

    • Qualquer tabela com chaves compostas
    • Tipos de objeto aninhados em tabelas
    • Funções de banco de dados com valores não escalares
    • Oracle Functions para que não estejam listados na interface do usuário.

  • Quando você invoca um procedimento armazenado em um servidor Oracle, as seguintes limitações se aplicam:

    • Os parâmetros OUT não são suportados.
    • O valor de retorno não está disponível porque o procedimento armazenado não retorna nenhum resultado.

  • O limite de tamanho de resposta é de 8MB.

  • O limite de tamanho da solicitação é de 2MB.

  • A consulta nativa Oracle é suportada com as seguintes limitações:

    • Requer a versão de gateway 3000.63.4 (versão de outubro) ou posterior.
    • RefCursor não é suportado.
    • Os parâmetros OUT não são suportados.
    • Apenas um conjunto de resultados pode ser retornado.

  • Os seguintes tipos de dados não podem ser usados como predicados de opção de consulta:

    • DATE
    • DATA E HORA
    • TIMESTAMP com fuso horário
    • TIMESTAMP com fuso horário local

  • Se qualquer consulta Oracle ou tempo de execução de procedimento armazenado exceder 110 segundos, a ação expira.

  • Inserir e atualizar para uma tabela não retornam o item completo. Eles retornam apenas as propriedades de entrada para a operação.

  • Para obter resultados determinísticos de paginação para a operação Obter linhas , é necessária uma Chave Primária.

  • A operação Inserir linha requer que você forneça um valor explícito para a coluna Chave Primária, mesmo que o valor padrão/autoincrement esteja definido.

  • Devido a limitações de componentes da interface do usuário, a lista de tabelas renderizadas durante o tempo de design não pode mostrar mais de 2.048 elementos, que é o tamanho de página padrão para a operação Obter tabelas , por exemplo:

    • Lista de tabelas para o parâmetro de ação Obter linhas chamado 'Nome da tabela'.
    • Lista de tabelas para o fluxo 'Criar conexão/Escolher uma tabela' no designer do Power Apps.

  • Se você observar latência ao trabalhar com o banco de dados Oracle, instale o Oracle Data Access Components (ODAC) de 64 bits mais recente na máquina de gateway ou em cada máquina de gateway, se o gateway for um cluster.

  • Se a criação da conexão Oracle falhar com um tempo limite, tente usar uma credencial Oracle com permissão mínima. Dessa forma, a conexão é mais leve, o que pode ajudá-lo a evitar experimentar o tempo limite durante a criação da conexão.

Erros comuns de conexão

Erro: Não é possível acessar o gateway

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

Atenuação: verifique se o gateway está sendo executado no computador local onde você instalou o gateway e tem conectividade com a Internet. Evite instalar o gateway em um computador que possa estar desligado ou entrar em suspensão. Você também pode tentar reiniciar o serviço de gateway de dados local (PBIEgwService).

Erro: O provedor que está sendo usado foi preterido: 'System.Data.OracleClient requer software cliente Oracle versão 8.1.7 ou superior.'. Consulte https://go.microsoft.com/fwlink/p/?LinkID=272376 para instalar o provedor oficial.

Causa: O SDK do cliente Oracle não está instalado no computador em que o gateway de dados local está sendo executado.

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

Erro: A tabela '[Tablename]' não define nenhuma coluna de chave

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

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

Limites Gerais

Nome Valor
Número máximo de solicitações sendo processadas pelo conector simultaneamente por conexão 200
Número máximo de megabytes sendo transferidos através do conector simultaneamente por conexão 30

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:
Predefinição Parâmetros para criar conexão. Todas as regiões Compartilhável

Padrão

Aplicável: Todas as regiões

Parâmetros para criar conexão.

Esta é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, a conexão também será compartilhada. Para obter mais informações, consulte a Visão geral de conectores para aplicativos de tela - Power Apps | Documentos Microsoft

Nome Tipo Description Obrigatório
Server cadeia (de caracteres) Especifique o servidor Oracle. Se uma porta ou SID for necessária, especifique na forma de ServerName:Port/SID. Verdade
Tipo de autenticação [Selecionar básico] cadeia (de caracteres) Tipo de autenticação para se conectar ao seu banco de dados
Nome de utilizador securestring Credencial de nome de usuário Verdade
Palavra-passe securestring Credencial de senha Verdade
Gateway gatewaySetting Gateway local (consulte https://docs.microsoft.com/data-integration/gateway para obter mais detalhes Verdade

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 1500 60 segundos

Ações

Atualizar linha

Esta operação atualiza uma linha existente em uma tabela.
Excluir linha

Esta operação exclui uma linha de uma tabela.
Executar procedimento armazenado

Esta operação executa um procedimento armazenado.
Executar uma consulta Oracle

Executar uma consulta Oracle
Inserir linha

Esta operação insere uma nova linha em uma tabela.
Obter linha

Esta operação obtém uma linha de uma tabela.
Obter linhas

Esta operação obtém linhas de uma tabela.
Obter mesas

Esta operação obtém tabelas de um banco de dados.

Atualizar linha

ID da Operação:
PatchItem

Esta operação atualiza uma linha existente em uma tabela.

Parâmetros

Name Chave Necessário Tipo Description
Nome da tabela
 table True string

Nome do quadro
ID da linha
 id True string

Identificador exclusivo da linha a ser atualizada
Row
 item True dynamic

Linha com valores atualizados

Devoluções

As saídas desta operação são dinâmicas.

Excluir linha

ID da Operação:
DeleteItem

Esta operação exclui uma linha de uma tabela.

Parâmetros

Name Chave Necessário Tipo Description
Nome da tabela
 table True string

Nome do quadro
ID da linha
 id True string

Identificador exclusivo da linha a excluir

Executar procedimento armazenado

ID da Operação:
ExecuteProcedure

Esta operação executa um procedimento armazenado.

Parâmetros

Name Chave Necessário Tipo Description
Nome do procedimento
 procedure True string

Nome do procedimento armazenado
Lista de parâmetros
 parameters True dynamic

Parâmetros de entrada para o procedimento armazenado

Devoluções

As saídas desta operação são dinâmicas.

Executar uma consulta Oracle

ID da Operação:
ExecutePassThroughNativeQuery

Executar uma consulta Oracle

Parâmetros

Name Chave Necessário Tipo Description
Query
 query True dynamic

corpo da consulta

Devoluções

As saídas desta operação são dinâmicas.

Inserir linha

ID da Operação:
PostItem

Esta operação insere uma nova linha em uma tabela.

Parâmetros

Name Chave Necessário Tipo Description
Nome da tabela
 table True string

Nome do quadro
Row
 item True dynamic

Linha a inserir na tabela especificada

Devoluções

As saídas desta operação são dinâmicas.

Obter linha

ID da Operação:
GetItem

Esta operação obtém uma linha de uma tabela.

Parâmetros

Name Chave Necessário Tipo Description
Nome da tabela
 table True string

Nome da tabela Oracle
ID da linha
 id True string

Identificador exclusivo da linha a ser recuperada

Devoluções

As saídas desta operação são dinâmicas.

Obter linhas

ID da Operação:
GetItems

Esta operação obtém linhas de uma tabela.

Parâmetros

Name Chave Necessário Tipo Description
Nome da tabela
 table True string

Nome da tabela Oracle
Filtrar consulta
 $filter string

Uma consulta de filtro ODATA para restringir as entradas retornadas (por exemplo, stringColumn eq 'string' OR numberColumn lt 123).
Encomendar por
 $orderby string

Uma ordem ODATAPor consulta para especificar a ordem das entradas.
Contagem superior
 $top integer

Número total de entradas a recuperar (padrão = todas).
Pular contagem
 $skip integer

O número de entradas a serem ignoradas (padrão = 0).
Selecionar consulta
 $select string

Campos específicos para recuperar de entradas (padrão = todos).

Devoluções

As saídas desta operação são dinâmicas.

Obter mesas

ID da Operação:
GetTables

Esta operação obtém tabelas de um banco de dados.

Devoluções

Representa uma lista de tabelas.

Body
TablesList

Definições

Table

Representa uma tabela.

Name Caminho Tipo Description
Nome
 Name string

O nome da tabela. O nome é usado em tempo de execução.
Nome de Exibição
 DisplayName string

O nome para exibição da tabela.
DynamicProperties
 DynamicProperties object

Propriedades de tabela adicionais fornecidas pelo conector para os clientes.

Lista de Tabelas

Representa uma lista de tabelas.

Name Caminho Tipo Description
valor
 value array of Table

Lista de Tabelas