Compartilhar via

Banco de dados Oracle

Resumo

Elemento Descrição
Estado da liberação Disponibilidade geral
Produtos Distinguir-se
Power BI (modelos semânticos)
Power BI (fluxos de dados)
Fabric (Fluxo de dados Gen2)
Power Apps (fluxos de dados)
Informações do Cliente do Dynamics 365
Serviços de análise
Tipos de autenticação com suporte Windows (desktop/online)
Banco de dados (versão desktop)
Básico (online)
Conta da Microsoft (área de trabalho)
Documentação de referência da função Oracle.Database

Observação

Alguns recursos podem estar presentes em um produto, mas não em outros devido a agendas de implantação e recursos específicos do host.

Pré-requisitos

Versões do Oracle com suporte:

  • Oracle Database Server 12c (12.1.0.2) e posterior
  • Banco de Dados Autônomo Oracle – todas as versões

Antes de se conectar a um banco de dados Oracle usando o Power Query, você precisa instalar o Oracle Client for Microsoft Tools (OCMT). Para se conectar a um banco de dados Oracle com o gateway de dados local, o OCMT de 64 bits deve ser instalado no computador que executa o gateway. Para obter mais informações, acesse Gerenciar sua fonte de dados – Oracle.

Observação

Desde a versão de abril de 2025 do Power BI Desktop e a versão de maio de 2025 do gateway de dados local, fornecemos uma nova opção para usar o driver gerenciado interno ODP.NET do Oracle para se conectar ao banco de dados Oracle, atualmente disponível em pré-visualização. Com o recurso habilitado, você não precisa instalar o OCMT manualmente. Saiba mais sobre esse recurso.

Capacidades Suportadas

  • Importação
  • DirectQuery (modelos semânticos do Power BI)
  • Opções avançadas
    • Tempo de espera do comando em minutos
    • Instrução SQL
    • Incluir colunas de relação
    • Navegar usando a hierarquia completa

Baixar e instalar o Cliente Oracle para Ferramentas da Microsoft

O Oracle Client for Microsoft Tools instala e configura o Provedor de Dados Oracle para .NET (ODP.NET) para dar suporte a conexões de ferramentas da Microsoft de 32 e 64 bits com bancos de dados oracle locais e de nuvem, incluindo o Banco de Dados Autônomo Oracle (ADB). O OCMT é um instalador gráfico que automatiza o processo de instalação do Cliente de Banco de Dados Oracle. Ele dá suporte à conexão com o Power BI Desktop, o serviço do Power BI, o Fabric (Dataflow Gen2), o Excel, o SQL Server Analysis Services, o SQL Server Data Tools, o SQL Server Integration Services, o SQL Server Reporting Services e o BizTalk Server.

O OCMT é software gratuito. Ele pode ser baixado na página Cliente Oracle para Microsoft Tools. Para serviços do Power BI Desktop e do Power BI de 64 bits, use o OCMT de 64 bits. Para o Power BI Desktop de 32 bits, use o OCMT de 32 bits.

Mesmo que você já tenha um Cliente Oracle ou ODP.NET instalado em seu cliente do Power BI, é altamente recomendável usar o instalador OCMT para concluir corretamente todas as etapas de configuração necessárias para que o Power BI funcione com o banco de dados Oracle.

Conectar-se a um banco de dados Oracle local do Power Query Desktop

Para fazer a conexão, execute as seguintes etapas:

  1. Selecione a opção de banco de dados Oracle na seleção do conector.

  2. Especifique o nome do serviço de rede Oracle/alias TNS ou a cadeia de conexão Easy Connect (Plus) para se conectar ao Servidor. Easy Connect é o método mais simples de uso, configurando o valor do Servidor para o Nome do Host/ServiceName do seu servidor Oracle Database, onde ServiceName é o nome global do banco de dados. A captura de tela a seguir usa um nome de serviço net.

    Insira a conexão de banco de dados Oracle.

  3. Se você estiver se conectando por meio do Power BI Desktop, selecione o modo de conectividade de dados Importar ou DirectQuery. O restante dessas etapas de exemplo usa o modo de conectividade de dados Importar. Para saber mais sobre o DirectQuery, acesse Usar o DirectQuery no Power BI Desktop.

  4. Se você estiver se conectando a esse banco de dados Oracle pela primeira vez, selecione o tipo de autenticação que deseja usar e insira suas credenciais. Os tipos de autenticação disponíveis são:

    • Windows (autenticação do Windows)
    • Banco de dados (nome de usuário e senha)
    • Conta da Microsoft (ID do Microsoft Entra)

    Para ter mais informações sobre a autenticação, acesse Autenticação com uma fonte de dados.

    Insira suas credenciais de banco de dados Oracle.

  5. No Navegador, selecione os dados necessários e selecione Carregar para carregar os dados ou Transformar Dados para transformar os dados.

