Azure Databricks

Observação

Esse conector é de propriedade e fornecido pelo Databricks.

Resumo

Property Value
Conector ícone Azure Databricks Azure Databricks
Produtos Power BI (modelos semânticos)
Power Query Online
Estado de liberação Disponibilidade geral
Category Database
Tipos de autenticação Active Directory do Azure
Credenciais do cliente do Databricks
Token de acesso pessoal
Autenticação específica do produto Service Principal (Power BI/Fabric)
Identidade do workspace (Power BI/Fabric)
Variante de fonte de dados Databricks
Documentação de referência da função Databricks.Catalogs
Databricks.Contents
Databricks.Query

Importante

O conector do Azure Databricks para Power BI agora dá suporte ao driver Arrow Database Connectivity (ADBC). Este conector está em transição do driver Simba Spark ODBC integrado para o driver Databricks ADBC. Para obter diretrizes de migração, datas-chave e controles de administrador, consulte Transition de ODBC para drivers ADBC em Power BI e Fabric.

Pré-requisitos

Para redes privadas, você precisará implementar as seguintes configurações de rede:

  • *.blob.core.windows.net* e *.store.core.windows.net precisam ser abertos em seu ambiente de rede.
  • Essa lista de downloads e revogações de certificados também precisa ser adicionada à sua lista de permissões.
  • Se o suporte ao firewall estiver habilitado em sua conta de armazenamento do workspace do Databricks, você deverá configurar um gateway de dados de rede virtual ou um gateway de dados local para permitir o acesso privado à conta de armazenamento. Isso garante que o serviço Power BI do Fabric possa continuar a acessar a conta de armazenamento do workspace e que o CloudFetch continue funcionando corretamente. Como alternativa, você pode desabilitar o CloudFetch com a configuração EnableQueryResultDownload=0.

Capacidades suportadas

  • Importação
  • DirectQuery (modelos semânticos Power BI)

Parameters

Ponto de entrada:Databricks.Catalogs

Contagem de parâmetros necessária: 2

Parameter Nome de exibição Required Tipo Group Descrição Valores de exemplo Anulável
hospedar Nome do host do servidor Yes enviar SMS O nome do host do servidor Databricks. "example.azuredatabricks.net" falso
httpPath Caminho HTTP Yes enviar SMS O caminho HTTP do cluster. "/sql/1.0/warehouses/abcdef1234567890" falso
Opções Opções Avançadas Não Registro anulável Opções Avançadas true

Campos em options

Campo Nome de exibição Required Tipo Group Descrição Padrão declarado Valores permitidos Valores de exemplo Anulável Optional Metadados de valores permitidos Valores permitidos definidos
options.Catalog Catálogo padrão Não enviar SMS Opções Avançadas Selecione um catálogo padrão para a conexão. falso true
options.Database Database Não enviar SMS Opções Avançadas Limite a conexão ao banco de dados selecionado. Isso pode tornar a listagem de tabelas mais rápida, no entanto, impedirá o dobramento de consulta para consultas que atingem vários bancos de dados diferentes. falso true
options.QueryTags Etiquetas de consulta Não enviar SMS Opções Avançadas Tags de chave-valor para acompanhar consultas na tabela system.query.history. "tag1:value1,tag2:value2" falso true
options.EnableAutomaticProxyDiscovery Descoberta automática de proxy Não enviar SMS Opções Avançadas Isso permite a descoberta automática de proxy em todo o sistema Windows. "Habilitado" (Habilitado); "Desabilitado" (Desabilitado (padrão)) falso true [{"Metadata": {"Documentation.Caption": "Enabled", "Documentation.Name": "AutomaticProxyDiscoveryFlag.Enabled"}, "Value": "enabled"}, {"Metadata": {"Documentation.Caption": "Disabled (default)", "Documentation.Name": "AutomaticProxyDiscoveryFlag.Disabled"}, "Value": "disabled"}] ["habilitado", "desabilitado"]
opções.Implementação Implementation Não enviar SMS Opções Avançadas Use '2.0 (beta)' para especificar o ADBC. O valor 'padrão' usará a configuração de ambiente para determinar qual driver usar. "2.0" "2.0" (2.0 – ADBC); null (Padrão do Sistema) falso true ["2.0", null]
options.Protocol Protocol Não enviar SMS Opções Avançadas Especifica o protocolo usado pelo driver ADBC. Selecione 'REST (SEA)' para usar a API de Execução de Declaração. Quando não definido, o padrão do driver (Thrift) é usado. nulo null (padrão); "rest" (REST (SEA)) falso true [null, "rest"]

Conectar-se do Power Query Desktop

AWS, Azure ou GCP

