Azure Databricks

Observação

Este conector pertence e é fornecido pela Databricks.

Resumo

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

Importante

O conector Azure Databricks para Power BI suporta agora o driver Arrow Database Connectivity (ADBC). Este conector está a transitar do controlador ODBC Simba Spark incorporado para o controlador ADBC da Databricks. Para orientações de migração, datas-chave e controlos administrativos, veja Transição de drivers ODBC para ADBC em Power BI e Fabric.

Pré-requisitos

Para redes privadas, terá de implementar as seguintes definições de rede:

  • *.blob.core.windows.net* e *.store.core.windows.net precisam estar abertos no ambiente de rede.
  • Esta lista de downloads e revogações de certificados também precisa ser adicionada à sua lista de permissões.
  • Se o suporte de firewall estiver ativado na sua conta de armazenamento do Databricks, deve configurar um gateway de rede de dados virtual ou um gateway de dados on-premises para permitir acesso privado à conta de armazenamento. Isto garante que o Fabric serviço Power BI pode continuar a aceder à conta de armazenamento do espaço de trabalho e que o CloudFetch continua a funcionar corretamente. Alternativamente, pode desativar o CloudFetch com a configuração EnableQueryResultDownload=0.

Capacidades suportadas

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

Parameters

Ponto de entrada:Databricks.Catalogs

Contagem de parâmetros obrigatória: 2

Parameter Nome de exibição Required Tipo Group Descrição Valores da amostra Anulável
alojar Nome do host do servidor Yes enviar SMS O nome de host do servidor Databricks. "example.azuredatabricks.net" false
httpPath Caminho HTTP Yes enviar SMS O caminho HTTP do cluster. /sql/1.0/warehouses/abcdef1234567890 false
options Opções Avançadas No Registo anulável Opções Avançadas true

Campos em options

Field Nome de exibição Required Tipo Group Descrição Predefinição declarada Valores permitidos Valores da amostra Anulável Optional Metadados do valor permitido Valores permitidos especificados
options.Catalog Catálogo padrão No enviar SMS Opções Avançadas Selecione um catálogo predefinido para a ligação. false true
options.Database Database No enviar SMS Opções Avançadas Limite a ligação à base de dados selecionada. Isto pode tornar mais rápido listar tabelas, no entanto evita o query folding para consultas que atingem múltiplas bases de dados diferentes. false true
options.QueryTags Tags de consulta No enviar SMS Opções Avançadas Etiquetas de chave-valor para acompanhar consultas na tabela system.query.history. "tag1:value1,tag2:value2" false true
options.EnableAutomaticProxyDiscovery Descoberta Automática de Proxy No enviar SMS Opções Avançadas Isto permite a descoberta automática de proxy em todo o sistema Windows. "ativado" (Ativado); "desativado" (Desativado (por defeito)) false true [{"Metadata": {"Documentation.Caption": "Ativado", "Documentation.Name": "AutomaticProxyDiscoveryFlag.Enabled"}, "Value": "enabled"}, {"Metadata": {"Documentation.Caption": "Desativado (por defeito)", "Documentation.Name": "AutomaticProxyDiscoveryFlag.Disabled"}, "Value": "disabled"}] ["ativado", "desativado"]
options.Implementation Implementation No enviar SMS Opções Avançadas Utilize '2.0 (beta)' para especificar ADBC. O valor 'padrão' usará a configuração do ambiente para determinar qual o driver a usar. "2.0" "2.0" (2.0 - ADBC); null (Padrão do Sistema) false true ["2.0", null]
options.Protocol Protocolo No enviar SMS Opções Avançadas Especifica o protocolo utilizado pelo driver ADBC. Selecione 'REST (SEA)' para usar a API de Execução de Instrução. Quando não está definido, o driver default (Thrift) é usado. null null (Padrão); "rest" (REST (SEA)) false true [null, "rest"]

Conectar-se a partir do Power Query Desktop

AWS, Azure ou GCP

