Banco de dados Oracle

Resumo

Pré-requisitos

Versões Oracle suportadas:

• Oracle Database Server 12c (12.1.0.2) e posterior
• Oracle Autonomous Database - todas as versões

A partir da versão de abril de 2025 do Power BI Desktop e da versão de maio de 2025 do on-premises data gateway, pode usar o driver ODP.NET gerido da Oracle integrado para se ligar à base de dados Oracle. Quando ativas esta funcionalidade, não precisas de instalar o OCMT manualmente. A partir de junho de 2026, pode também criar uma ligação cloud para a Oracle Autonomous Database ou outros endpoints cloud Oracle sem gateway. Saiba mais sobre este recurso.

Se não usar o novo driver Oracle incorporado, deve usar um gateway de dados empresarial local e instalar o Oracle Client for Microsoft Tools (OCMT) de 64 bits no computador que executa o gateway ou o Power BI Desktop. Para obter mais informações, consulte Gerenciar sua fonte de dados - Oracle.

Capacidades suportadas

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

Usar a opção Oracle Client para Microsoft Tools (OCMT)

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.

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

Ligue-se a uma base de dados Oracle local a partir do Power BI 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.

   

3. Se você estiver se conectando a partir do Power BI Desktop, selecione o Importar ou modo de conectividade de dados do DirectQuery. O restante destas etapas de exemplo usa o modo de conexão de dados Import. Para obter mais informações sobre o DirectQuery, consulte 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.

   

5. No Navigator, 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.

   

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

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

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 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 Oracle.com (Oracle.com Inscrição de Conta)
• 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)

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.

   

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

   

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

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.

   

   Observação

   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.

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.

   

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.

   

   Observação

   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 está 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 erro Oracle: ORA-28759: falha ao abrir o ficheiro 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.

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.

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.

Utilize o controlador Oracle integrado

Para o Modo de Importação no Power BI Desktop

Para a versão de junho de 2026 do Power BI Desktop ou gateway de dados local, o padrão é usar um driver ODP.NET gerido Oracle integrado para conectividade. Esse recurso elimina a necessidade de os usuários instalarem e gerenciarem o driver. Ainda pode optar por não usar esta funcionalidade usando as seguintes instruções.

Para não utilizar este controlador incorporado no Power BI Desktop, vá a Opções e definições (no separador Ficheiro) >Opções>Funcionalidades de pré-visualização e, em seguida, desmarque a caixa de verificação da opção Ativar a utilização do Oracle Managed ODP Provider incluído no Modo de Importação.

Para o modo DirectQuery no Power BI Desktop (Pré-visualização)

Para o modo DirectQuery, a utilização do driver ODP.NET gerido da Oracle ainda está em pré-visualização. Para aderir, use as seguintes instruções.

Para utilizar este controlador incorporado no Power BI Desktop, vá a Opções e definições (no separador Ficheiro) >Opções>Funcionalidades de pré-visualização e, em seguida, desmarque a caixa de verificação da opção Ativar a utilização do Oracle Managed ODP Provider incluído para o modo DirectQuery.

Para o modo de importação em gateway local

A partir da versão de junho de 2026, o gateway de dados no local utiliza, por predefinição, o controlador ODP.NET gerido da Oracle para a conetividade. Para não usar este driver incorporado no gateway de dados local para o modo Importação, altere as configurações do gateway para atualizar a MashupFlight_DisableOracleBundledOdacProviderV2 definição usando os seguintes passos:

1. Na máquina local onde 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 Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config original e localize a entrada MashupFlight_DisableOracleBundledOdacProviderV2.
4. Atualize o MashupFlight_DisableOracleBundledOdacProviderV2 valor para True.
5. Reinicie o seu gateway.

<Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.GatewayCoreSettings>
   ...
   <setting name="MashupFlight_DisableOracleBundledOdacProviderV2" serializeAs="String">
      <value>True</value>
   </setting>
   ...
</Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.GatewayCoreSettings>    

Para o modo DirectQuery no gateway on-premises (Pré-visualização)

O gateway de dados no local pode usar o controlador ODP.NET gerido pela Oracle integrado para DirectQuery. Este recurso está em pré-visualização.

Para resolver um alias TNS para DirectQuery, use uma variável de ambiente. A conta do serviço gateway não pode aceder a variáveis com âmbito de utilizador, por isso defina TNS_ADMIN no âmbito do sistema (máquina) e depois reinicie o serviço de gateway de dados local.

