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

项目
12/19/2024

重要

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

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

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

目前，可以查看资产的历史记录：

在 Microsoft Purview 门户的审核解决方案中
在单个解决方案中
使用 REST API

先决条件

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

哪些资产具有历史记录

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

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

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

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

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

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

创造
更新
分配

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

重要

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

审核解决方案体验

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

导航到 Microsoft Purview 中的审核解决方案
选择 “搜索 ”以搜索审核记录
选择活动的时间范围。
使用 活动 - 友好名称、 活动 - 操作名称或 记录类型缩小搜索范围。

提示

有关可用活动的列表，请参阅审核日志活动页
选择“ 搜索 ”并等待作业状态更改为 “完成”。
从列表中选择搜索，滚动或筛选历史记录表以查找要查找的操作。

解决方案中历史记录体验

注意

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

若要查看活动，请按照以下说明操作：

在 Microsoft Purview 统一目录中搜索数据资产、术语表术语或分类。
选择“ 历史记录 ”选项卡。
滚动或筛选历史记录表以查找要查找的操作。

使用 REST API 查询审核日志

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

若要使用 REST API 进行身份验证，请按照对 API 进行身份验证页上的说明进行操作。
使用身份验证令牌 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
}

限制

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

通过