Partilhar via

Oracle database

  • Artigo

Resumo

Item Description
Estado de Lançamento Disponibilidade Geral
Produtos Excel
Power BI (modelos semânticos)
Power BI (Fluxos de Dados)
Malha (Dataflow Gen2)
Power Apps (Fluxos de Dados)
Dynamics 365 Customer Insights
Analysis Services
Tipos de autenticação suportados Windows (desktop/online)
Base de dados (ambiente de trabalho)
Básico (online)
Conta Microsoft (ambiente de trabalho)
Documentação de referência da função Oracle.Database

Nota

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 Oracle suportadas:

  • Oracle Database Server 12c (12.1.0.2) e posterior
  • Oracle Autonomous Database - 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, vá para Gerenciar sua fonte de dados - Oracle.

Capacidades suportadas

  • Importar
  • DirectQuery (modelos semânticos do Power BI)
  • Opções avançadas
    • Tempo limite do comando em minutos
    • SQL statement
    • Incluir colunas de relação
    • Navegar utilizando hierarquia completa

Baixe e instale o Oracle Client for Microsoft Tools

O Oracle Client for Microsoft Tools instala e configura o Oracle Data Provider for .NET (ODP.NET) para oferecer suporte a conexões de ferramentas Microsoft de 32 bits e 64 bits com bancos de dados Oracle locais e em nuvem, incluindo o Oracle Autonomous Database (ADB). O OCMT é um instalador gráfico que automatiza o processo de configuração do Oracle Database Client. Ele oferece suporte à conexão com o Power BI Desktop, serviço Power BI, Malha (Dataflow Gen2), Excel, SQL Server Analysis Services, SQL Server Data Tools, SQL Server Integration Services, SQL Server Reporting Services e BizTalk Server.

OCMT é software livre. Ele pode ser baixado da página Oracle Client for Microsoft Tools. Para o Power BI Desktop de 64 bits e o serviço do Power BI, 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 Power BI, é altamente recomendável usar o instalador OCMT para concluir corretamente todas as etapas de configuração que o Power BI requer para trabalhar com o banco de dados Oracle.

Ligar a uma base de dados Oracle local a partir do Power Query Desktop

Para estabelecer a ligação, siga os seguintes passos:

  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) à qual se conectar no servidor. O Easy Connect é o mais simples de usar definindo o valor Server como Hostname/ServiceName do servidor Oracle Database, onde ServiceName é o nome global do banco de dados. A captura de tela a seguir usa um nome de serviço de rede.

    Insira a conexão do banco de dados Oracle.

  3. Se estiver a ligar a partir 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, vá para Usar 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)
    • Base de dados (Nome de utilizador e palavra-passe)
    • Conta Microsoft (Microsoft Entra ID)

    Para obter mais informações sobre autenticação, vá para Autenticação com uma fonte de dados.

    Insira suas credenciais de banco de dados Oracle.

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

Ligar a uma base de dados Oracle local a partir do Power Query Online

Para estabelecer a ligação, siga os seguintes passos:

  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 de rede Oracle/alias TNS, a cadeia de conexão Easy Connect Plus ou o descritor de conexão ao qual se conectar no Servidor.

    Insira a conexão on-line do banco de dados Oracle.

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

  5. Selecione o nome do seu gateway de dados local.

    Nota

    Você deve selecionar um gateway de dados local para esse conector, quer o banco de dados Oracle esteja 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 em Tipo de autenticação. Escolha Básico se você planeja entrar com um nome de usuário e senha Oracle. Escolha Windows ao usar a autenticação do sistema operacional Windows e com o cliente e o servidor Oracle em execução no Windows.

  7. Introduza as suas credenciais.

  8. Selecione Seguinte para continuar.

  9. No Navegador, selecione os dados de que necessita e, em seguida, selecione Transformar dados para transformar os dados no Power Query Editor.

Conectar-se a um banco de dados autônomo Oracle

Nota

Atualmente, você pode se conectar a um banco de dados autônomo Oracle do Excel, Power BI Desktop, serviço Power BI, malha (Dataflow Gen2), Power Apps, SQL Server Analysis Services e BizTalk Server usando os procedimentos desta 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 gerenciados para se conectar ao Oracle Autonomous Database usando procedimentos amplamente semelhantes.

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

Faça o download das credenciais do seu cliente

A primeira etapa na configuração de uma conexão com o banco de dados Oracle Autonomous é fazer o download das credenciais do cliente.

Para baixar as credenciais do cliente:

  1. Na página de detalhes do banco de dados Oracle Autonomous , selecione DB Connection.

    Conexão DB.

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

    Faça o download da carteira.

  3. Introduza uma palavra-passe que gostaria de utilizar com esta carteira, confirme a palavra-passe e, em seguida, selecione Transferir.

    Palavra-passe da carteira.