O driver incorporado não suporta autenticação de utilizador por proxy Oracle. Para mais informações e soluções alternativas, veja Oracle não é suportada a autenticação de utilizador por procuração.

Formas suportadas de especificar TNS_ADMIN com o driver Oracle incorporado

Existem três opções para especificar TNS_ADMIN:

• Configura a TNS_ADMIN no OADC.config
• Usar uma variável de ambiente
• Use definições de um OADC previamente instalado

Configura TNS_ADMIN em ODAC.config

Se estiver a usar o Oracle Driver incorporado e tiver acesso para modificar ficheiros de programa, pode especificar TNS_ADMIN no ficheiro de configuração ODAC.config usado pelo Oracle Driver incorporado. O ficheiro encontra-se na localização instalada do Power BI Desktop ou do gateway de dados local, na subpasta "ADO.NET Providers". Segue-se um exemplo de como especificar o caminho TNS_ADMIN, que é "C:\network\admin".

Este valor de configuração tem prioridade sobre outras opções.

Exemplo de configuração

<configuration>
 ...
 <oracle.manageddataaccess.client>
  <version number="*">
   <settings>
    <setting name="TNS_ADMIN" value="C:\network\admin" />
   </settings>
  </version>
 </oracle.manageddataaccess.client>
 ...
</configuration>

Note que TNS_ADMIN configurado no ODAC.config tem prioridade sobre uma configuração TNS_ADMIN no ambiente.

Usar uma variável de ambiente

Se o utilizador não tiver acesso para modificar ODAC.config, pode especificar TNS_ADMIN adicionando uma variável de ambiente TNS_ADMIN. A variável de ambiente pode ser uma variável de ambiente de sistema ou uma variável de ambiente de utilizador para o utilizador que executa o Power BI Desktop ou o On-premises Data Gateway. Defina o valor TNS_ADMIN para "C:\network\admin", por exemplo.

Definir TNS_ADMIN no ambiente (especialmente ao nível do sistema) pode fazer com que outras aplicações a correr nesta máquina captem os ficheiros de configuração de rede (como tnsnames.ora) da localização apontada por TNS_ADMIN.

Use as definições de um ODAC previamente instalado

Se o ODAC estiver instalado anteriormente e TNS_ADMIN estiver configurado, o Power BI irá descobrir automaticamente TNS_ADMIN.

As restantes configurações para ligar a uma base de dados Oracle a partir do Power Query Desktop são as mesmas descritas nas secções anteriores.

Lista de propriedades permitidas

Os utilizadores podem especificar nomes de servidores Oracle usando descritores de conexão, como (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=host_name)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=service_name))). O sistema impõe quais as propriedades que podem ser usadas no Ambiente de Trabalho e no Gateway. As propriedades permitidas por defeito em ODAC.config estão listadas na secção seguinte.

<configuration>
 ...
  <AllowLists>
    <!--
      Oracle connection strings can contain connection properties, for example  CONNECT_TIMEOUT.   Only connection properties explicitly set to true in the list below will
      be allowed with Power BI Desktop and the On Premises Data Gateway. Using our example, you can add "CONNECT_TIMEOUT":true to the list to enable it. To disable it you
      can remove it from the list, or set the value to false. This list will be enforced on all connection string types including connect descriptors and aliases
      referencing a tnsnames.ora entry. The use of any disallowed property in a connection string will result in an ORA-50122 error. Restart Power BI Desktop or the On-premises
      Data Gateway service after applying ODAC.config changes.
      For more information see https://docs.oracle.com/en/database/oracle/oracle-database/26/odpnt/InstallConnectionConfigurationRestriction.html
    -->
    <OnPremAllowList>{"DataSource":{"HOST":true,"PORT":true,"PROTOCOL":true,"HTTPS_PROXY":true,"HTTPS_PROXY_PORT":true,"ENABLE":true,"EXPIRE_TIME":true,"FAILOVER":true,"LOAD_BALANCE":true,"RECV_BUF_SIZE":true,"SDU":true,"SEND_BUF_SIZE":true,"SOURCE_ROUTE":true,"TYPE_OF_SERVICE":true,"COLOCATION_TAG":true,"CONNECTION_ID_PREFIX":true,"FAILOVER_MODE":true,"GLOBAL_NAME":true,"HS":true,"INSTANCE_NAME":true,"POOL_BOUNDARY":true,"POOL_CONNECTION_CLASS":true,"POOL_NAME":true,"POOL_PURITY":true,"RDB_DATABASE":true,"SHARDING_KEY":true,"SHARDING_KEY_ID":true,"SUPER_SHARDING_KEY":true,"SERVER":true,"SERVICE_NAME":true,"SID":true,"TUNNEL_SERVICE_NAME":true,"SSL_CLIENT_AUTHENTICATION":true,"SSL_CERTIFICATE_ALIAS":true,"SSL_CERTIFICATE_THUMBPRINT":true,"SSL_VERSION":true,"SSL_SERVER_DN_MATCH":true,"SSL_SERVER_CERT_DN":true,"WALLET_LOCATION":true,"CONNECT_TIMEOUT":true,"RETRY_COUNT":true,"RETRY_DELAY":true,"TRANSPORT_CONNECT_TIMEOUT":true,"RECV_TIMEOUT":true,"COMPRESSION":true,"COMPRESSION_LEVELS":true,"USE_SNI":true,"AUTHENTICATION_SERVICE":true,"IGNORE_ANO_ENCRYPTION_FOR_TCPS":true,"OCI_CONFIG_FILE":true,"OCI_DATABASE":true,"OCI_IAM_URL":true,"OCI_PROFILE":true,"OCI_TENANCY":true,"PASSWORD_AUTH":true,"REDIRECT_URI":true,"TENANT_ID":true,"TLS_VERSION":true,"TOKEN_AUTH":true,"TOKEN_LOCATION":true}}
    </OnPremAllowList>
  </AllowLists>
 ...
