Pular para o conteúdo principal

Conectar o Power BI Desktop ao Databricks

Esta página descreve as diferentes maneiras de se conectar ao Databricks a partir do Microsoft Power BI Desktop. O Power BI Desktop é um aplicativo baseado no Windows que permite que o usuário se conecte, modele e visualize dados de uma ampla variedade de fontes. Com o Power BI Desktop, o senhor pode criar relatórios e dashboards interativos usando ferramentas de Business Intelligence de autosserviço.

Ao usar o Databricks como fonte de dados com o Power BI, o senhor amplia o desempenho e os recursos do Databricks para além do data scientists e do engenheiro de dados para todos os usuários corporativos.

Você pode conectar o Power BI Desktop aos clusters do Databricks SQL warehouses.

Escolha um dos seguintes métodos para se conectar ao Databricks a partir do Power BI Desktop:

Se o senhor quiser publicar dados do Databricks no serviço do Power BI, consulte Publicar no serviço do Power BI a partir do Databricks.

nota

O conector Databricks para o Power BI é compatível com o driver Arrow Database Connectivity (ADBC). Saiba mais aqui.

Requisitos

  • Para usar os dados gerenciados por Unity Catalog com Power BI, Databricks recomenda usar a versão mais recente do Power BI Desktop.
nota

Se o seu sistema operacional não for Windows, execute o Power BI Desktop em um host físico ou em uma máquina virtual baseada no Windowse, em seguida, conecte-se a ele a partir do seu sistema operacional.

Se o senhor usa uma versão do Power BI Desktop abaixo de 2.85.681.0, Instale o driver ODBC da Databricks no mesmo ambiente do Power BI Desktop.

  • Use uma das seguintes opções para autenticar:

    • Power BI habilitado como um aplicativo OAuth em seu account. Isso é ativado por default.

    • Uma entidade de serviço da Databricks para OAuth máquina a máquina (M2M). Power BI O Desktop 2.143.878.0 (versão de maio de 2025) ou o acima é necessário para esse método de autenticação. Consulte Configure entidade de serviço em Databricks para Power BI.

    • Um Databricks pessoal access token.

nota

A autenticação básica usando um nome de usuário e senha da Databricks chegou ao fim da vida útil em 10 de julho de 2024. Consulte End of life para Databricks-gerenciar senhas.

Conecte-se ao Databricks usando o Partner Connect

O senhor pode usar Partner Connect para se conectar a um cluster ou SQL warehouse a partir do Power BI Desktop.

  1. Certifique-se de que os sites Databricks account, workspace e o usuário conectado atendam aos requisitos do site Partner Connect.

  2. Na barra lateral, clique em Ícone do Marketplace marketplace .

  3. Em Partner Connect integrations , clique em view all .

  4. Clique no bloco Power BI .

  5. Na caixa de diálogo Connect to parceiros , para computar , escolha o nome do recurso Databricks compute que o senhor deseja conectar.

  6. Escolha Fazer download do arquivo de conexão .

  7. Abra o arquivo de conexão baixado, que inicia o Power BI Desktop.

  8. No Power BI Desktop, insira suas credenciais de autenticação:

    • Token de acesso pessoal : insira seu token de acesso pessoal do Databricks.
    • Microsoft Entra ID : Não aplicável.
    • Credenciais do cliente : Usar para M2M OAuth. Insira o ID do cliente e o segredo do cliente de sua entidade de serviço.
  9. Clique em Conectar .

  10. Selecione os dados do Databricks a serem consultados no Power BI Navigator .

    Navegador do Power BI

Conectar-se ao Databricks manualmente

Siga estas instruções, dependendo do método de autenticação escolhido, para se conectar a um cluster ou SQL warehouse com o Power BI Desktop. Databricks SQL são recomendados ao usar o site Power BI no modo DirectQuery .

nota