Conectar-se a um banco de dados Oracle local do Power Query Online

Para fazer a conexão, execute as seguintes etapas:

  1. Instale e configure um gateway de dados local.

  2. No Power Query Online, selecione a opção de banco de dados Oracle na seleção de fontes de dados.

  3. Na caixa de diálogo do banco de dados Oracle exibida, especifique o nome do serviço Oracle Net/alias TNS, a cadeia de conexão Easy Connect Plus ou o descritor de conexão para se conectar ao Servidor.

    Insira a conexão online do banco de dados Oracle.

  4. Forneça um nome de conexão, como "testoracleserver".

  5. Selecione o nome do gateway de dados local.

    Observação

    Você deve selecionar um gateway de dados local para esse conector, seja o banco de dados Oracle em sua rede local ou em um site.

  6. Se você estiver se conectando a esse banco de dados Oracle pela primeira vez, selecione o tipo de credenciais para a conexão no tipo autenticação. Escolha Básico se você planeja entrar com um nome de usuário e senha do Oracle. Escolha o Windows ao usar a autenticação do sistema operacional Windows e com o cliente Oracle e o servidor em execução no Windows.

  7. Insira suas credenciais.

  8. Selecione Avançar para continuar.

  9. Em Navegador, selecione os dados desejados e selecione Transformar dados para transformar os dados no Editor do Power Query.

Conectar-se a um Banco de Dados Autônomo Oracle

Observação

Atualmente, você pode se conectar a um Banco de Dados Autônomo Oracle do Excel, do Power BI Desktop, do serviço do Power BI, do Fabric (Dataflow Gen2), do Power Apps, do SQL Server Analysis Services e do BizTalk Server usando os procedimentos nesta seção. Essas ferramentas usam ODP.NET não gerenciadas para se conectar. Outras ferramentas da Microsoft, incluindo SQL Server Data Tools, SQL Server Integration Services e SQL Server Reporting Services, usam ODP.NET gerenciadas para se conectar ao Banco de Dados Autônomo Oracle usando procedimentos amplamente semelhantes.

Para conectar o Power BI a um Banco de Dados Autônomo Oracle, você precisa das seguintes contas e aplicativos:

Baixar suas credenciais de cliente

A primeira etapa na configuração de uma conexão com o banco de dados Oracle Autonomous é baixar suas credenciais de cliente.

Para baixar suas credenciais de cliente:

  1. Na página de detalhes do banco de dados Autônomo Oracle, selecione Conexão de Banco de Dados.

    Conexão de BD.

  2. Na página Conexão de Banco de Dados , selecione Baixar Carteira.

    Baixe a carteira.

  3. Insira uma senha que você gostaria de usar com essa carteira, confirme a senha e selecione Baixar.

    Senha da carteira.

Configurar credenciais do Oracle ADB

  1. Em seu computador do Windows, acesse a pasta em que você baixou suas credenciais do Oracle ADB de Baixar as credenciais de cliente.

  2. Descompacte as credenciais no diretório especificado no OCMT como o Diretório de Arquivos de Configuração do Oracle. Neste exemplo, as credenciais são extraídas para c:\data\wallet\wallet_contosomart.

    Imagem com os arquivos da carteira descompactados na pasta da carteira.

    Observação

    O arquivo tnsnames.ora define o endereço do Banco de Dados Autônomo Oracle e as informações de conexão.

  3. Abra sqlnet.ora em um editor, como o Bloco de Notas.

  4. Em WALLET_LOCATION, altere o caminho para a pasta da carteira na opção Diretório. Neste exemplo:

    WALLET_LOCATION = (SOURCE = (METHOD = file) (METHOD_DATA = (DIRECTORY=c:\data\wallet\Wallet_ContosoMart)))

  5. Salve e feche o arquivo sqlnet.ora.

Abra o arquivo tnsnames.ora na pasta wallets. O arquivo contém uma lista de nomes de serviço net do ADB aos quais você pode se conectar. Neste exemplo, os nomes são contosomart_high, contosomart_low e contosomart_medium. Seus nomes de serviço de rede do ADB são diferentes.

Imagem com três nomes TNS de exemplo, contosomart_high, contosomart_low e contosomart_medium.

