Ligar o Power BI ao Azure Databricks

O Microsoft Power BI é um serviço de análise de negócios que fornece visualizações interativas com recursos de business intelligence de autoatendimento, permitindo que os usuários finais criem relatórios e painéis sozinhos, sem precisar depender da equipe de tecnologia da informação ou dos administradores de banco de dados.

Ao usar o Azure Databricks como uma fonte de dados com o Power BI, você pode trazer as vantagens do desempenho e da tecnologia do Azure Databricks além dos cientistas de dados e engenheiros de dados para todos os usuários corporativos.

Publicar no Power BI Online a partir do Azure Databricks

Ao usar o Azure Databricks como uma fonte de dados com o Power BI Online, você pode criar conjuntos de dados do Power BI a partir de tabelas ou esquemas diretamente da interface do usuário do Databricks.

Requisitos

• Seus dados devem estar no Catálogo Unity e sua computação (cluster) deve estar habilitada para o Catálogo Unity. O metastore do Hive não é suportado no momento.

• Você deve ter uma licença premium (capacidade premium ou licença premium por usuário) do Power BI.

• Você deve conceder as seguintes permissões ao aplicativo Entra ID registrado, Databricks Dataset Publishing Integration, que você está usando para publicar do Databricks no Power BI:

  • Conteúdo.Criar

  • Dataset.ReadWrite.All

  • Espaço de trabalho.Read.All

    

  Para obter mais informações, consulte Permissões do Microsoft Entra.

  Nota

  O consentimento do Entra Admin normalmente é necessário para essas permissões, especialmente para acesso no nível do espaço de trabalho e do conjunto de dados no Power BI. Consulte Rever pedidos de consentimento de administrador para obter instruções.

• Nas configurações do espaço de trabalho do Power BI, você deve habilitar Usuários podem editar modelos de dados no serviço do Power BI (visualização) para editar o Modelo Semântico depois que ele for publicado. Você também pode editar o Modelo Semântico usando o Editor de Tabela fazendo uma conexão usando o ponto de extremidade XMLA.

• Se você precisar habilitar a gravação XML em seu espaço de trabalho do Power BI, siga este link para obter instruções.

• Se o seu espaço de trabalho do Power BI usar um link privado, você deverá atualizar as credenciais da fonte de dados do conjunto de dados manualmente no Power BI.

Publicar tabelas do Azure Databricks em um conjunto de dados do Power BI

1. Entre no espaço de trabalho do Databricks e clique em Catálogo na barra lateral para abrir o Gerenciador de Catálogos.

2. Selecione um recurso de computação na lista suspensa no canto superior direito.

3. Abra um catálogo e selecione o esquema ou tabelas a serem publicados. Não selecione a partir de um metastore hive ou do catálogo de amostras.

4. No canto superior direito, clique em Usar com ferramentas de BI para um esquema ou em Abrir em um painel para uma tabela.

5. Selecione Publicar no espaço de trabalho do Power BI.

6. Na caixa de diálogo Conectar ao parceiro, clique em Conectar à ID do Microsoft Entra para autenticar.

7. Nos espaços de trabalho do Power BI, selecione o espaço de trabalho do Power BI.

8. Em Modo de Conjunto de Dados, selecione DirectQuery ou Importar.

9. Em Método de Autenticação no Power BI, selecione OAuth ou PAT (Personal Access Token).

   O Databricks recomenda o uso do OAuth, pois ele permite um controle de acesso refinado e auditoria no nível do usuário. As credenciais OAuth podem precisar ser configuradas na página de configurações do conjunto de dados do Power BI em Credenciais da fonte de dados. Se selecionar Token de Acesso Pessoal (PAT), é criada uma PAT em seu nome para permitir que o Power BI aceda ao modelo semântico.

