Conecte-se ao seu locatário do Microsoft Fabric no mesmo locatário que o Microsoft Purview

Este artigo descreve como registrar um locatário do Microsoft Fabric que está no mesmo locatário que seu recurso do Microsoft Purview e como autenticar e interagir com a origem do Fabric no Microsoft Purview. Para obter mais informações sobre o Microsoft Purview em geral, leia o artigo introdutório.

Recursos compatíveis

Recursos de digitalização

Outros recursos

Para classificações, rótulos de confidencialidade, políticas, linhagem de dados e exibição ao vivo, consulte a lista de recursos com suporte.

Cenários suportados para verificações de malha

Limitações conhecidas

• Atualmente, para todos os itens do Fabric além do Power BI, somente os metadados e a linhagem no nível do item podem ser verificados. Para tabelas e arquivos do Lakehouse, a verificação de metadados de nível de subitem está disponível, mas a linhagem de nível de subitem não é compatível.

• Para o runtime de integração auto-hospedada, há suporte para o runtime de integração auto-hospedada padrão com versão mínima 5.47.9073.1 ou o runtime de integração auto-hospedada com suporte do Kubernetes .

• Espaços de trabalho vazios são ignorados.

• O Microsoft Purview não dá suporte a expressões DAX do Fabric como parte da verificação de metadados.

• Você pode receber um erro Muitas solicitações ao executar várias verificações do Fabric ou do Power BI. Nesse caso, reduza as verificações simultâneas e espalhe as verificações em tempos diferentes para ajudar a resolver o erro.

• Na verificação incremental, você pode ver uma contagem diferente de zero de ativos ingeridos e ativos descobertos, mesmo que não haja nenhuma alteração na fonte de dados. Esse comportamento deve ser ignorado. Os ativos do catálogo de dados e do Mapa de Dados continuam a refletir o estado real da fonte de dados.

• Não há suporte para o Fabric com links privados no nível do locatário ou no nível do workspace.

• Codificações Parquet sem suporte: o Microsoft Purview não dá suporte à extração de esquema para arquivos Parquet que usam RLE (codificação de comprimento de execução) no Microsoft Fabric Lakehouse. Tabelas contendo colunas codificadas em RLE podem falhar ao extrair metadados de esquema, incluindo tabelas, colunas e tipos de dados. O processo ainda descobre metadados no nível do ativo (L1). Para habilitar a extração completa do esquema, recrie as tabelas afetadas usando um formato de codificação compatível, como dicionário ou codificação simples.

Pré-requisitos

Antes de começar, verifique se você tem os seguintes pré-requisitos:

• Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.

• Uma conta ativa do Microsoft Purview.

Opções de autenticação

• Identidade Gerenciada
• *Entidade de serviço
• Autenticação delegada

Lista de verificação de implantação

Use qualquer uma das seguintes listas de verificação de implantação durante a configuração ou para fins de solução de problemas, com base no cenário:

Registrar locatário do Fabric

Esta seção descreve como registrar um locatário do Fabric no Microsoft Purview para o cenário de mesmo locatário.

1. Selecione o Mapa de Dados na navegação à esquerda.

2. Selecione Registrar.

   Selecione Fabric como sua fonte de dados.

   

3. Insira um nome amigável para sua instância de Malha e selecione uma coleção.

   O nome deve ter entre 3 e 63 caracteres e só pode conter letras, números, sublinhados e hifens. Não use espaços.

   Por padrão, o sistema encontra o locatário do Fabric que existe no mesmo locatário do Microsoft Entra.

Autenticação para verificação

Para verificar seu locatário do Fabric e examinar seus metadados, primeiro você precisa criar uma maneira de autenticar usando o locatário do Fabric. Em seguida, forneça à Microsoft Purview as informações de autenticação.

Autenticar para locatário do Fabric

No locatário do Microsoft Entra em que o locatário do Fabric está localizado:

1. No portal do Azure, procure o Microsoft Entra ID.

2. Crie um novo grupo de segurança em seu Microsoft Entra ID, seguindo Criar um grupo básico e adicionar membros usando o Microsoft Entra ID.

   Dica

   Você pode ignorar esta etapa se já tiver um grupo de segurança que deseja usar.

3. Selecione Segurança como o Tipo de Grupo.

   

4. Adicione quaisquer usuários relevantes ao grupo de segurança:

   • Se você estiver usando a Identidade Gerenciada como o método de autenticação, adicione sua identidade gerenciada do Microsoft Purview a esse grupo de segurança. Selecione Membros e, em seguida, selecione Adicionar membros.

   • Se você estiver usando a autenticação delegada ou a entidade de serviço como método de autenticação, adicione sua entidade de serviço a esse grupo de segurança. Selecione Membros e, em seguida, selecione Adicionar membros.

5. Pesquise sua entidade de serviço ou identidade gerenciada do Microsoft Purview e selecione-a.

   

   Você verá uma notificação de êxito que mostra que ela foi adicionada.

   

Associar o grupo de segurança ao locatário do Fabric

1. Entre no portal de administração do Fabric.

