Compartilhar via

Oracle Database

O 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 em linhas em uma tabela.

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

Service Class Regions
Copilot Studio Premium Todas as regiões Power Automate
Aplicativos Lógicos Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões Power Apps
Power Automate Premium Todas as regiões Power Automate
Contato
Nome Microsoft
URL Suporte do Microsoft LogicApps
Suporte do Microsoft Power Automate
Suporte do Microsoft Power Apps
Metadados do conector
Publicador Microsoft
Site https://www.oracle.com/database/
Política de privacidade https://www.oracle.com/legal/privacy/

Este artigo descreve as operações do conector do Banco de Dados Oracle, que está disponível para Aplicativos Lógicos do Azure, 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 Oracle Database instalado.

Quais são as novidades?

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

Update Description
Outubro de 2018 Dá suporte ao procedimento armazenado Oracle.
Janeiro de 2018 Dá suporte à exibição Oracle como tabela somente leitura.

Pré-requisitos

  • Versões do Oracle com suporte:

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

  • Para se conectar com um banco de dados Oracle local ou uma máquina virtual do Azure com o Oracle Database 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 você só precise instalar o gateway uma vez.

  • Instale seu cliente Oracle no computador em que você instalou o gateway de dados local. Instale o Provedor de Dados Oracle de 64 bits para .NET 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: versão 4 do ODAC 12c 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ê deverá ver "Provedor de Dados OracleClient" nos resultados.

    Observação

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

  • 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 de banco de dados são inseridos na coluna de tipo NCHAR/NVARCHAR/NCLOB . Quando a instrução é executada, os literais de cadeia de caracteres são convertidos em um formato interno e, em seguida, são decodificados corretamente em Unicode.

Problemas e limitações conhecidos

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

  • Não há suporte para:

    • Qualquer tabela com chaves compostas
    • Tipos de objeto aninhados em tabelas
    • Funções de banco de dados com valores não escalares
    • O Oracle Functions para que eles 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:

    • Não há suporte para parâmetros OUT.
    • O valor retornado não está disponível porque o procedimento armazenado não retorna nenhum resultado.

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

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

  • Há suporte para a consulta nativa oracle com as seguintes limitações:

    • Requer o gateway versão 3000.63.4 (versão de outubro) ou posterior.
    • Não há suporte para RefCursor.
    • Não há suporte para parâmetros OUT.
    • Somente 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
    • TIMESTAMP
    • 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 atingirá o tempo limite.

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

  • Para obter resultados de paginação determinística para a operação Obter linhas , uma Chave Primária é necessá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/decremento automático seja definido.

  • Devido às limitações do componente 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 da página padrão para a operação Obter tabelas , por exemplo:

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

  • Se você observar a latência enquanto trabalha com o banco de dados Oracle, instale os componentes mais recentes do Oracle Data Access Components (ODAC) de 64 bits no computador do gateway ou em cada computador de gateway, se o gateway for um cluster.

  • Se a criação de conexões 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 o tempo limite durante a criação da conexão.

Erros de conexão comuns

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

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

Mitigação: verifique se o gateway está em execução no computador local em que você instalou o gateway e tem conectividade com a Internet. Evite instalar o gateway em um computador que pode estar desativado ou ir para o suspensão. Você também pode tentar reiniciar o PBIEgwService (serviço de gateway de dados local).

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á em execução.

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 Banco de Dados Oracle requer que você use uma tabela com uma coluna de chave primária.

Limites Gerais

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

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:
Default 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.

Essa é 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 dos Conectores para aplicativos de tela – Power Apps | Microsoft Docs

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

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 1500 60 segundos

Ações

Atualizar linha

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

Essa 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

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

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

Essa operação obtém linhas de uma tabela.
Obter tabelas

Essa 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

Nome Chave Obrigatório Tipo Description
Nome da tabela
 table True string

Nome da tabela
ID da linha
 id True string

Identificador exclusivo da linha a ser atualizada
Linha
 item True dynamic

Linha com valores atualizados

Retornos

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

Excluir linha

ID da operação:
DeleteItem

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome da tabela
 table True string

Nome da tabela
ID da linha
 id True string

Identificador exclusivo da linha a ser excluída

Executar procedimento armazenado

ID da operação:
ExecuteProcedure

Esta operação executa um procedimento armazenado.

Parâmetros

Nome Chave Obrigató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

Retornos

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

Nome Chave Obrigatório Tipo Description
Query
 query True dynamic

corpo da consulta

Retornos

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

Inserir linha

ID da operação:
PostItem

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome da tabela
 table True string

Nome da tabela
Linha
 item True dynamic

Linha a ser inserida na tabela especificada

Retornos

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

Obter linha

ID da operação:
GetItem

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

Parâmetros

Nome Chave Obrigató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

Retornos

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

Obter linhas

ID da operação:
GetItems

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

Parâmetros

Nome Chave Obrigató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).
Ordenar por
 $orderby string

Uma consulta orderBy do ODATA para especificar a ordem das entradas.
Contagem superior
 $top integer

Número total de entradas a serem recuperadas (padrão = todas).
Ignorar Contagem
 $skip integer

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

Campos específicos a serem recuperados de entradas (padrão = todos).

Retornos

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

Obter tabelas

ID da operação:
GetTables

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

Retornos

Representa uma lista de tabelas.

Corpo
TablesList

Definições

Table

Representa uma tabela.

Nome Caminho Tipo Description
Nome
 Name string

O nome da tabela. O nome é usado no runtime.
DisplayName
 DisplayName string

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

Propriedades de tabela adicionais fornecidas pelo conector para os clientes.

TablesList

Representa uma lista de tabelas.

Nome Caminho Tipo Description
value
 value array of Table

Lista de tabelas