Conectar o Power BI Desktop ao Oracle ADB

  1. Abra o Power BI Desktop.

  2. Selecione Obter Dados.

  3. Em Obter Dados, selecione Banco> deDados Oracle.

  4. Insira o nome do serviço net do servidor de Banco de Dados Autônomo Oracle ao qual você deseja se conectar. Neste exemplo, o servidor é contosomart_high. Em seguida, selecione OK.

    Imagem da caixa de diálogo do banco de dados Oracle com contosomart_high como o nome do servidor e o modo de importação selecionados.

  5. Se você estiver entrando neste servidor do Power BI Desktop pela primeira vez, será solicitado que você insira suas credenciais. Selecione Banco de Dados e, em seguida, insira o nome de usuário e a senha do banco de dados Oracle. As credenciais inseridas aqui são o nome de usuário e a senha do Banco de Dados Autônomo Oracle específico ao qual você deseja se conectar. Neste exemplo, o nome de usuário e a senha do administrador inicial do banco de dados são usados. Depois, selecione Conectar.

    Imagem da caixa de diálogo credenciais, com o Banco de Dados selecionado e o nome de usuário e a senha do banco de dados padrão inseridos.

    Observação

    Você pode usar a autenticação do Microsoft Entra ID para entrar no Banco de Dados Autônomo Oracle por meio da opção conta Microsoft .

Neste ponto, o Navegador é exibido e exibe os dados de conexão.

Imagem com o navegador aberto e o banco de dados contosomart_high mostrado com todos os seus detalhes.

Você também pode encontrar um dos vários erros porque a configuração não foi configurada corretamente. Esses erros são discutidos na solução de problemas.

Um erro que pode ocorrer neste teste inicial ocorre no Navegador, onde o banco de dados parece estar conectado, mas não contém dados. Em vez disso, um Oracle: ORA-28759: a falha ao abrir o erro de arquivo aparece no lugar dos dados.

Imagem do Navegador com o nome do banco de dados na parte superior, mas um erro aparece em vez dos dados.

Se esse erro ocorrer, verifique se o caminho da pasta de carteira fornecido em sqlnet.ora é o caminho completo e correto para a pasta da carteira.

Configurar o gateway

  1. Instale e configure um gateway de dados local.

  2. No serviço do Power BI, selecione o ícone de engrenagem no lado superior direito e, em seguida, selecione Gerenciar gateways.

    Imagem do serviço do Power BI aberto, o ícone de engrenagem selecionado e o menu Gerenciar gateways com Gerenciar gateways enfatizado.

  3. Em Adicionar Fonte de Dados, selecione Adicionar fontes de dados para usar o gateway.

    Imagem da janela Adicionar fonte de dados no serviço do Power BI, com Adicionar fonte de dados para usar o gateway enfatizado.

  4. No Nome da Fonte de Dados, insira o nome que você deseja usar como a configuração da fonte de dados.

  5. No Tipo de Fonte de Dados, selecione Oracle.

  6. No Servidor, insira o nome do serviço net do servidor de Banco de Dados Autônomo Oracle ao qual se conectar.

  7. No Método de Autenticação, selecione Básico.

  8. Insira o nome de usuário e a senha do Banco de Dados Autônomo Oracle. Neste exemplo, o nome de usuário do administrador de banco de dados padrão (ADMIN) e a senha são usados.

  9. Selecione Adicionar.

    Imagem da janela Configurações da Fonte de Dados, com todas as configurações da fonte de dados preenchidas.

Se tudo tiver sido instalado e configurado corretamente, uma mensagem de conexão bem-sucedida será exibida. Agora você pode se conectar ao Banco de Dados Autônomo Oracle usando as mesmas etapas descritas em Conectar-se a um banco de dados Oracle local do Power Query Online.

Conectar usando opções avançadas

O Power Query Desktop e o Power Query Online fornecem um conjunto de opções avançadas que você pode adicionar à consulta, se necessário.

A tabela a seguir lista todas as opções avançadas que você pode definir no Power Query Desktop e no Power Query Online.

Opção avançada Descrição
Tempo de espera do comando em minutos Se a conexão durar mais de 10 minutos (o tempo limite padrão), você poderá inserir outro valor em minutos para manter a conexão aberta por mais tempo. Essa opção só está disponível no Power Query Desktop.
Instrução SQL Para obter informações, acesse Importar dados de um banco de dados usando uma consulta de banco de dados nativa.
Incluir colunas de relação Caso esteja marcada, inclui colunas que podem ter relações com outras tabelas. Se essa caixa estiver desmarcada, essas colunas não aparecerão.
Navegar usando a hierarquia completa Se marcada, o navegador exibirá a hierarquia completa de tabelas no banco de dados ao qual você está se conectando. Se estiver limpo, o navegador mostra apenas as tabelas cujas colunas e linhas contêm dados.

