Pular para o conteúdo principal
Última atualização em

Configurar o driver ADBC ou ODBC para o Power BI

info

Visualização

Este recurso está em Prévia Pública.

Conexões do Power BI com o Databricks usam um dos dois drivers: Arrow Database Connectivity (ADBC) ou Open Database Connectivity (ODBC). Arrow Database Connectivity (ADBC) é o default para todas as novas conexões do Power BI criadas na UI, mas as conexões preexistentes continuam a usar o ODBC, a menos que você as atualize manualmente. Esta página explica como alternar uma conexão entre os dois drivers.

O Arrow Database Connectivity (ADBC) driver é um padrão de API moderno e colunar projetado para aplicações analíticas, permitindo a transferência eficiente de dados entre bancos de dados e ferramentas de cliente usando o formato Apache Arrow. Para as atualizações mais recentes do driver ADBC, consulte o registro de alterações.

Para usar o driver ADBC, use o Power BI Desktop 2.145.1105.0 ou acima.

importante

O Power BI planeja fazer a transição de todas as conexões do Power BI para ADBC. O Databricks recomenda mudar para o ADBC e testá-lo agora para fornecer feedback e ajudar a garantir uma migração sem interrupções. Para o cronograma de transição e as opções de migração da Microsoft, consulte Transição de drivers ODBC para ADBC.

nota

Você deve usar apenas um tipo de driver por modelo semântico. Configure cada conexão Databricks em um modelo semântico para ADBC ou ODBC.

O Databricks continua a aprimorar este conector e a adicionar novos recursos. Atualize para a versão mais recente, experimente e envie feedback do produto.

Mudar conexões existentes para ADBC​

Algumas conexões existentes do Power BI continuam a usar o driver ODBC, a menos que você as atualize manualmente. Você pode alternar dashboards individuais para usar o ADBC editando a implementação.

Para alternar uma conexão existente para o Driver ADBC para um dashboard específico:

  1. Abra o painel desejado no Power BI.

  2. Click transformação de dados .

  3. Clique em **Editor Avançado** na seção de opções de **Query**.

  4. Especifique Implementation="2.0" para mudar para o driver ADBC.

    let
        Source = DatabricksMultiCloud.Catalogs("<instance-name>.cloud.databricks.net", "/sql/1.0/warehouses/<sql-warehouse-id>",
         [Catalog=null, Database=null, EnableAutomaticProxyDiscovery=null, Implementation="2.0"]),
        powerbi_Database = Source{[Name="powerbi",Kind="Database"]}[Data],
        default_Schema = powerbi_Database{[Name="default",Kind="Schema"]}[Data],
        dashboard_data_Table = default_Schema{[Name="dashboard_data",Kind="Table"]}[Data]
    in
        dashboard_data_Table

Conectar a um warehouse Lakehouse//RT​

O Lakehouse//RT aceita apenas conexões que usam a Statement Execution API, um caminho de execução baseado em REST. Ele não oferece suporte ao protocolo Thrift legado do qual o driver ODBC depende, portanto, você deve usar o driver ADBC.

Certifique-se de atender aos seguintes requisitos ao conectar a partir do Power BI:

  • Para o Power BI Desktop , a conexão com o Lakehouse//RT requer o Power BI Desktop v2.156.951.0 (julho de 2026) ou acima.
  • No Power BI service , a conexão com o Lakehouse//RT com o conector Databricks falha, porque o serviço testa conexões usando ODBC independentemente do driver que você configurar. Como solução alternativa, use o conector Azure Databricks . Você pode usar o conector Azure Databricks com um Workspace do Databricks em qualquer cloud autenticando-se com um personal access token (PAT) ou uma Service Principal.

Para conectar o Power BI Desktop ou o serviço Power BI a um warehouse Lakehouse//RT:

  1. Obtenha o Server hostname e o Caminho HTTP do seu warehouse Lakehouse//RT.
  2. Conecte-se ao warehouse a partir do Power BI, seguindo os passos de conexão para Power BI Desktop ou o serviço Power BI. Em Opções avançadas , defina ambas as opções a seguir:
    • Para Implementation , selecione 2.0 - ADBC , que utiliza o driver ADBC.
    • Para Protocolo , selecione REST(SEA) , que roteia query por meio da Statement Execution API.

Para as queries, tipos de tabela e recursos do Databricks compatíveis com o Lakehouse//RT, consulte Lakehouse Real-Time.

Voltar para o ODBC​

Caso prefira usar ODBC em vez de ADBC para novas conexões, você tem duas opções:

  • Se o senhor quiser usar o driver ODBC para uma conexão específica no Power BI Desktop ou no serviço do Power BI, selecione default como a **Implementação**.
  • Se você quiser continuar a usar o driver ODBC para todas as novas conexões no Power BI, desabilite a visualização do recurso ADBC para restaurar o ODBC no Power BI Desktop.

Para utilizar o Driver ODBC para todas as novas conexões:

  1. No Power BI Desktop, clique em **Arquivo > Opções e configurações > Opções**.
  2. Clique em Recurso de pré-visualização .
  3. Desmarque **Usar novas implementações do conector Databricks**.

Se você deseja configurar uma conexão específica para usar o driver ODBC, defina default como a **Implementação**. Consulte os passos descritos em Alternar conexões existentes para ADBC.

Recursos adicionais​

Nesta página