Para se conectar ao Databricks do Power Query Desktop, execute as seguintes etapas:

  1. Na interface de Obter Dados, pesquise por Databricks para selecionar o conector do Databricks, Azure Databricks. Use o conector Azure Databricks para todos os dados do Databricks SQL Warehouse, a menos que você tenha sido instruído de outra forma pelo representante do Databricks.

    Captura de tela da caixa de diálogo Obter Dados para o Databricks Cloud.

  2. Forneça o nome do host do servidor e o caminho HTTP para o Databricks SQL Warehouse. Consulte Configurar os drivers ODBC e JDBC do Databricks para obter instruções para pesquisar seu "Nome do host do servidor" e o "Caminho HTTP". Insira essas informações adequadamente. Opcionalmente, você pode fornecer um catálogo e/ou banco de dados padrão em Opções Avançadas. Selecione OK para continuar.

    Captura de tela dos campos de conexão do Databricks SQL Warehouse.

  3. Forneça suas credenciais para autenticar com o Databricks SQL Warehouse. Há três opções para credenciais:

    • Credenciais do cliente do Databricks. Consulte o Databricks OAuth M2M para obter instruções sobre como gerar credenciais de cliente OAuth M2M do Databricks.

    • Token de Acesso Pessoal (utilizável para AWS, Azure ou GCP). Para obter instruções sobre como gerar um PAT (Token de Acesso Pessoal), consulte tokens de acesso pessoal.

    • Azure Active Directory (utilizável apenas para Azure). Entre em sua conta organizacional usando o pop-up do navegador.

      Captura de tela do campo de entrada de token do Databricks.

    Observação

    Depois de inserir suas credenciais para um SQL Warehouse do Databricks específico, Power BI Desktop armazena em cache e reutiliza essas mesmas credenciais em tentativas de conexão subsequentes. Você pode modificar essas credenciais indo até Arquivo > Opções e configurações > Configurações de fonte de dados. Mais informações: Alterar o método de autenticação

  4. Depois de se conectar com êxito, o Navegador mostrará os dados que estarão disponíveis a você no cluster. Você pode escolher Transform Data para transformar os dados usando Power Query ou Load para carregar os dados na Área de Trabalho Power Query.

    Imagem do navegador Power Query carregando dados do Databricks Cloud para o aplicativo da área de trabalho.

Conectar-se do Power Query Online

Para se conectar ao Databricks do Power Query Online, execute as seguintes etapas:

  1. Selecione a opção Azure Databricks na experiência de obtenção de dados. Aplicativos diferentes têm diferentes maneiras de acessar a experiência de obtenção de dados do Power Query Online. Para obter mais informações sobre como acessar a experiência de obtenção de dados do Power Query Online a partir do seu aplicativo, acesse Onde obter dados.

    Liste os conectores do Databricks disponíveis usando a caixa de pesquisa. Use o conector Azure Databricks para todos os dados do Databricks SQL Warehouse, a menos que você tenha sido instruído de outra forma pelo representante do Databricks.

    Screenshot das opções do conector do Databricks em Power Query.

  2. Insira o Nome do host do servidor e o Caminho HTTP para o Databricks SQL Warehouse. Consulte Configurar os drivers ODBC e JDBC do Databricks para obter instruções para pesquisar seu "Nome do host do servidor" e o "Caminho HTTP". Opcionalmente, você pode fornecer um catálogo e/ou banco de dados padrão em Opções Avançadas.

    Captura de tela das configurações e credenciais de conexão do Azure Databricks.

  3. Forneça suas credenciais para autenticar com o Databricks SQL Warehouse. Há quatro opções de credenciais:

    • Credenciais do cliente do Databricks. Para obter instruções sobre como gerar credenciais de cliente OAuth M2M do Databricks, consulte Databricks OAuth M2M.
    • Token de Acesso Pessoal (utilizável para AWS, Azure ou GCP). Consulte Tokens de Acesso Pessoal para obter instruções sobre como gerar um Token de Acesso Pessoal (PAT).
    • Azure Active Directory (utilizável apenas para Azure). Entre em sua conta organizacional usando o pop-up do navegador.
    • Entidade de serviço (utilizável somente para Azure). Autentique-se com uma entidade de serviço do Microsoft Entra ID. Essa opção está disponível ao configurar uma conexão de nuvem ou gateway.
  4. Depois que você se conectar com êxito, o Navegador aparece e exibe os dados disponíveis no servidor. Selecione seus dados no navegador. Em seguida, selecione Next para transformar os dados em Power Query.

    Captura de tela do navegador do Power Query carregando dados do Databricks Cloud para o aplicativo online.

Informações adicionais

Implementação do conector de driver de conectividade com banco de dados Arrow

Você pode usar o driver Arrow Database Connectivity (ADBC) para o conector Azure Databricks no Power BI. À medida que continuamos a aprimorar e adicionar novos recursos a esse conector, recomendamos que você atualize para a versão mais recente para experimentá-la e enviar comentários sobre o produto.

Observação

Desde fevereiro de 2026, novas conexões criadas no Power BI Desktop ou no Power BI Service usarão automaticamente o driver de Conectividade de Banco de Dados Arrow (ADBC) por padrão. As conexões existentes continuarão a usar o ODBC, a menos que você as atualize manualmente para o ADBC.

Para mudar para o driver ADBC:

  1. Abra o painel desejado no Power BI.
  2. Selecione Transformar Dados.
  3. Selecione Editor Avançado na seção de opção Query.
  4. Especifique Implementation="2.0" para o ADBC.
    let
        Source = Databricks.Catalogs("adb-<workspace-id>.<random-number>.azuredatabricks.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
    

Limitações e considerações

  • O conector Azure Databricks dá suporte ao proxy web. No entanto, não há suporte para configurações automáticas de proxy definidas em arquivos .pac.
  • No conector Azure Databricks, a fonte de dados Databricks.Query não é suportada em combinação com o modo DirectQuery do modelo semântico do Power BI.