Transição de drivers ODBC para ADBC em Power BI e Fabric

Power BI e Microsoft Fabric estão migrando conexões com fontes de dados com suporte de drivers ODBC internos legados para drivers Apache Arrow Database Connectivity (ADBC). O ADBC fornece um conjunto de interfaces padrão para interagir com dados do Arrow, que é especialmente eficiente na busca de grandes conjuntos de dados com sobrecarga mínima, sem serialização ou cópia. Os drivers ADBC também incorporam aprimoramentos de segurança, como segurança da memória e coleta de lixo.

Você pode adotar o ADBC hoje em cada conexão, e os administradores podem controlar o comportamento padrão em escala usando uma configuração do locatário que os administradores do workspace podem substituir para fins de teste e validação.

Alterações nos conectores e no driver

A tabela a seguir lista os conectores que estão fazendo a transição de drivers ODBC inseridos para drivers de substituição. Na maioria dos casos, o driver de substituição é um driver ADBC.

Quem é afetado

Você será afetado se usar qualquer um dos conectores que fazem a transição para o ADBC (como Databricks, Snowflake ou Google BigQuery) e:

• Você não escolheu explicitamente uma implementação na conexão (o Implementation parâmetro não foi especificado) ou
• Sua organização deseja ter controle centralizado sobre se o ADBC ou ODBC é o padrão para conectores com suporte.

Esse padrão se aplica onde quer que você crie uma conexão, incluindo modelos semânticos, Fluxos de Dados Gen2 e relatórios paginados.

Como migrar

Você pode migrar de três maneiras, ordenadas pela quantidade de controle desejada:

• Adesão por conexão: adicione Implementation="2.0" em conexões individuais para validar ADBC no seu próprio ritmo.
• Configuração do locatário: defina o padrão em toda a organização por meio do portal de administração.
• Substituição no espaço de trabalho: substitui o padrão do locatário no nível do espaço de trabalho para validação lado a lado.

Aceitação por conexão

Você pode aderir ao ADBC adicionando Implementation="2.0" às conexões compatíveis. Essa abordagem permite validar o ADBC em seu próprio ritmo para conexões individuais.

Para obter instruções detalhadas sobre como ativar por conexão para um conector específico, consulte a documentação específica do conector vinculada na tabela Alterações de conectores e drivers.

Configuração do locatário

Os administradores de locatários podem definir o padrão da organização usando a configuração do portal de administração:

Os usuários podem se conectar a fontes de dados usando a conectividade de banco de dados do Apache Arrow (ADBC)

• Desabilitado (padrão): seleciona os drivers ODBC herdados como a opção padrão.
• Habilitado: seleciona os novos drivers ADBC como a opção padrão.

Essa configuração também controla o comportamento de Conexão de Teste para cada tipo de conexão dentro do locatário.

Substituição do espaço de trabalho

A configuração do locatário é delegada aos workspaces, para que os administradores do workspace possam substituir a configuração padrão e comparar os comportamentos sem modificar cada conexão individual. Essa abordagem permite validação lado a lado. Por exemplo, você pode usar um workspace para testar os padrões do ADBC, mantendo outro workspace em padrões ODBC.

Como a implementação é escolhida

Se você especificar explicitamente o parâmetro Implementation na conexão, esse valor sempre terá precedência sobre as configurações padrão do locatário ou do espaço de trabalho.

A tabela a seguir mostra como o driver é selecionado:

Comportamento do gateway de dados local

As configurações de ADBC do locatário e do workspace se aplicam aos fluxos de atualização executados no serviço em nuvem. As consultas que são roteadas por um gateway de dados local continuam a usar o driver incluído na instalação do gateway, que atualmente é o ODBC para os conectores listados neste artigo. As atualizações roteadas pelo gateway não passam a usar ADBC quando a configuração de locatário ou de espaço de trabalho está habilitada, e isso é o comportamento esperado.

Duas consequências a serem observadas ao planejar sua migração:

• Se você estiver usando um gateway para testar a transição para o ADBC, as atualizações por meio do gateway não refletirão o caminho do ADBC. Teste o ADBC usando uma conexão de nuvem para validar com precisão o comportamento do ADBC de ponta a ponta.
• Os clientes que precisam permanecer no ODBC (por exemplo, para preservar um caminho de link privado por meio do gateway) podem adiar a alteração continuando a rotear atualizações por meio do gateway local com os drivers ODBC instalados. Esse é um adiamento, não uma recusa permanente: uma vez que os drivers ODBC são removidos de futuras instalações de gateway (consulte datas de chave), os gateways fixados em versões anteriores eventualmente ficam sem suporte. Planeje atualizações de gateway e validação do ADBC adequadamente.

Lista de verificação de migração recomendada