2. Selecione a página Configurações de locatário .

   Importante

   Você precisa ser um administrador do Fabric Administração para ver a página de configurações do locatário.

3. Selecionar configurações > da API de AdministraçãoPermitir que as entidades de serviço usem APIs de administração somente leitura.

4. Selecione Grupos de segurança específicos.

5. Selecionar configurações >da API de AdministraçãoAprimore as respostas das APIs administrativas com metadados detalhados e Aprimore as respostas das APIs administrativas com DAX e expressões> de mashup Habilite a alternância para permitir que o Mapa de Dados do Microsoft Purview descubra automaticamente os metadados detalhados dos conjuntos de dados do Fabric como parte de suas verificações.

   Importante

   Depois de atualizar as configurações da API de Administração em seu locatário do Fabric, aguarde cerca de 15 minutos antes de registrar uma verificação e testar a conexão.

   Cuidado

   Ao permitir que o grupo de segurança criado (que tem sua identidade gerenciada do Microsoft Purview como membro) use APIs de administração somente leitura, você também permite que ele acesse os metadados (como nomes, proprietários e descrições de dashboard e relatório) para todos os seus artefatos do Fabric neste locatário. Depois que os metadados são extraídos para o Microsoft Purview, as permissões do Microsoft Purview, e não as permissões do Fabric, determinam quem pode ver esses metadados.

   Observação

   • Você pode remover o grupo de segurança das configurações de desenvolvedor, mas os metadados extraídos anteriormente não serão removidos da conta do Microsoft Purview. Você pode excluí-lo separadamente, se desejar.

   • Se o item do Fabric (como lakehouse ou catálogo espelhado) tiver a segurança OneLake habilitada, você deverá criar uma função de segurança OneLake com permissão de leitura atribuída ao usuário do Microsoft Purview. Consulte Introdução ao OneLake Security para obter instruções passo a passo.

Configurar credenciais para verificações no Microsoft Purview

Identidade gerenciada

Se você seguir todas as etapas na autenticação do Microsoft Purview para Estrutura, não precisará de nenhuma outra etapa de autenticação para identidades gerenciadas.

Entidade de serviço

1. No portal do Azure, selecione o Microsoft Entra ID e crie um Registro de Aplicativo no locatário. Forneça uma URL da Web no URI de redirecionamento. Para obter informações sobre o URI de redirecionamento, consulte esta documentação do Microsoft Entra ID.

   

2. Anote a ID do cliente (ID do aplicativo).

   

3. No Microsoft Entra dashboard, selecione o aplicativo recém-criado e, em seguida, selecione Registro do aplicativo. Em Permissões de API, atribua ao aplicativo as seguintes permissões delegadas:

   • Microsoft Graph openid
   • Microsoft Graph User.Read

   

4. Em Configurações avançadas, habilite Permitir fluxos de clientes públicos.

5. Em Certificados & segredos, crie um novo segredo e salve-o com segurança para as próximas etapas.

6. No portal do Azure, navegue até o seu Key Vault.

7. Selecione Configurações>Segredos e selecione + Gerar/Importar.

   

8. Insira um nome para o segredo e, para Valor, digite o segredo recém-criado para o registro do aplicativo. Selecione Criar para concluir.

   

9. Se o cofre de chaves ainda não estiver conectado ao Microsoft Purview, você precisará criar uma nova conexão de cofre de chaves.

10. Agora que você criou seu segredo, no Microsoft Purview, acesse a página Credenciais em Gerenciamento.

    Dica

    Como alternativa, você pode criar uma nova credencial durante o processo de verificação.

11. Selecione Novo para criar sua nova credencial.

12. Forneça os parâmetros necessários:

    • Nome: Forneça um nome exclusivo para a credencial.
    • Método de autenticação: Entidade de serviço
    • ID do locatário: sua ID de locatário do Fabric
    • ID do cliente: use a entidade de serviço ID do cliente (ID do aplicativo) que você criou anteriormente.
    • Conexão do Key Vault: a conexão do Microsoft Purview com o Key Vault em que você criou seu segredo anteriormente.
    • Nome do segredo: o nome do segredo que você criou anteriormente.

    

13. Depois de preencher todos os detalhes, selecione Criar.

Autenticação delegada

1. Crie uma conta de usuário no locatário do Microsoft Entra e atribua o usuário à função do Microsoft Entra, Administrador do Fabric. Anote o nome de usuário e entre para alterar a senha.

2. Vá para o seu Key Vault.

3. Selecione Configurações>Segredos e selecione + Gerar/Importar.

   

4. Insira um nome para o segredo e, em Valor, digite a senha recém-criada para o usuário do Microsoft Entra. Selecione Criar para concluir.

   

5. Se o cofre de chaves ainda não estiver conectado ao Microsoft Purview, você precisará criar uma nova conexão de cofre de chaves

6. Crie um registro de aplicativo em seu locatário do Microsoft Entra. Forneça uma URL da Web no URI de redirecionamento.

   

7. Anote a ID do cliente (ID do aplicativo).

   