Para se conectar mais rapidamente com o Power BI Desktop, use Partner Connect.

  1. Obtenha o nome do host do servidor e o caminho HTTP.

  2. Inicie o Power BI Desktop.

  3. Clique em Obter dados ou Arquivo > Obter dados .

  4. Clique em Obter dados para começar .

  5. Procure por Databricks e clique no conector Databricks .

  6. Clique em Conectar .

  7. Insira o Nome de host do servidor e o Caminho HTTP .

  8. Selecione seu modo de conectividade de dados . Para obter informações sobre a diferença entre Importar e DirectQuery , consulte Usar DirectQuery no Power BI Desktop.

  9. Clique em OK .

  10. Clique no seu método de autenticação:

    • Token de acesso pessoal : insira seu token de acesso pessoal.
    • OAuth : Clique em Sign in . Uma janela do navegador é aberta e solicita que você faça login com seu IdP. Depois que a mensagem de sucesso for exibida, saia do navegador e retorne ao Power BI Desktop.
    • Credenciais do cliente : Use se estiver autenticando com a entidade de serviço. Insira o ID do cliente e o segredo do cliente de sua entidade de serviço.
  11. Clique em Conectar .

  12. Selecione os dados do Databricks a serem consultados no Power BI Navigator .

    Navegador do Power BI

Power BI Delta Sharing conector

O conector Power BI Delta Sharing permite que os usuários descubram, analisem e visualizem conjuntos de dados compartilhados com eles por meio do Delta Sharing protocolo aberto. O protocolo permite a troca segura de conjuntos de dados entre produtos e plataformas, aproveitando o armazenamento em REST e cloud. Esse método é compatível apenas com o modo Import e permite que o senhor compartilhe dados com usuários que não estejam no Databricks.

Para obter instruções de conexão, consulte Power BI: Ler dados compartilhados.

Configurações de conexão

O conector do Databricks Power BI suporta as seguintes configurações de conexão adicionais.

Consultas SQL nativas

O conector Databricks permite que o senhor use consultas nativas SQL para operações maiores e consultas intensivas compute em um armazém Databricks SQL no Power BI Desktop. Isso requer o site Power BI v2.112.603.0 ou acima (versão de dezembro de 2022).

Faça o seguinte no Power BI Desktop para usar consultas SQL nativas:

  1. No menu Get Data (Obter dados ), localize a fonte de dados Databricks.
  2. Na caixa de diálogo de conexão, insira os detalhes do catálogo e do servidor de banco de dados. Esses campos são obrigatórios se você quiser usar consultas nativas.
  3. Em Native query (Consulta nativa ), digite a consulta SQL que o senhor deseja enviar.
  4. Depois de autenticar, você pode consultar.
  5. Para modificar a consulta, use o Editor de consultas avançadas do Power BI. Salve sua consulta se você fizer alguma alteração.

Detecção automatizada de proxy HTTP

O Power BI Desktop versão 2.104.941.0e acima (versão de maio de 2022) tem suporte integrado para detectar a configuração de proxy HTTP em todo o sistema Windows.

O Power BI Desktop pode detectar e usar automaticamente a configuração de proxy HTTP em todo o sistema Windows.

Se o servidor proxy não fornecer um ponto de distribuição CRL (CDP), o Power BI poderá mostrar a seguinte mensagem de erro:

Details: "ODBC: ERROR [HY000] [Microsoft][DriverSupport] (1200)
-The revocation status of the certificate or one of the certificates in the certificate chain is unknown."

Para corrigir esse erro, execute os passos a seguir:

  1. Crie o arquivo C:\Program Files\Microsoft Power BI Desktop\bin\ODBC Drivers\Simba Spark ODBC Driver\microsoft.sparkodbc.ini se ele não existir.

  2. Adicione a seguinte configuração ao seu arquivo microsoft.sparkodbc.ini:

    ini
    [Driver]
    CheckCertRevocation=0

Limitações

  • O conector Databricks é compatível com o proxy da Web. No entanto, as configurações automáticas de proxy definidas nos arquivos .pac não são suportadas.
  • No conector Databricks, a fonte de dados Databricks.Query não é suportada em combinação com o modo DirectQuery.
  • Os dados que são carregados usando o conector Delta Sharing devem caber na memória local da sua máquina. Para garantir isso, o conector limita o número de linhas importadas ao limite de linhas definido durante a configuração inicial da conexão. Consulte Power BI: ler dados compartilhados.

Recurso adicional

Apoiar

Documentação do Power Query