1. Escolha um espaço de trabalho piloto e habilite o ADBC nele primeiro, por meio da substituição no nível do espaço de trabalho, para validar conjuntos de dados principais e cenários de atualização. Para validar o caminho do ADBC de ponta a ponta, teste usando uma conexão de nuvem – consulte o comportamento do gateway de dados local para saber por que as atualizações roteada por gateway permanecem no ODBC.
2. Valide no Power BI Desktop. Instale a versão atual do Power BI Desktop, que fornece o driver ADBC para cada conector no escopo que passou por sua inversão padrão. Não há uma opção por arquivo para forçar o uso do ADBC em uma consulta existente — para direcionar uma consulta existente ao ADBC, exclua a consulta, adicione novamente a origem e selecione novamente os campos. Atualize e compare as contagens de linhas, os tipos de coluna e a duração da atualização em relação à linha de base ODBC.
3. Para quaisquer conexões críticas que você queira validar imediatamente, ative individualmente para cada conexão com Implementation="2.0".
4. Depois que a validação for concluída, decida se deseja habilitar o ADBC por padrão no nível do locatário.

Datas-chave

• Julho de 2026 (previsto): começa a implantação ampla da configuração de locatário. O comportamento do workspace herda essa configuração, que pode ser alterada pelos administradores do workspace quando houver suporte.
• Agosto de 2026 (planejado): A Microsoft planeja começar a habilitar a configuração do locatário por padrão, em fases, sujeito à prontidão da implementação.
• Do final do 3º trimestre ao início do 4º trimestre de 2026 (planejado): A Microsoft planeja começar a remover os drivers ODBC do serviço, sujeito à prontidão da implementação. Se você precisar continuar usando ODBC (Implementation="1.0" ou configuração do espaço de trabalho Desativado), deverá usar um gateway para continuar executando consultas com ODBC.
• Primavera de 2027 (planejada): está previsto que os drivers ODBC mencionados neste artigo deixem de ser incluídos no Power BI Desktop ou no gateway.

Antes dos marcos de aplicação, a Microsoft planeja fornecer notificação prévia para que os clientes concluam as atividades de migração e validação.

Perguntas frequentes

Posso testar o ADBC agora?

Yes. Instale a versão atual do Power BI Desktop e adicione novamente qualquer fonte de dados no escopo — novas consultas passam a usar a ADBC imediatamente. Para testes do lado do serviço, use a substituição do workspace para habilitar o ADBC em um workspace piloto e validar por meio de uma conexão de nuvem.

Serei afetado se já estiver usando o gateway de dados local?

As configurações de ADBC do tenant e do workspace se aplicam apenas às execuções realizadas no serviço — elas não afetam as atualizações de dados roteadas por meio de um gateway de dados local. As atualizações roteadas por gateway continuam usando ODBC durante a transição para os conectores deste artigo. Consulte o comportamento do gateway de dados local. Está prevista a remoção dos drivers ODBC de instalações futuras do gateway — acompanhe as datas importantes para saber quando isso ocorrerá.

Como posso recusar a transição do ADBC?

Você não pode deixar isso desativado permanentemente. A configuração do tenant permite adiar a mudança padrão durante a janela de validação, mas, quando o ODBC for desabilitado no serviço, a alteração se aplicará a todos. Para continuar usando o ODBC após a transição no lado do serviço, você deve direcionar as atualizações por meio de um gateway de dados local (on-premises) com drivers ODBC instalados. Essa alteração é apenas um adiamento – os drivers ODBC estão planejados para serem removidos de futuras instalações de gateway.

Por que a configuração do ADBC do workspace não altera meu arquivo da área de trabalho do Power BI?

Não existe uma opção por arquivo para o ADBC no Power BI Desktop. As consultas existentes em um arquivo da Área de Trabalho permanecem em qualquer driver em que foram criadas até que a consulta seja recriada. Para validar o ADBC para uma consulta existente, exclua a consulta, adicione novamente a origem e selecione novamente os campos. Novas consultas na versão atual do Desktop são direcionadas automaticamente para o ADBC para conectores que já tiveram a alteração padrão ativada.

A configuração ADBC do espaço de trabalho reescreve minhas consultas M existentes?

Não. As configurações do locatário e do espaço de trabalho alteram o driver selecionado durante a execução da consulta, mas não modificam a expressão M em si — nomes de host, portas, parâmetros de conexão e argumentos do conector no seu M permanecem exatamente como foram definidos. Esse comportamento se aplica tanto a conexões novas quanto às já existentes: qualquer conexão que não defina explicitamente Implementation em M segue o padrão do espaço de trabalho/locatário no momento em que essa configuração muda.

As conexões que fixam o driver em M têm precedência sobre o padrão de workspace/locatário. Uma conexão com Implementation="1.0" permanece no ODBC, e uma conexão com Implementation="2.0" permanece no ADBC, independentemente da configuração do workspace ou do locatário. Para alterar um destes, edite o M.

Para obter um comportamento específico do conector (incluindo quaisquer diferenças de porta ou opção entre os drivers ODBC e ADBC), consulte a documentação específica do conector vinculada na tabela Conectores e alterações de driver .

Conteúdo relacionado

• Conector do Databricks
• Conector do Azure Databricks
• Conector do Google BigQuery
• Google BigQuery (Microsoft Entra ID) conector
• Conector impala
• Conector Snowflake