Configurar credenciais do Oracle ADB

  1. Na sua máquina Windows, vá para a pasta onde você baixou suas credenciais Oracle ADB de Baixar suas credenciais de cliente.

  2. Descompacte as credenciais no diretório especificado no OCMT como o Diretório do Arquivo de Configuração 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.

    Nota

    O arquivo tnsnames.ora define o endereço e as informações de conexão do Oracle Autonomous Database.

  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 de rede ADB aos quais você pode se conectar. Neste exemplo, os nomes são contosomart_high, contosomart_low e contosomart_medium. Os nomes dos serviços de rede do ADB são diferentes.

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

Conectar o Power BI Desktop ao Oracle ADB

  1. Abra Power BI Desktop.

  2. Selecione Obter Dados.

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

  4. Insira o nome do serviço de rede do servidor Oracle Autonomous Database 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 estiver a iniciar sessão neste servidor a partir do Power BI Desktop pela primeira vez, ser-lhe-á pedido que introduza as suas credenciais. Selecione Banco de Dados e 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 Oracle Autonomous Database específico ao qual você deseja se conectar. Neste exemplo, o nome de usuário e a senha iniciais do administrador do banco de dados são usados. Em seguida, selecione Conectar.

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

    Nota

    Você pode usar a autenticação Microsoft Entra ID para entrar no Oracle Autonomous Database por meio da opção de conta da Microsoft.

Neste ponto, o Navigator aparece e exibe os dados de conexão.

Imagem com o navegador aberto e a base de dados contosomart_high mostrada com todos os seus

Você também pode se deparar com um dos vários erros porque a configuração não foi configurada corretamente. Esses erros são discutidos em Solução de problemas.

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

Imagem do Navigator com o nome da base de dados na parte superior, mas aparece um erro em vez dos dados.

Se esse erro ocorrer, certifique-se de que o caminho da pasta da carteira fornecido no 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 Power BI, selecione o ícone de engrenagem no canto superior direito e, em seguida, selecione Gerir gateways.

    Imagem do serviço do Power BI aberta, 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 Power BI, com Adicionar fonte de dados para usar o gateway enfatizado.

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

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

  6. Em Servidor, insira o nome do serviço de rede do servidor Oracle Autonomous Database ao qual se conectar.

  7. Em Método de autenticação, selecione Básico.

  8. Digite o nome de usuário e a senha do Oracle Autonomous Database. Neste exemplo, o nome de usuário (ADMIN) e a senha padrão do administrador do banco de dados 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, será exibida uma mensagem Conexão bem-sucedida . Agora pode ligar à Base de Dados Autónoma Oracle utilizando os mesmos passos descritos em Ligar a uma base de dados Oracle no local a partir do Power Query Online.

Conecte-se usando opções avançadas

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

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

Opção avançada Description
Tempo limite do comando em minutos Se a sua ligação durar mais de 10 minutos (o tempo limite predefinido), pode introduzir outro valor em minutos para manter a ligação aberta por mais tempo. Esta opção só está disponível no Power Query Desktop.
SQL statement Para obter informações, vá para Importar dados de um banco de dados usando consulta de banco de dados nativa.
Incluir colunas de relação Se estiver marcada, inclui colunas que podem ter relações com outras tabelas. Se essa caixa estiver desmarcada, essas colunas não aparecerão.
Navegar utilizando hierarquia completa Se estiver marcada, o navegador exibirá a hierarquia completa de tabelas no banco de dados ao qual você está se conectando. Se estiver desmarcado, o navegador exibe 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 seu banco de dados Oracle.

Problemas e limitações conhecidos

As sessões do Power BI ainda podem ficar ativas em seu banco de dados Oracle por aproximadamente 30 minutos após uma atualização do modelo semântico para esse banco de dados Oracle. Somente após aproximadamente 30 minutos essas sessões se tornam inativas/removidas no banco de dados Oracle. Este comportamento é a predefinição.

Resolução de Problemas

Você pode se deparar com 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 não sabe atualmente do serviço solicitado no descritor connect.
  • ORA-12541: TNS: sem ouvinte.
  • ORA-12170: TNS: ocorreu o tempo limite de conexão.
  • ORA-12504: TNS: ouvinte não recebeu o SERVICE_NAME em CONNECT_DATA.

Esses erros podem ocorrer se o descritor de conexão de banco de dados Oracle tnsnames.ora estiver configurado incorretamente, o nome do serviço de rede fornecido estiver escrito incorretamente ou se o ouvinte do banco de dados Oracle não estiver em execução ou não estiver acessível, como um firewall bloqueando o ouvinte ou a porta do banco de dados. Certifique-se de que está a cumprir os pré-requisitos mínimos de instalação. Mais informações: Pré-requisitos

Visite o Oracle Database Error Help Portal para revisar causas e resoluções comuns para o erro específico do Oracle encontrado. Insira o erro Oracle na barra de pesquisa do portal.

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

  • Transfira o Power BI Desktop a partir do Centro de Transferências 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 em Gerenciar sua fonte de dados - Oracle.

Se você estiver usando o Servidor de Relatório do Power BI, consulte as orientações no artigo Tipo de Conexão Oracle.

Próximos passos

Otimizar o Power Query ao expandir colunas de tabela