資料對應歷程記錄 (預覽)

重要事項

先前Azure Purview) (Microsoft Purview 整合式目錄 和傳統 Microsoft Purview 資料控管功能即將淘汰。 Microsoft 正在 Microsoft Fabric 中合併其資料控管功能。 您無法再建立新帳戶,現有功能將維持在維護模式,直到 2027 年 11 月 12 日為止。 如需淘汰時間表、轉換指引,以及建議的後續步驟,請參閱 Microsoft Purview 資料控管淘汰公告。

重要事項

此功能目前處於預覽。 Microsoft Azure 預覽版的補充使用規定包含適用於 Beta 版、預覽版或尚未發行為一般可用性的 Azure 功能的其他法律條款。

當使用者更新 Microsoft Purview 中的資產時,資料對應歷程記錄會記錄該變更,並在 Microsoft Purview 入口網站中提供該資訊。 會儲存有關誰新增或編輯資產、已進行哪些編輯以及何時編輯的資訊,以供日後參考。 這項資訊可協助資料稽核員和企業擁有者維護其 Microsoft Purview 帳戶的合規性和安全性。 它還允許資料管理員和管理員調試其資料資產中的問題和管理。

資料對應歷程記錄可供 Microsoft Purview 免費 版和 企業 版的使用者使用。

目前,您可以檢視資產歷程記錄:

必要條件

在您可以使用資料對應歷程記錄之前, 請確定您的組織已開啟稽核記錄。 如果沒有,您需要將其開啟以存取您的資料對應歷程記錄。

哪些資產有歷程記錄

目前,這些類型的資產具有可用的資料對應歷程記錄:

  • 分類*
  • 資料資產*
  • 字彙術語*
  • 業務資產*
  • 網域
  • 集合
  • 角色分配
  • 資料來源
  • 掃描
  • 掃描規則集
  • 認證
  • 原則

* 解決方案內體驗 目前僅適用於分類、資料資產、商務資產和字彙。

如何使用資料對應歷程記錄

資料對應歷程記錄可讓您在 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. 目前,若要在 [歷程記錄 ] 索引標籤中查看新項目,您必須手動重新整理索引標籤。

後續步驟