Para se ligar a Databricks a partir do Power Query Desktop, siga os seguintes passos:

  1. Na experiência Get Data, pesquise por Databricks para selecionar o conector Databricks, Azure Databricks. Utilize o conector Azure Databricks para todos os dados do Databricks SQL Warehouse, a menos que tenha sido instruído em contrário pelo seu representante Databricks.

    Captura de ecrã do diálogo Obter Dados para Databricks Cloud.

  2. Forneça o nome de host do Server e o caminho HTTP para o Databricks SQL Warehouse. Consulte Configurar os drivers ODBC e JDBC do Databricks para obter instruções sobre como consultar o seu "Nome de host do servidor" e "Caminho HTTP". Insira estas 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 ecrã dos campos de ligação do Databricks SQL Warehouse.

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

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

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

    • Azure Active Directory (utilizável apenas para Azure). Inicie sessão na sua conta organizacional utilizando o pop-up do navegador.

      Captura de ecrã do campo de entrada do token Databricks.

    Observação

    Depois de introduzir as suas credenciais para um determinado Databricks SQL Warehouse, o Power BI Desktop armazena e reutiliza essas mesmas credenciais em tentativas de ligação subsequentes. Você pode modificar essas credenciais acessando Ficheiro > Opções e definições > Configurações da fonte de dados. Para obter mais informações: Alterar o método de autenticação

  4. Depois de estabelecer a ligação com êxito, o Navigator mostra os dados disponíveis no cluster. Pode escolher Transform Data para transformar os dados usando Power Query ou Load para carregar os dados no Power Query Desktop.

    Imagem do navegador Power Query a carregar os dados Cloud do Databricks para a aplicação desktop.

Ligue-se a partir do Power Query Online

Para se ligar aos Databricks do Power Query Online, siga os seguintes passos:

  1. Selecione a opção Azure Databricks na experiência de obtenção de dados. Diferentes aplicações têm formas diferentes de aceder à experiência de dados do Power Query Online. Para mais informações sobre como aceder ao Power Query Online obter experiência de dados através da sua aplicação, consulte Onde obter dados.

    Selecione os conectores Databricks disponíveis através da caixa de pesquisa. Utilize o conector Azure Databricks para todos os dados do Databricks SQL Warehouse, a menos que tenha sido instruído em contrário pelo seu representante Databricks.

    Captura de ecrã das opções do conector Databricks em Power Query.

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

    Captura de ecrã das definições de ligação e credenciais para Azure Databricks.

  3. Forneça suas credenciais para autenticar com seu Databricks SQL Warehouse. Existem quatro opções de credenciais:

    • Credenciais do Cliente Databricks. Para instruções sobre como gerar credenciais de cliente Databricks OAuth M2M, consulte Databricks OAuth M2M.
    • Personal Access Token (utilizável para AWS, Azure ou GCP). Consulte a seção "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). Inicie sessão na sua conta organizacional utilizando o pop-up do navegador.
    • Service principal (utilizável apenas para Azure). Autentique-se com um principal de serviço do Microsoft Entra ID. Esta opção está disponível ao configurar uma ligação à cloud ou gateway.
  4. Depois de se conectar com êxito, o Navigator aparece e exibe os dados disponíveis no servidor. Selecione os seus dados no navegador. Depois seleciona Next para transformar os dados em Power Query.

    Captura de ecrã do navegador do Power Query para carregar os dados da Databricks Cloud para a aplicação online.

Informações adicionais

Implementação do conector do controlador Arrow Database Connectivity

Pode usar o driver Arrow Database Connectivity (ADBC) para o conector Azure Databricks em 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 ligações criadas no Power BI Desktop ou Power BI Service usarão automaticamente o driver Arrow Database Connectivity (ADBC) por defeito. As ligações existentes continuarão a usar ODBC, a menos que as atualize manualmente para ADBC.

Para alternar para o driver ADBC:

  1. Abra o painel desejado no Power BI.
  2. Selecione Transformar dados.
  3. Selecione Editor Avançado na secção de opções Query.
  4. Especifique Implementation="2.0" para 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 suporta proxy da web. No entanto, as configurações automáticas de proxy definidas em arquivos .pac não são suportadas.
  • 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.