10. Em Nome do Conjunto de Dados, selecione Publicar como um novo conjunto de dados ou Usar um conjunto de dados existente.

    Quando você escolhe Usar um conjunto de dados existente, o seguinte é verdadeiro:

    • Se o conjunto de dados existir, ele não será substituído. As atualizações apenas acrescentam novos registros em um determinado esquema.
      • Se a tabela selecionada não fizer parte do conjunto de dados existente, ela será adicionada.
      • Se a tabela já estava no seu conjunto de dados e novas colunas foram adicionadas após a última atualização, essas colunas são adicionadas automaticamente.
      • Você pode escolher um modelo de armazenamento diferente para a nova tabela para criar um modelo semântico composto.

    Se você tiver um modelo semântico existente que deseja atualizar enquanto mantém as conexões de dados existentes no lugar, escolha Usar um conjunto de dados existente. Se quiser criar um novo conjunto de dados com um novo modelo semântico, escolha Publicar como novo conjunto de dados.

11. Clique em Publicar no Power BI.

12. Em 10 a 20 segundos quando o conjunto de dados for publicado, clique em Abrir o Power BI para abrir o conjunto de dados do Power BI em uma nova guia.

Características e notas

• Ao publicar um esquema contendo várias tabelas, todas as tabelas com colunas são publicadas. As tabelas sem colunas não são publicadas.
• Os comentários nas colunas de uma tabela no Azure Databricks são copiados para as descrições das colunas correspondentes no Power BI.
• As relações de chave estrangeira são preservadas no conjunto de dados publicado. No entanto, o Power BI dá suporte apenas a um caminho de relacionamento ativo entre duas tabelas. Quando vários caminhos estão presentes no esquema no Azure Databricks, algumas das relações correspondentes no Power BI são definidas como inativas. Mais tarde, você pode alterar quais relações estão ativas ou inativas no modo de exibição do modelo de dados no Power BI.
• Ao usar o OAuth ou um gateway de dados local, as credenciais talvez precisem ser configuradas em "Credenciais da fonte de dados" na página de configurações do conjunto de dados do Power BI.

Resolução de Problemas

Conectar o Power BI Desktop ao Azure Databricks

Você pode conectar o Power BI Desktop aos clusters do Azure Databricks e aos armazéns SQL do Databricks. Você também pode publicar relatórios do Power BI no serviço do Power BI e permitir que os usuários acessem os dados subjacentes do Azure Databricks usando logon único (SSO), passando as mesmas credenciais de ID do Microsoft Entra que eles usam para acessar o relatório.

Requisitos

• Power BI Desktop 2.85.681.0 ou superior. Para usar dados gerenciados pelo Catálogo Unity com o Power BI, você deve usar o Power BI Desktop 2.98.683.0 ou superior (versão de outubro de 2021).

  Nota

  O Power BI Desktop requer o Windows. Uma alternativa para outros sistemas operacionais é executar o Power BI Desktop em um host físico ou em uma máquina virtual baseada no Windows e, em seguida, conectar-se a ele a partir do seu sistema operacional.

  Se você usar uma versão do Power BI Desktop abaixo de 2.85.681.0, também precisará instalar o driver ODBC Databricks no mesmo ambiente do Power BI Desktop.

• Um token de acesso pessoal do Azure Databricks ou suas credenciais de conta do Microsoft Entra ID.

  Nota

  Como prática recomendada de segurança quando você se autentica com tokens de acesso pessoal, o Databricks recomenda que você use tokens de acesso pessoal pertencentes a entidades de serviço em vez de usuários do espaço de trabalho. Para criar tokens para entidades de serviço, consulte Gerenciar tokens para uma entidade de serviço.

• Um cluster do Azure Databricks ou um armazém SQL do Databricks.

Conectar o Power BI Desktop ao Azure Databricks usando o Partner Connect

Você pode usar o Partner Connect para se conectar a um cluster ou SQL warehouse do Power BI Desktop em apenas alguns cliques.

1. Verifique se sua conta do Azure Databricks, espaço de trabalho e o usuário conectado atendem aos requisitos do Partner Connect.

2. Na barra lateral, clique em Partner Connect.

3. Clique no bloco Power BI .

4. Na caixa de diálogo Conectar ao parceiro, para Computação, escolha o nome do recurso de computação do Azure Databricks que você deseja conectar.

5. Escolha Baixar arquivo de conexão.

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

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

   • Token de Acesso Pessoal: insira seu token de acesso pessoal do Azure Databricks.
   • Microsoft Entra ID: Clique em Entrar e siga as instruções na tela.
   • Nome de utilizador / Palavra-passe: Não aplicável.

8. Clique em Ligar.