</configuration>

Os utilizadores podem modificar esta lista de propriedades permitidas se precisarem de adicionar novas propriedades ou remover propriedades da lista para impor regras mais rigorosas.

Limitações e considerações

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 é intencional.

Soluçã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: 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 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.

Quando utiliza o DirectQuery através do gateway de dados on-premises com o driver Oracle incorporado, erros como o seguinte podem indicar que um alias TNS não pode ser resolvido:

• ORA-12154: TNS name resolution failure
• ORA-50201: Failed to connect to server

Se encontrar estes erros, verifique se o TNS_ADMIN está definido ao nível do sistema (máquina) e se a conta de serviço do gateway consegue aceder à pasta para a qual este aponta e, em seguida, reinicie o serviço de gateway de dados no local. Para mais informações, consulte Formas suportadas de especificar TNS_ADMIN com o driver Oracle incorporado e o guia da Oracle Resolução de problemas do Oracle Net Services.

Problemas conhecidos com o driver Oracle incorporado

Os seguintes problemas conhecidos são específicos do driver ODP.NET gerido da Oracle incorporado. Várias das soluções alternativas recorrem ao driver ODP.NET não gerido ao desligar o driver incorporado. Para os passos de desligamento de cada superfície — Power BI Desktop Import e DirectQuery, e gateway Import e DirectQuery — veja Usar o driver Oracle incorporado.

Os alias TNS numa partilha de rede não são resolvidos

Aplica-se ao gateway de dados local, tanto em Import como em DirectQuery.

Quando os ficheiros de configuração da sua rede Oracle (tnsnames.ora ou o TNS_ADMIN diretório) são armazenados numa partilha de rede (caminho UNC), o driver incorporado falha consistentemente em resolver o nome do serviço de rede (alias TNS). Você pode ver ORA-12154: TNS:could not resolve the connect identifier specified ou ORA-50201: Failed to connect to server. O mesmo alias resolve corretamente com o driver ODP.NET não gerido, ou quando os ficheiros estão num caminho local. O driver gerido incorporado não lê de forma fiável os ficheiros de configuração de rede Oracle a partir de uma localização UNC.

Use uma das seguintes soluções alternativas:

• Copia tnsnames.ora (e sqlnet.ora se usares) para uma pasta num disco local, e depois aponta o driver para essa pasta. Veja Formas suportadas de especificar TNS_ADMIN com o driver Oracle incorporado. Para o gateway DirectQuery, defina TNS_ADMIN no âmbito do sistema (máquina), porque a conta do serviço gateway não consegue ler variáveis com escopo de utilizador, e depois reinicie o serviço gateway.
• Certifique-se de que a conta de serviço que executa o gateway tem acesso à partilha de rede.
• Introduza um descritor Easy Connect diretamente no Server (por exemplo, host:port/service_name) em vez de um tnsnames.ora alias, por isso não é necessário nenhum ficheiro de configuração de rede.
• Desligue o driver incorporado para voltar ao driver não gerido ODP.NET, que pode ler os ficheiros da partilha.

NLS_LANG é ignorado