Depois de selecionar as opções avançadas necessárias, selecione OK no Power Query Desktop ou Avançar no Power Query Online para se conectar ao banco de dados Oracle.

Usar o driver Interno do Oracle (versão prévia)

A partir da versão de abril de 2025 do Power BI Desktop e da versão de maio de 2025 do gateway de dados local, o conector Oracle inclui um driver de ODP.NET internamente gerenciado da Oracle para conectividade. Esse recurso remove a necessidade de os usuários instalarem e gerenciarem o driver. Você pode habilitar esse recurso seguindo as instruções fornecidas abaixo.

Para usar esse driver interno no Power BI Desktop, navegue até Opções e configurações (na guia Arquivo) >Opções>Versão prévia dos recursos e selecione a caixa de seleção para habilitar a opção Habilitar usando o Provedor ODP Gerenciado Oracle empacotado.

Captura de tela da opção para habilitar o uso do Provedor ODP Gerenciado do Oracle empacotado no Power BI Desktop.

Para usar este driver embutido no gateway de dados local, altere as configurações do gateway para atualizar a configuração MashupFlight_EnableOracleBundledOdacProvider usando as seguintes etapas:

  1. No computador local em que o gateway de dados local está instalado, navegue até C:\Arquivos de Programas\Gateway de dados local.
  2. Faça um backup do arquivo de configuração chamado Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config.
  3. Abra o arquivo de configuração de Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config original e localize a entrada MashupFlight_EnableOracleBundledOdacProvider.
  4. Atualize o MashupFlight_EnableOracleBundledOdacProvider valor como True.
  5. Reinicie o gateway.
<Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.GatewayCoreSettings>
   ...
   <setting name="MashupFlight_EnableOracleBundledOdacProvider" serializeAs="String">
      <value>True</value>
   </setting>
   ...
</Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.GatewayCoreSettings>

As configurações restantes para se conectar a um banco de dados Oracle do Power Query Desktop são as mesmas descritas nas seções anteriores.

Problemas e limitações conhecidos

As sessões do Power BI ainda podem estar ativas no banco de dados Oracle por aproximadamente 30 minutos após uma atualização semântica do modelo para esse banco de dados Oracle. Somente após aproximadamente 30 minutos essas sessões ficam inativas/removidas no banco de dados Oracle. Esse comportamento é por design.

Resolução de problemas

Você pode encontrar qualquer um dos vários erros do Oracle quando a sintaxe de nomenclatura estiver incorreta ou não estiver configurada corretamente:

  • ORA-12154: TNS: não foi possível resolver o identificador de conexão especificado.
  • ORA-12514: TNS: o ouvinte atualmente não sabe do serviço solicitado no descritor de conexão.
  • ORA-12541: TNS: nenhum ouvinte.
  • ORA-12170: TNS: ocorrência de tempo limite de conexão.
  • ORA-12504: TNS: SERVICE_NAME em CONNECT_DATA não foi atribuído ao ouvinte.

Esses erros poderão ocorrer se o descritor de conexão de banco de dados Oracle tnsnames.ora estiver configurado incorretamente, o nome do serviço net fornecido estiver escrito incorretamente ou o ouvinte do banco de dados Oracle não estiver em execução ou não for acessível, como um firewall bloqueando o ouvinte ou a porta do banco de dados. Verifique se você está atendendo aos pré-requisitos mínimos de instalação. Mais informações: Pré-requisitos

Visite o Portal de Ajuda de Erros do Oracle Database para examinar as causas e resoluções comuns do erro oracle específico encontrado. Insira o erro do Oracle na barra de pesquisa do portal.

Se você baixou o Power BI Desktop da Microsoft Store, talvez não consiga se conectar aos bancos de dados Oracle devido a um problema de driver Oracle. Se você encontrar esse problema, a mensagem de erro retornada será: Referência de objeto não definida. Para resolver o problema, faça o seguinte:

  • Baixe o Power BI Desktop no Centro de Download em vez da Microsoft Store.

Se a mensagem de erro Referência de objeto não definida ocorrer no Power BI quando você se conectar a um banco de dados Oracle usando o gateway de dados local, siga as instruções descritas em Gerenciar sua fonte de dados: Oracle.

Se você estiver usando o Servidor de Relatórios do Power BI, consulte as diretrizes no artigo Tipo de Conexão Oracle .

Próximas etapas

Otimizar o Power Query ao expandir colunas de tabela