Oracle database
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:
Selecione a opção de banco de dados Oracle na seleção do conector.
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.
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.
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.
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:
Instale e configure um gateway de dados local.
No Power Query Online, selecione a opção de banco de dados Oracle na seleção de fontes de dados.
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.
Forneça um nome de conexão, como "testoracleserver".
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.
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.
Introduza as suas credenciais.
Selecione Seguinte para continuar.
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:
- Uma conta Oracle.com (inscrição na conta Oracle.com)
- Uma conta do Oracle Cloud (inscrição na conta do Oracle Cloud)
- Um banco de dados autônomo Oracle (obtenha um banco de dados autônomo sempre gratuito)
- Power BI Desktop (Obter o Power BI Desktop) ou conta de serviço 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)
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:
Na página de detalhes do banco de dados Oracle Autonomous , selecione DB Connection.
Na página Conexão de Banco de Dados, selecione Baixar Carteira.
Introduza uma palavra-passe que gostaria de utilizar com esta carteira, confirme a palavra-passe e, em seguida, selecione Transferir.
Configurar credenciais do Oracle ADB
Na sua máquina Windows, vá para a pasta onde você baixou suas credenciais Oracle ADB de Baixar suas credenciais de cliente.
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.
Nota
O arquivo tnsnames.ora define o endereço e as informações de conexão do Oracle Autonomous Database.
Abra sqlnet.ora em um editor, como o Bloco de Notas.
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)))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.
Conectar o Power BI Desktop ao Oracle ADB
Abra Power BI Desktop.
Selecione Obter Dados.
Em Obter Dados, selecione Banco de Dados> Oracle.
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.
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.
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.
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.
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
Instale e configure um gateway de dados local.
No serviço Power BI, selecione o ícone de engrenagem no canto superior direito e, em seguida, selecione Gerir gateways.
Em Adicionar Fonte de Dados, selecione Adicionar fontes de dados para usar o gateway.
Em Nome da Fonte de Dados, insira o nome que você deseja usar como a configuração da fonte de dados.
Em Tipo de Fonte de Dados, selecione Oracle.
Em Servidor, insira o nome do serviço de rede do servidor Oracle Autonomous Database ao qual se conectar.
Em Método de autenticação, selecione Básico.
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.
Selecione Adicionar.
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.