Pular para o conteúdo principal
Última atualização em

Publicar no serviço do Power BI do Databricks

Publicar dados do Databricks para o serviço Microsoft Power BI, uma plataforma de analítica de negócios baseada em cloud que permite aos usuários conectar-se, visualizar e analisar dados. É possível publicar tabelas e esquemas do Databricks em modelos semânticos do Power BI diretamente da interface do usuário do Databricks, ou conectar-se manualmente ao Databricks como uma fonte de dados a partir do serviço Power BI.

Quando você integra o Databricks como uma fonte de dados com o serviço do Power BI, você leva o processamento de dados escalável e o desempenho do Databricks a todos os usuários.

Se você quiser conectar o Power BI Desktop ao Databricks, consulte Conectar o Power BI Desktop ao Databricks.

nota

O conector Databricks para Power BI suporta o driver Arrow Database Connectivity (ADBC). Saiba mais aqui.

Requisitos​

  • Seus dados devem estar no Unity Catalog, e seu compute deve estar habilitado para o Unity Catalog. O Hive metastore não é compatível no momento.

  • Você deve ter uma licença Power BI Premium (capacidade Premium, Premium por Usuário (PPU) ou capacidade Microsoft Fabric).

  • Você deve habilitar Read Write para o XMLA Endpoint na sua capacidade do Power BI. Siga este link para obter instruções.

  • Se você está autenticando usando OAuth máquina a máquina (M2M), certifique-se de ter configurado um Service Principal do Databricks. Consulte Configurar Service Principal no Databricks para Power BI.

  • Se os usuários desejam editar modelos semânticos no Power BI Service após a publicação, você deve habilitar Usuários podem editar modelos de dados no serviço do Power BI (versão preliminar) nas configurações do workspace. Você também pode editar o modelo semântico usando o Tabular Editor fazendo uma conexão usando o endpoint XMLA.

  • Se o seu workspace Power BI usa um private Link, você deve atualizar as credenciais da fonte de dados do dataset manualmente no Power BI.

  • Um warehouse do Databricks SQL.

Publicar tabelas do Databricks em um modelo semântico do Power BI​

Ao usar o Databricks como uma fonte de dados com o serviço Power BI, é possível criar modelos semânticos do Power BI a partir de tabelas ou esquemas diretamente da interface do usuário do Databricks.

  1. Faça login no seu workspace do Databricks e clique Ícone de dados. em **Catálogo** na barra lateral para abrir o Catalog Explorer.

  2. Selecione um recurso de compute de SQL warehouse na lista suspensa no canto superior esquerdo, sob o rótulo Catalog .

  3. Abra um catálogo e selecione o esquema ou as tabelas a serem publicadas. Não selecione de um Hive metastore ou do catálogo de amostras.

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

  5. Selecione Publicar no Workspace do Power BI .

  6. Na caixa de diálogo **Conectar-se ao parceiro**, clique em **Conectar-se ao Microsoft Entra ID** para autenticar.

  7. No campo Workspaces do Power BI , selecione o workspace do Power BI.

  8. No Dataset Mode , selecione DirectQuery ou Importar.

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

    A Databricks recomenda usar o OAuth, pois ele permite controle de acesso granular e auditoria no nível do usuário. As credenciais OAuth podem precisar ser configuradas na página de configurações do modelo semântico do Power BI em Credenciais da fonte de dados . Se você selecionar Personal Access Token (PAT), um PAT será criado em seu nome para permitir que o Power BI acesse o modelo semântico.

    Tokens refresh de uso único estão ativados por default para OAuth user-to-machine (U2M). Para configurar essas definições, consulte Tokens Refresh de Uso Único.

    Se o senhor desejar autenticar-se usando OAuth M2M, poderá configurar isso no serviço do Power BI após a publicação. Consulte Configurar OAuth M2M.

  10. Em Nome do dataset , selecione Publicar como um novo dataset ou Usar um dataset existente .

    Quando você escolhe **Usar um dataset existente**, o seguinte é verdadeiro:

    • Se o modelo semântico existir, ele não será substituído. As atualizações apenas anexam novos registros em um determinado esquema.
      • Se a tabela selecionada não fizer parte do modelo semântico existente, ela é adicionada.
      • Se a tabela já estava em seu modelo semântico 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ê tem um modelo semântico existente que deseja atualizar, mantendo as conexões de dados existentes, escolha **Usar um dataset existente**. Se você deseja criar um novo com um novo modelo semântico, escolha **Publicar como um novo conjunto de dados**.

  11. Clique em Publicar no Power BI .

  12. A publicação do modelo semântico pode levar de 10 a 20 segundos. Quando a publicação estiver concluída, clique em Abrir Power BI para abrir seu modelo semântico do Power BI em uma nova tab.

