Histórico do Mapa de Dados (versão prévia)

Quando um usuário atualiza um ativo no Microsoft Purview, o histórico do Mapa de Dados registra essa alteração e disponibiliza as informações no portal do Microsoft Purview. Informações sobre quem adicionou ou editou um ativo, quais edições foram feitas e quando a edição aconteceu, são armazenadas para referência posteriormente. Essas informações ajudam os auditores de dados e proprietários de negócios a manter a conformidade e a segurança em suas contas do Microsoft Purview. Ele também permite que administradores e administradores de dados depurem problemas e curadoria em seus ativos de dados.

O histórico do Mapa de Dados está disponível para os usuários nas versões gratuita e corporativa do Microsoft Purview.

Atualmente, você pode visualizar o histórico dos seus ativos:

• Na solução Auditoria no portal do Microsoft Purview
• Em soluções individuais
• Usar a API REST

Pré-requisitos

Antes de usar o histórico do Mapa de Dados, verifique se o log de auditoria está ativado em sua organização. Se não estiver, você precisará habilitá-lo para acessar o histórico do seu Mapa de Dados.

Quais ativos têm histórico

Atualmente, esses tipos de ativos têm o histórico do Mapa de Dados disponível:

• Classificações*
• Ativos de dados*
• Termos do glossário*
• Ativos de negócios*
• Domínios
• Coleções
• Atribuições de função
• Fontes de dados
• Examinar
• Verificar conjunto de regras
• Credential
• Política

* No momento, a experiência na solução só está disponível para classificações, ativos de dados, ativos de negócios e termos de glossário.

Como usar o histórico do Mapa de Dados

O histórico do Mapa de Dados permite que você veja o histórico operacional das alterações em seus ativos do Mapa de Dados no Microsoft Purview.

Você pode ver o histórico de operações selecionadas que incluem:

• Criação
• Atualizações
• Atribuição

Para obter uma lista completa das operações disponíveis no Histórico do Mapa de Dados, consulte a documentação de atividades do log de auditoria.

Experiência de solução de auditoria

Para exibir as atividades na solução de auditoria, siga estas instruções:

1. Navegue até a solução de Auditoria no Microsoft Purview

   

2. Selecione Pesquisar para pesquisar registros de auditoria

3. Selecione o intervalo de tempo para a atividade.

4. Restrinja o escopo da pesquisa usando Atividades - nomes amigáveis, Atividades - nomes de operação ou Tipos de registro.

   Dica

   Para obter a lista de atividades disponíveis, consulte a página de atividades do log de auditoria

   

5. Selecione Pesquisar e aguarde até que o estado do trabalho seja alterado para Concluído.

   

6. Selecione sua pesquisa na lista e role ou filtre a tabela de histórico para encontrar as operações que você está procurando.

   

Experiência de histórico na solução

Para exibir as atividades, siga estas instruções:

1. Pesquise um ativo de dados, um termo do glossário ou uma classificação no Catálogo unificado do Microsoft Purview.

2. Selecione a guia Histórico .

3. Role ou filtre a tabela de histórico para encontrar as operações que está procurando.

   

Consultar o log de auditoria usando a API REST

Você também pode usar a API REST do Microsoft Purview para acessar o histórico do Mapa de Dados.

1. Para autenticar com a API REST, siga as instruções na página Autenticar para APIs.
2. Use o token de autenticação para POSTAR nesta URL de solicitação: https://api.purview-service.microsoft.com/datamap/api/audit/query?api-version=2023-10-01-preview

Aqui estão alguns exemplos de chamadas à API que você pode usar para começar:

• Recuperar o histórico de um ativo em um intervalo de tempo
• Recuperar o histórico de uma operação específica
• Filtrar por usuário que editou um ativo
• Filtrar por palavras-chave
• Exemplo com paginação

Recuperar o histórico de um ativo em um intervalo de tempo

Obtenha todo o histórico de auditoria de um ativo em um intervalo de tempo específico.

{
  "category": "Asset",
  "guid": "f432d351-5442-4724-945b-516d5d501fc9",
  "startTime": "2024-01-01T00:00:00.000Z",
  "endTime": "2024-01-06T00:00:00.000Z",
  "sortBy": "CreationTime",
  "sortOrder": "Descending"
}

Recuperar o histórico de uma operação específica

Obtenha o histórico do tipo de operação específico. Por exemplo, quando as classificações são aplicadas ao ativo.

{
  "category": "Asset",
  "guid": "f432d351-5442-4724-945b-516d5d501fc9",
  "operationType": "ClassificationAdded",
  "sortBy": "CreationTime",
  "sortOrder": "Descending"
}

Filtrar por usuário que editou um ativo

{
  "category": "Asset",
  "guid": "f432d351-5442-4724-945b-516d5d501fc9",
  "userId": "contoso@microsoft.com",
  "sortBy": "CreationTime",
  "sortOrder": "Descending"
}

Filtrar por palavras-chave

Filtre por palavras-chave, como nome de atributo alterado, valor de atributo etc.

{
  "category": "Asset",
  "guid": "f432d351-5442-4724-945b-516d5d501fc9",
  "keywords": "userDescription",
  "sortBy": "CreationTime",
  "sortOrder": "Descending"
}

Exemplo com paginação

Após a primeira consulta, se a propriedade "lastPage" no corpo da resposta for falsa, o usuário poderá usar o "continuationToken" no corpo da resposta para buscar a próxima página.

{
  "continuationToken": "TY7BbsIwEAV%2fKDZr4oQ0KAcEVKo4klNvK…",
  "category": "Asset",
  "guid": "f432d351-5442-4724-945b-516d5d501fc9",
  "sortBy": "CreationTime",
  "sortOrder": "Descending",
  "pageSize": 10
}

Limitações

1. Atualmente, leva alguns minutos para que um item operacional apareça em uma guia Histórico de ativos.
2. No momento, para ver um novo item na guia Histórico , você precisa atualizar manualmente a guia.

Próximas etapas

• Curadoria de metadados
• Use o novo portal do Microsoft Purview
• Funções e permissões