8. No Microsoft Entra dashboard, selecione o aplicativo recém-criado e selecione permissões de API. Atribua ao aplicativo as seguintes permissões delegadas e conceda consentimento de administrador para o locatário:

   • Serviço de Malha Tenant.Read.All
   • Microsoft Graph openid
   • Microsoft Graph User.Read

   

9. Em Configurações avançadas, habilite Permitir fluxos de clientes públicos.

10. Em seguida, no Microsoft Purview, vá para a página Credenciais em Gerenciamento para criar uma nova credencial.

    Dica

    Como alternativa, você pode criar uma nova credencial durante o processo de verificação.

11. Selecione Novo para criar sua nova credencial.

12. Forneça os parâmetros necessários:

    • Nome: Forneça um nome exclusivo para a credencial.
    • Método de autenticação: Autenticação delegada.
    • ID do cliente: use a entidade de serviço ID do cliente (ID do aplicativo) que você criou anteriormente.
    • Nome de usuário: forneça o nome de usuário do administrador do Fabric que você criou anteriormente.
    • Conexão do Key Vault: a conexão do Microsoft Purview com o Key Vault em que você criou seu segredo anteriormente.
    • Nome do segredo: o nome do segredo que você criou anteriormente.

    

13. Depois de preencher todos os detalhes, selecione Criar.

Criar verificação

1. No portal do Microsoft Purview, vá para Mapa de Dados.

2. Vá para Fontes.

3. Selecione a origem de Malha registrada.

4. Selecione + Nova verificação.

5. Insira um nome para a verificação.

6. Selecione sua credencial de identidade gerenciada ou a credencial que você criou para sua entidade de serviço ou autenticação delegada.

   

7. Selecione Testar Conexão antes de prosseguir para as próximas etapas. Se a conexão de teste falhar, selecione Exibir relatório para ver o status detalhado e solucionar o problema. 1. Acesso - O status com falha significa que a autenticação do usuário falhou. As verificações que usam identidade gerenciada sempre são aprovadas, pois nenhuma autenticação de usuário é necessária. Se você usar a entidade de serviço ou a autenticação delegada, verifique se sua credencial do Key Vault está configurada corretamente e se o Microsoft Purview tem acesso ao cofre de chaves. 1. Ativos (+ linhagem) - O status Falha significa que a autorização do Microsoft Purview - Fabric falhou. Certifique-se de que a identidade gerenciada do Microsoft Purview seja adicionada ao grupo de segurança no portal de administração do Fabric.

   1. Metadados detalhados (aprimorados) - O status de falha significa que o portal de administração do Fabric está desabilitado para a seguinte configuração: - Aprimore as respostas das APIs de administração com metadados detalhados

   Dica

   Para obter mais soluções de problemas, consulte a lista de verificação de implantação para garantir que você cobriu todas as etapas do seu cenário.

8. Configure um gatilho de verificação. Suas opções são Recorrente e Uma vez.

   

9. Em Revisar nova verificação, selecione Salvar e executar para iniciar a verificação.

Exibir suas verificações e execuções de verificação

Para exibir as verificações existentes:

1. Acesse o portal do Microsoft Purview. No painel esquerdo, selecione Mapa de dados.
2. Selecione a fonte de dados. Você pode exibir uma lista de verificações existentes nessa fonte de dados em Verificações recentes ou pode exibir todas as verificações na guia Verificações .
3. Selecione a verificação que tem os resultados que você deseja visualizar. O painel mostra todas as execuções de verificação anteriores, juntamente com o status e as métricas de cada execução de verificação.
4. Selecione a ID de execução para marcar os detalhes da execução de verificação.

Gerenciar suas varreduras

Para editar, cancelar ou excluir uma verificação:

1. Acesse o portal do Microsoft Purview. No painel esquerdo, selecione Mapa de Dados.

2. Selecione a fonte de dados. Você pode exibir uma lista de verificações existentes nessa fonte de dados em Verificações recentes ou pode exibir todas as verificações na guia Verificações .

3. Selecione a verificação que você quer gerenciar. Você poderá:

   • Edite a verificação selecionando Editar verificação.
   • Cancele uma verificação em andamento selecionando Cancelar execução de verificação.
   • Exclua a verificação selecionando Excluir verificação.

Glossário

Itens e subitens no Microsoft Fabric Lakehouse:

• Itens: no Fabric, os itens são artefatos de espaço de trabalho de nível superior, como Lakehouse, Warehouse, Notebook, Pipeline e Semantic Model. Cada item atua como uma única entidade para operações de ciclo de vida, incluindo criação, exclusão e rastreamento de CI/CD. Um Lakehouse em si é um item. Tabelas (Delta e não Delta), arquivos, pastas e, às vezes, atalhos dentro de um Lakehouse são considerados subitens.
• Subitens: esses elementos representam a camada de dados real. Você pode exibi-los e consultá-los por meio de pontos de extremidade do Spark e do SQL. No entanto, você não pode gerenciá-las ou implantá-las de forma independente.

Próximas etapas

Agora que você registrou sua fonte, siga estes guias para saber mais sobre o Microsoft Purview e seus dados.

• Insights sobre o patrimônio de dados no Microsoft Purview

• Pesquisar no Catálogo unificado