Aplica-se ao Power BI Desktop, ao gateway de dados local, e às ligações cloud do serviço Power BI, tanto no Import como no DirectQuery.

Com o driver incorporado, a linguagem de sessão da Oracle, os formatos de território, número e data seguem a cultura .NET da máquina (configurações regionais e de formato do Windows), e não a NLS_LANG variável de ambiente. Definir ou alterar NLS_LANG não tem efeito. Dependendo da região da máquina, este comportamento pode fazer com que números ou datas sejam analisados com separadores ou ordem de datas errados, consultas que retornem zero linhas ou valores incorretos, ou erros como ORA-01722, ORA-01858, ORA-01861, ou ORA-01843. Por exemplo, um relatório escrito numa máquina configurada para inglês (Estados Unidos) pode devolver zero linhas ou erros numa máquina definida para inglês (Reino Unido). O driver ODP.NET gerido deriva as suas definições de Suporte Nacional de Línguas (NLS) da cultura do thread .NET em vez de NLS_LANG, ao contrário do driver não gerido ODP.NET, que honra NLS_LANG.

Use uma das seguintes soluções alternativas:

• Ajuste as definições regionais da máquina com a localização para a qual os seus dados e consultas foram desenhados.
• Desligue o driver incorporado para voltar ao driver ODP.NET não gerido, que honra NLS_LANG.

Para informações sobre o comportamento de globalização dos drivers geridos, consulte a documentação de Suporte à Globalização da Oracle.

FetchSize no registo não é usado pelo driver incorporado

Aplica-se ao Power BI Desktop e ao gateway de dados local, para modelos Oracle Import.

Depois de mudar para o driver incorporado, os modelos Oracle Import podem atualizar-se mais lentamente do que com o driver ODP.NET não gerido. O fornecedor ODP.NET gerido incorporado não lê a FetchSize propriedade do registo. O padrão FetchSize para os fornecedores não geridos e geridos ODP.NET é 128 KB na versão 23.26.2 e anteriores, incluindo o fornecedor 23.6 que o Power BI inclui. O fornecedor gerido ignora qualquer FetchSize sobreposição configurada no registo.

Desligue o driver incorporado para voltar ao driver não gerido ODP.NET, que respeita a definição do registoFetchSize. No gateway de dados local, defina MashupFlight_DisableOracleBundledOdacProviderV2 para True na configuração do fornecedor agrupado nas definições do gateway.

A autenticação por utilizador por proxy Oracle não é suportada

Aplica-se ao data gateway local (versão de junho de 2026 e posteriores), para Oracle Import e DirectQuery que utilizam uma conta proxy Oracle.

Depois de atualizar para o gateway de junho de 2026, que por defeito é o fornecedor gerido incorporado, o Power BI reporta que a ligação à Oracle através de uma conta proxy Oracle falha tanto na Importação como no DirectQuery. A mesma fonte de dados funciona quando a ligação usa uma conta Oracle não proxy. A autenticação de utilizador por proxy da Oracle Database — ligar-se como um utilizador da base de dados em nome de outro esquema (por exemplo, o User Id=proxy_user[target_schema] formulário) — não é suportada pela versão 23.6 do fornecedor ODP.NET gerido incorporado que atualmente vem com o Power BI.

Use uma das seguintes soluções alternativas:

• Use uma conta Oracle não proxy sempre que possível.
• Para Importação, desative o driver incorporado para Importação no gateway definindo MashupFlight_DisableOracleBundledOdacProviderV2 para True, para que o gateway volte ao driver ODP.NET não gerido, que suporta contas proxy.
• Para o DirectQuery, a definição de Importação não se aplica. Contacte o Suporte da Microsoft para desativar o driver incorporado do caminho DirectQuery do gateway. Esta configuração já não é self-service.

Não é possível atualizar as credenciais pessoais de ligação Oracle à cloud

Aplica-se ao serviço Power BI, para ligações pessoais Oracle na cloud.

Na página Gerir ligações e gateways no serviço Power BI, atualizar as credenciais de uma ligação pessoal Oracle na cloud não funciona. Em vez disso, atualize as credenciais a partir do painel de definições semânticas do modelo:

1. Abre o painel de definições do modelo semântico e vai a Gateway e ligações na cloud.
2. Defina a fonte de dados para usar a ligação pessoal à cloud.
3. Em Credenciais da fonte de dados, edite as credenciais da fonte de dados.

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

Conteúdo relacionado

Otimizar o Power Query ao expandir colunas da tabela