9. Selecione os dados do Azure Databricks para consultar a partir do Navegador do Power BI.

   

Conectar o Power BI Desktop ao Azure 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. Os armazéns SQL Databricks são recomendados ao usar o Power BI no modo DirectQuery .

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 Databricks e, em seguida, clique no conector:

   • Azure Databricks

6. Clique em Ligar.

7. Insira o nome do host do servidor e o caminho HTTP.

8. Selecione o modo de conectividade de dados. Para obter informações sobre a diferença entre Import 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 do Azure Databricks.
    • Microsoft Entra ID: Clique em Entrar e siga as instruções na tela.
    • Nome de utilizador / Palavra-passe: Não aplicável.

11. Clique em Ligar.

12. Selecione os dados do Azure Databricks para consultar a partir do Navegador do Power BI. Se o Unity Catalog estiver habilitado para seu espaço de trabalho, selecione um catálogo antes de selecionar um esquema e uma tabela.

    

Usando uma consulta SQL personalizada

O conector Databricks fornece a Databricks.Query fonte de dados que permite que um usuário forneça uma consulta SQL personalizada.

1. Siga as etapas descritas em Conectar com o Power BI Desktop para criar uma conexão, usando Importar como o modo de conectividade de dados.

2. No Navegador, clique com o botão direito do rato no item mais superior que contém o nome de anfitrião selecionado e o caminho HTTP e clique em Transformar Dados para abrir o Editor do Power Query.

   

3. Na barra de funções, substitua o nome Databricks.Catalogs da função por Databricks.Query e aplique a alteração. Isso cria uma função do Power Query que usa uma consulta SQL como parâmetro.

4. Insira a consulta SQL no campo de parâmetro e clique em Invocar. Isso executa a consulta e uma nova tabela é criada com os resultados da consulta como conteúdo.

Acessar a fonte de dados do Azure Databricks usando o serviço do Power BI

Ao publicar um relatório no serviço do Power BI, você se conecta ao Azure Databricks usando um token de acesso pessoal. No serviço Power BI, você também pode habilitar o logon único (SSO) para que os usuários possam acessar relatórios criados usando o modo de armazenamento DirectQuery passando suas credenciais de ID do Microsoft Entra para o Azure Databricks.

1. Publique seu relatório do Power BI do Power BI Desktop no serviço do Power BI.

2. Habilite o acesso de logon único (SSO) ao relatório e à fonte de dados subjacente.

   1. Vá para o conjunto de dados subjacente do Azure Databricks para o relatório no serviço do Power BI, expanda Credenciais da fonte de dados e clique em Editar credenciais.
   2. Na caixa de diálogo de configuração, selecione Os visualizadores de relatório só podem acessar essa fonte de dados com suas próprias identidades do Power BI usando o Direct Query e clique em Entrar.

   

   Com essa opção selecionada, o acesso à fonte de dados é tratado usando o DirectQuery e gerenciado usando a identidade ID do Microsoft Entra do usuário que está acessando o relatório. Se você não selecionar essa opção, somente você, como o usuário que publicou o relatório, terá acesso à fonte de dados do Azure Databricks.

Deteção automatizada de proxy HTTP

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

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

Se o servidor proxy não fornecer um ponto de distribuição de 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, conclua as seguintes etapas:

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 microsoft.sparkodbc.ini arquivo:

   [Driver]
   CheckCertRevocation=0
   

Conector de Partilha Delta do Power BI

O conector de Compartilhamento Delta do Power BI permite que os usuários descubram, analisem e visualizem conjuntos de dados compartilhados com eles por meio do protocolo aberto de Compartilhamento Delta . O protocolo permite a troca segura de conjuntos de dados entre produtos e plataformas, aproveitando o REST e o armazenamento em nuvem.

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

Limitações

• O conector do Azure Databricks dá suporte ao proxy da Web. No entanto, as definições automáticas do proxy definidas nos ficheiros .pac não são suportadas.
• No conector do Azure Databricks, a fonte de dados não é suportada em combinação com o Databricks.Query modo DirectQuery.
• Os dados que o conector Delta Sharing carrega devem caber na memória da sua máquina. Para garantir isso, o conector limita o número de linhas importadas ao Limite de Linha definido anteriormente.

Recursos adicionais

Suporte