Banco de dados Oracle

Resumo

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.

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.

• Downloads de 64 bits e 32 bits do OCMT
• Instruções de instalação e instalação do OCMT

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.

   

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.

   

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.

   

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

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

• Uma conta de Oracle.com (inscrição da conta Oracle.com)
• Uma conta do Oracle Cloud (inscrição na conta do Oracle Cloud)
• Um Banco de Dados Autônomo Oracle (Obter um Banco de Dados Autônomo Sempre Gratuito)
• Conta de serviço do Power BI Desktop (Obter o Power BI Desktop) ou do Power BI (Licenciando o serviço do Power BI para usuários em sua organização)
• Gateway de dados local se estiver usando o serviço do Power BI (Baixar e instalar um gateway padrão)

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.

   

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

   

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

   

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.

   

   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.

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.

   

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.

   

   Observação

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

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

Você também pode encontrar um dos vários erros porque a configuração não está 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.

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.

   

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

   

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.

   

Se tudo estiver 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.

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)

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, o conector do Oracle inclui um driver interno gerenciado de ODP.NET da Oracle para a conectividade. Esse recurso remove a necessidade de os usuários instalarem e gerenciarem o driver. Você pode habilitar esse recurso usando as instruções a seguir.

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.

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: could not resolve the connect identifier specified.
• ORA-12514: TNS: listener does not currently know of service requested in connect descriptor.
• ORA-12541: TNS: no listener.
• ORA-12170: TNS: connect timeout occurred.
• ORA-12504: TNS: listener was not given the SERVICE_NAME in CONNECT_DATA.

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, 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 .

Conteúdo relacionado

Otimizar o Power Query ao expandir colunas de tabela