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

重要

仅停用 Microsoft Purview 数据治理功能

Microsoft Purview 统一目录和经典 Microsoft Purview 数据治理功能 (以前称为 Azure Purview) 即将停用。 Microsoft Purview 整体未停用。 Microsoft Purview 数据安全性和合规性功能不受此公告的影响,Microsoft 将继续对其进行投资。

Microsoft 正在 Microsoft Fabric 中整合其 数据治理 功能。 无法再创建新的 Microsoft Purview 数据治理帐户,现有数据治理功能将在 2027 年 11 月 12 日前保持维护模式。

有关停用时间表、过渡指南和建议的后续步骤,请参阅 Microsoft Purview 数据治理停用公告。

重要

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

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

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

目前,您可以查看资产历史记录之一:

先决条件

在使用数据映射历史记录之前,请 确保已在组织中启用审核日志。 如果不是,您需要将其打开才能访问您的数据映射历史记录。

哪些资产具有历史记录

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

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

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

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

通过数据映射历史记录,可以在 Microsoft Purview 中查看数据映射资产更改的操作历史记录。

可以看到选定操作的历史记录,包括:

  • 创建
  • 更新
  • 分配

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

重要

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

审核解决方案体验

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

  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. 目前,若要在 “历史记录 ”选项卡中查看新项,需要手动刷新该选项卡。

后续步骤