Compartilhar via


Visão geral da verificação dos metadados

A verificação de metadados facilita a governança dos dados do Microsoft Fabric da sua organização, tornando possível catalogar e relatar todos os metadados dos itens do Fabric da sua organização. Isso é possível por meio de um conjunto de APIs REST de Administrador conhecidas coletivamente como APIs do scanner.

Com as APIs do scanner, você pode extrair informações como nome do item, proprietário, rótulo de confidencialidade, marcas aplicadas e status de endosso. Para modelos semânticos do Power BI, você também pode extrair os metadados de alguns dos objetos que eles contêm, como nomes de tabela e coluna, medidas, expressões DAX, consultas de mashup e assim por diante. Os metadados desses objetos internos de modelo semântico são chamados de metadados de subátifacto.

Para obter uma lista mais abrangente dos metadados de artefato e subátifacto que a verificação de metadados retorna, consulte a documentação da API Admin – WorkspaceInfo GetScanResult.

Veja a seguir as APIs do scanner. Eles dão suporte a nuvens públicas e soberanas.

Importante

O aplicativo que você desenvolve para escaneamento pode autenticar-se usando um token de acesso de administrador delegado padrão ou um principal de serviço. Os dois caminhos de autenticação são mutuamente exclusivos. Ao executar sob um principal de serviço, não deve haver permissões que exijam consentimento do administrador do Power BI definidas em seu aplicativo. Para obter mais informações, consulte Habilitar a autenticação da entidade de serviço para APIs de administrador.

Fluxo básico

  • Configurar a verificação de metadados na organização: antes que a verificação de metadados possa ser executada, um administrador do Fabric precisa configurá-la em sua organização. Os administradores de fabric devem ver Configuração de escaneamento de metadados.

  • Habilite a autenticação da entidade de serviço para APIs somente leitura do administrador. A entidade de serviço é um método de autenticação que pode ser usado para permitir que um aplicativo do Microsoft Entra acesse o conteúdo e as APIs do Microsoft Fabric. Consulte Habilitar autenticação de entidade de serviço para APIs de administrador.

  • Executar a verificação de metadados: consulte Executar verificação de metadados para obter um passo a passo que demonstra como executar uma verificação.

Licenciamento

A verificação de metadados não exige uma licença especial. Funciona para todos os metadados do seu assinante, incluindo os de itens localizados em espaços de trabalho não Premium.