Conectar manualmente o Databricks como uma fonte de dados​

Em vez de usar a interface do usuário do Databricks para publicar em um modelo semântico do Power BI, você pode se conectar manualmente ao Databricks como uma fonte de dados do serviço do Power BI.

  1. Na barra lateral do serviço Power BI, clique em Criar .

  2. Clique em Obter dados .

  3. Pesquise e selecione o bloco "Databricks".

  4. Insira seu warehouse do Databricks SQL hostname e Caminho HTTP .

  5. Opcionalmente, especifique as configurações de Opções avançadas .

  6. Certifique-se de definir um Nome da Conexão exclusivo.

  7. Escolha seu tipo de autenticação:

    • Databricks Client Credentials : Autentique com um Databricks Service Principal (OAuth máquina a máquina). Insira o ID do cliente do service principal e o segredo do cliente. Consulte Configurar service principals no Databricks para Power BI.
    • Token de acesso pessoal : insira seu token de acesso pessoal do Databricks.
    • OAuth (OIDC) : Clique em Entrar e conclua o processo de autenticação.
    • Service Principal : Autentique-se com um service principal do Microsoft Entra ID. Insira as credenciais do Service Principal.

  8. Selecione um Nível de Privacidade .

  9. Escolha se esta conexão pode ser usada com gateways de dados on-premises e gateways de dados VNet.

  10. Clique em Próximo para criar sua conexão.

  11. Selecione quais tabelas importar para seus relatórios do Power BI.

Recursos e observações​

  • Ao publicar um esquema contendo várias tabelas, todas as tabelas com colunas são publicadas. Tabelas sem colunas não são publicadas.

  • Comentários sobre as colunas de uma tabela no Databricks são copiados para as descrições das colunas correspondentes no Power BI.

  • Relacionamentos de chave estrangeira são preservados no dataset publicado. No entanto, o Power BI suporta apenas um caminho de relacionamento ativo entre quaisquer duas tabelas. Quando vários caminhos estão presentes no esquema no Databricks, algumas das relações correspondentes no Power BI são definidas como inativas. Você pode posteriormente alterar quais relacionamentos estão ativos ou inativos na view do modelo de dados no Power BI.

  • Ao usar OAuth ou um gateway de dados on-premises, as credenciais podem precisar ser configuradas em “Credenciais da fonte de dados” na página de configurações do dataset do Power BI.

  • Atualmente, os usuários só podem publicar diretamente em Workspace do Power BI em seu tenant de origem. Não há suporte para publicação em tenants onde eles são usuários convidados.

Conceder permissões quando o consentimento do administrador estiver desativado​

Quando o consentimento do administrador está desabilitado, os usuários não conseguem solicitar aprovação para aplicativos que exigem permissões. Isso pode ocorrer se o consentimento do usuário estiver bloqueado ou limitado a editores verificados no centro de administração do Microsoft Entra, e as solicitações de consentimento do administrador não forem permitidas.

Para permitir que os usuários solicitem permissão para publicar no serviço Power BI, é necessário ser um Admin Global ou um Admin de Aplicativos Cloud para habilitar e aprovar solicitações de consentimento.

O passo 1: Habilitar solicitações de consentimento de administrador​

