数据映射历史记录 (预览)

重要

此功能目前处于预览阶段。 Microsoft Azure 预览版的补充使用条款包括适用于 Beta 版、预览版或其他尚未正式发布的 Azure 功能的其他法律条款。

当用户更新 Microsoft Purview 中的资产时,数据映射历史记录会记录更改并在 Purview 门户中Microsoft提供信息。 有关谁添加或编辑了资产、进行了哪些编辑以及何时进行编辑的信息将存储,供以后参考。 此信息可帮助数据审核员和业务所有者维护其Microsoft Purview 帐户的合规性和安全性。 它还允许数据专员和管理员调试其数据资产中的问题和监管。

Microsoft Purview 免费和企业 版的用户都可以使用数据映射历史记录。

目前,可以查看资产的历史记录:

先决条件

在使用数据映射历史记录之前, 请确保已在组织中打开审核日志。 否则,需要打开它才能访问数据映射历史记录。

哪些资产具有历史记录

目前,这些类型的资产具有可用的数据映射历史记录:

  • 分类*
  • 数据资产*
  • 术语表术语*
  • 业务资产*
  • 集合
  • 角色分配
  • 数据源
  • 扫描
  • 扫描规则集
  • Credential
  • Policy

* 解决方案内体验 目前仅适用于分类、数据资产、业务资产和术语表术语。

如何使用数据映射历史记录

数据映射历史记录允许查看 Microsoft Purview 中数据映射资产更改的操作历史记录。

可以查看选择操作的历史记录,其中包括:

  • 创造
  • 更新
  • 分配

有关数据映射历史记录中可用操作的完整列表,请参阅 审核日志活动文档。

重要

数据映射历史记录条目在审核中保留 180 天,在 解决方案内体验中可用 30 天。 若要长时间查看审核历史记录,可以使用 Microsoft Purview 审核 (Premium)

审核解决方案体验

若要查看审核解决方案中的活动,请按照以下说明操作:

  1. 导航到 Microsoft Purview 中的审核解决方案

    Microsoft Purview 门户中审核解决方案卡的屏幕截图。

  2. 选择 “搜索 ”以搜索审核记录

  3. 选择活动的时间范围。

  4. 使用 活动 - 友好名称活动 - 操作名称记录类型缩小搜索范围。

    提示

    有关可用活动的列表,请参阅 审核日志活动页

    Microsoft Purview 门户中审核解决方案搜索的屏幕截图。

  5. 选择“ 搜索 ”并等待作业状态更改为 “完成”。

    显示已完成状态的审核解决方案搜索的屏幕截图。

  6. 从列表中选择搜索,滚动或筛选历史记录表以查找要查找的操作。

    审核搜索结果详细信息页的屏幕截图,其中显示了包含返回的搜索结果的审核历史记录表。

解决方案中历史记录体验

注意

解决方案内体验目前仅适用于分类、数据资产、业务资产和术语表术语。

若要查看活动,请按照以下说明操作:

  1. Microsoft Purview 数据目录中搜索数据资产、术语表术语或分类。

  2. 选择“ 历史记录 ”选项卡。

  3. 滚动或筛选历史记录表以查找要查找的操作。

    解决方案中历史记录体验的屏幕截图,其中突出显示了“历史记录”选项卡。

使用 REST API 查询审核日志

还可以使用 Microsoft Purview REST API 访问数据映射历史记录。

  1. 若要使用 REST API 进行身份验证,请按照对 API 进行身份验证页上的说明进行操作。
  2. 使用身份验证令牌 POST 到此请求 URL: https://api.purview-service.microsoft.com/datamap/api/audit/query?api-version=2023-10-01-preview

下面是一些可用于入门的示例 API 调用:

检索资产在某个时间范围内的历史记录

获取特定时间范围内资产的所有审核历史记录。

{
  "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"
}

检索特定操作的历史记录

获取特定操作类型的历史记录。 例如,将分类应用于资产时。

提示

有关可用操作的列表,请参阅 审核日志活动页

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

按编辑资产的用户进行筛选

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

按关键字筛选

按关键字(如已更改的属性名称、属性值等)进行筛选。

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

分页示例

在第一个查询之后,如果响应正文中的“lastPage”属性为 false,则使用可以使用响应正文中的“continuationToken”来提取下一页。

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

限制

  1. 目前,操作项需要几分钟时间才能显示在“资产 历史记录 ”选项卡中。
  2. 目前,若要在“ 历史记录 ”选项卡中查看新项,需要手动刷新选项卡。

后续步骤