Databricks

Observação

Este conector pertence e é fornecido pela Databricks.

Resumo

Property Valor
Connector ícone do Databricks Databricks
Produtos Power BI (modelos semânticos)
Power Query Online
Estado de liberação Disponibilidade geral
Categoria Database
Tipos de autenticação Credenciais do cliente Databricks
OAuth (OIDC)
Token de acesso pessoal
Tipo de fonte de dados DatabricksMultiCloud
Documentação de referência da função DatabricksMultiCloud.Catalogs
DatabricksMultiCloud.Query

Observação

Alguns recursos podem estar presentes em um produto, mas não em outros devido a agendamentos de implantação e recursos específicos do host.

Importante

O conector Databricks para Power BI agora suporta o driver Arrow Database Connectivity (ADBC). Este conector está em transição do controlador Simba Spark ODBC incorporado para o controlador Databricks ADBC. 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

Esse conector é apenas para uso com um Databricks SQL Warehouse em execução na AWS e usando OAuth. Se estiveres a usar Azure Databricks, usa o conector Azure Databricks. Se não estiveres a usar o OAuth com o teu Databricks SQL Warehouse (na AWS ou GCP), usa também o conector Azure Databricks. O Databricks Community Edition não é suportado.

Capacidades suportadas

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

Parameters

Ponto de entrada:DatabricksMultiCloud.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 de valor permitido Valores permitidos definidos
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 a listagem de tabelas mais rápida, no entanto impede o query folding para consultas que acedem a múltiplas bases de dados diferentes. false true
options.QueryTags Tags de consulta No enviar SMS Opções Avançadas Etiquetas-chave-valor para acompanhar consultas na tabela system.query.history. "tag1:value1,tag2:value2" false true
options.EnableAutomaticProxyDiscovery Deteção automática de proxy No enviar SMS Opções Avançadas Isto permite a deteção automática de proxy em todo o sistema no 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"]
opções.Implementação 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]
opções.Protocol Protocolo No enviar SMS Opções Avançadas Especifica o protocolo utilizado pelo driver ADBC. Selecione 'REST (SEA)' para usar a Statement Execution API. Quando não está definido, o driver default (Thrift) é usado. null null (Padrão); "rest" (REST (SEA)) false true [null, "descansar"]

Conectar-se a partir do Power Query Desktop

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

  1. Na experiência Obter Dados, pesquise por Databricks para encurtar a lista do conector Databricks. Você só deve usar o conector Databricks aqui para os seus dados do Databricks SQL Warehouse (em execução na AWS) se estiver a utilizar OAuth para autenticação.

    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. Você tem três opções para credenciais:

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

    • Token de acesso pessoal. Consulte a seção "Tokens de acesso pessoal" para obter instruções sobre como gerar um token de acesso pessoal (PAT).

    • OAuth (OIDC). 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 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.

    Reduza a lista dos conectores Databricks disponíveis usando a caixa de pesquisa. Selecione o conector Databricks para o seu Databricks SQL Warehouse.

    Captura de ecrã das opções de conectores 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 do Databricks serviços online.

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

    • Básico. Use esta opção ao autenticar com um nome de usuário e senha. Esta opção não estará disponível se a sua organização/conta utilizar 2FA/MFA.
    • Chave da conta. Use esta opção ao autenticar usando um Token de Acesso Pessoal. Consulte a seção "Tokens de acesso pessoal" para obter instruções sobre como gerar um token de acesso pessoal (PAT).
    • Conta organizacional. Use esta opção ao autenticar com OAuth. Inicie sessão na sua conta organizacional utilizando o pop-up do navegador.
  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 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.

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 = 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