Um Administrador Global ou Administrador de Aplicativos na Cloud deve primeiro habilitar as solicitações de consentimento do administrador:

  1. No centro de administração do Microsoft Entra, navegue até Consentimento e permissões .
  2. Clique em Configurações de consentimento do administrador na barra lateral.
  3. Alterne Solicitações de consentimento do administrador para Sim .
  4. (Opcional) Para designar revisores que possam ajudar a avaliar solicitações de consentimento, selecione **Adicionar usuários** em **Revisores**. Observe que, embora os revisores possam avaliar solicitações, apenas um Administrador Global pode conceder o consentimento administrativo final.
  5. Configure **Solicitações de consentimento expiram após (dias)** para definir por quanto tempo as solicitações de consentimento permanecem válidas antes de expirar.
  6. Os usuários agora podem enviar solicitações de consentimento para o serviço Power BI.

Passo 2: Aprovar solicitação de consentimento do usuário​

Após um usuário enviar uma solicitação de consentimento, um Administrador Global ou um Administrador de Aplicativos na Nuvem deve aprovar a solicitação:

  1. No centro de administração do Microsoft Entra, clique em Solicitações de consentimento do administrador na barra lateral.
  2. Selecione a solicitação **Integração de Publicação de Dataset do Databricks**.
  3. Clique em Analisar permissões e consentimento .
  4. Entre com seu Microsoft Entra ID e clique em Aceitar .

O usuário que solicita acesso ao Power BI agora pode publicar no serviço do Power BI.

Configurar OAuth M2M​

Após a publicação no serviço Power BI a partir do Databricks, é possível configurar o OAuth M2M no serviço Power BI. Certifique-se de que um Service Principal esteja configurado no Databricks. Consulte Configurar Service Principal no Databricks para Power BI.

É possível configurar o M2M OAuth a partir de um modelo semântico ou de um gateway de serviço.

Use um modelo semântico para OAuth M2M​

Configure a conexão Databricks para OAuth M2M no serviço Power BI usando um modelo semântico. Para saber mais sobre modelos semânticos, consulte Modelos Semânticos no Serviço Power BI.

Para configurar credenciais:

  1. No Power BI, navegue até o workspace que contém o modelo semântico.
  2. Clique em Mais opções (menu kebab horizontal) > Configurações .
  3. Navegue até Credenciais da fonte de dados e clique em Editar Credenciais .
  4. Em **Método de autenticação**, escolha **Básico**.
  5. Em Nome de usuário , insira sua ID de aplicativo do service principal.
  6. Em Senha , insira seu segredo de Service Principal.
  7. Selecione a configuração de nível de privacidade apropriada para sua fonte de dados.
  8. Se você quiser habilitar o SSO, habilite a última opção.
  9. Clique em Entrar .

Use um gateway de serviço para OAuth M2M​

É possível configurar a conexão do Databricks para OAuth M2M no serviço do Power BI a partir de uma VNet do Power BI ou de um gateway de dados on-premises. Credenciais de cliente Databricks para um gateway on-premises requerem o gateway Power BI v3.000.270,10 ou acima. Para saber mais sobre gateways Power BI, consulte o site oficial da Microsoft.

O Power BI não oferece suporte total a gateways de dados de VNet em suas APIs REST. Portanto, você deve atualizar manualmente as conexões da fonte de dados para usar Databricks Client Credentials na UI.

Para configurar credenciais:

  1. No Power BI, clique no ícone de engrenagem no canto superior direito para acessar as configurações.

  2. Clique em **Gerenciar conexões e gateways**.

  3. Clique em + Novo para criar uma nova conexão.

  4. Selecione **On-premises** ou **Rede virtual**. As credenciais necessárias são as mesmas para ambos os gateways.

  5. Em Nome do Cluster do Gateway , selecione o gateway apropriado.

  6. Em Nome da Conexão , insira o nome da sua conexão.

  7. Em **Tipo de conexão**, selecione **Azure Databricks**.

  8. Em Server Hostname , insira o hostname do warehouse do Databricks SQL.

  9. Em Caminho HTTP , insira o caminho HTTP do SQL warehouse.

  10. Em Autenticação , especifique suas credenciais de autenticação.

    1. Em Método de autenticação , selecione Databricks Client Credentials .
    2. Em **ID do cliente Databricks**, insira o ID do cliente de seu service principal.
    3. Em Databricks Client Secret , insira o segredo do cliente da Service Principal.

  11. Em **Nível de privacidade**, selecione **Organizacional**.

  12. Clique em Criar .

Recursos adicionais​

Nesta página