Pular para o conteúdo principal

Conecte o Power BI como uma fonte externa de conhecimento

info

Beta

Este recurso está em Beta. Para usá-lo, um administrador account deve ativar Conhecimento externo na página Prévias do console da account. Consulte Gerenciar prévias ao nível da account.

O Databricks pode extrair metadados de modelos semânticos do Power BI para que o Genie possa usar as definições de suas medidas do Power BI ao responder perguntas. O Power BI é uma fonte de conhecimento externa.

Antes de começar​

Configurar o Power BI como uma fonte de conhecimento externa envolve o Power BI e o Databricks. Cada parte da configuração precisa de permissões diferentes.

importante

Enquanto a prévia Conhecimento externo estiver ativada, o Databricks extrai metadados através de cada conexão do Power BI no Unity Catalog que usa OAuth Machine to Machine e é usada por uma tarefa do Power BI, incluindo conexões e tarefas existentes. Os snippets de ontologia criados a partir desses metadados estão disponíveis para todos os usuários em sua account do Databricks, independentemente do acesso deles no Power BI. Para limitar o que o Databricks extrai, adicione o Service Principal de cada conexão apenas aos Workspace do Power BI que você deseja incluir.

Requisitos do Power BI​

O service principal da conexão Power BI deve ser adicionado diretamente a cada workspace do Power BI do qual você deseja extrair metadados, com pelo menos a função Colaborador . Você não precisa adicioná-lo a outros Workspace. Consulte Dar aos usuários acesso a Workspace.

Requisitos do Databricks​

Para criar a conexão do Power BI e extrair metadados, você precisa do seguinte:

Criar a conexão e a execução da tarefa do Power BI​

Se você já tiver uma tarefa do Power BI que usa uma conexão do Power BI com OAuth Machine to Machine, não precisará criar uma nova conexão ou tarefa. O Databricks começa a receber metadados na próxima vez que a tarefa for execução após a visualização do Conhecimento externo ser ativada. Verifique se o service principal da conexão atende aos requisitos do Power BI.

Caso contrário, crie uma conexão do Power BI no Unity Catalog que use OAuth Machine to Machine e, em seguida, execute uma tarefa do Power BI que use a conexão:

  1. Crie uma conexão do Power BI no Unity Catalog que armazena as credenciais do service principal do Microsoft Entra. Siga os passos em Criar uma conexão do Power BI no Unity Catalog para orquestração, e faça o seguinte:

    • Para Tipo de autenticação , selecione OAuth máquina para máquina .
    • Para credenciais, insira o ID do cliente, o segredo do cliente e o ID do tenant do Microsoft Entra.
  2. Adicione uma tarefa do Power BI a um Job, selecione a conexão da tarefa e execução o Job. Veja Configurar uma tarefa do Power BI.

Na primeira execução da tarefa, o Databricks começa a extrair metadados por meio da conexão. Quando o Genie usa um snippet criado a partir de metadados do Power BI para responder a uma pergunta, o snippet aparece nas citações da resposta.

Como o Databricks obtém metadados do Power BI​

O Databricks lê metadados do Power BI através das conexões do Power BI no Unity Catalog. As seções a seguir descrevem quais metadados o Databricks extrai, qual API e conexões ele usa e como o acesso aos dados funciona para os snippets de ontologia criados a partir deles.

Quais metadados o Databricks busca​

O Databricks extrai os seguintes metadados dos seus Workspace do Power BI:

  • Modelos semânticos : Tabelas, colunas, tipos de dados e modo de armazenamento.
  • Lógica de medida e query : fórmulas de medida DAX, colunas calculadas e expressões de Power Query (M).
  • Configuração de modelo : a disposição do diagrama do modelo semântico.

Os snippets de ontologia não incluem o seguinte:

  • Definições de função e membros da segurança em nível de linha (RLS).
  • Endereços de email do proprietário do ativo do Power BI.

API, escopo e refresh​

O Databricks usa a conexão do Power BI no Unity Catalog para ler a definição de cada modelo semântico com a API REST Obter Definição de Modelo Semântico do Fabric.

Para cada conexão, o Databricks recupera metadados dos Workspace do Power BI que o Service Principal da conexão pode acessar.

O Databricks refresh esses metadados a cada 7 dias. Os metadados permanecem na região do seu workspace e não ficam visíveis como uma tabela do Unity Catalog.

Trechos de ontologia e acesso a dados​

Os trechos de ontologia contêm metadados, como definições de medidas e relacionamentos, não os dados das suas tabelas. As permissões do Unity Catalog ainda controlam o acesso a esses dados. Os usuários que não têm acesso às tabelas do Unity Catalog referenciadas por um trecho não podem query essas tabelas pelo Genie.

Se um ativo do Power BI for removido ou se o Service Principal da conexão não puder mais acessá-lo, o Genie parará de usar os snippets criados a partir desse ativo.

Limitações​

  • O Databricks cria snippets de ontologia apenas para modelos semânticos do Power BI que leem dados de objetos do Unity Catalog.
  • A Databricks não captura a atividade de uso, como exibições de relatórios.
  • Não é possível limitar os snippets de ontologia a usuários ou grupos específicos. Para parar de servi-los, um administrador account pode desabilitar a prévia de Conhecimento externo .

Mais recursos​