元數據掃描概觀

元數據掃描可讓您編目和報告組織網狀架構專案的所有元數據，以協助治理組織的 Microsoft Fabric 數據。它會使用一組統稱為掃描器 API 的管理員 REST API 來完成此作業。

透過掃描器 API，您可以擷取專案名稱、擁有者、敏感度標籤和簽署狀態等資訊。針對 Power BI 語意模型，您也可以擷取其包含之某些物件的元數據，例如數據表和數據行名稱、量值、DAX 表達式、混搭查詢等等。這些語意模型內部物件的元數據稱為子語意元數據。

如需元數據掃描傳回之成品和子修飾元數據的詳細清單，請參閱管理員 - WorkspaceInfo GetScanResult API 的檔。

以下是掃描器 API。它們同時支援公用和主權雲端。

重要

您為掃描開發的應用程式可以使用標準委派系統管理員存取令牌或服務主體進行驗證。這兩個驗證路徑互斥。 在服務主體下執行時，您的應用程式上不得設定任何 Power BI 管理員同意的必要許可權。如需詳細資訊，請參閱啟用只讀系統管理員 API 的服務主體驗證。

基本流程

在組織中設定元數據掃描：在可以執行元數據掃描之前，網狀架構系統管理員必須在您的組織中加以設定。網狀架構管理員應該會看到設定元數據掃描。
啟用管理員只讀 API 的服務主體驗證。服務主體是一種驗證方法，可用來讓 Microsoft Entra 應用程式存取 Microsoft Fabric 內容和 API。請參閱啟用管理員唯讀 API 的服務主體驗證。
執行元數據掃描：如需示範如何執行掃描的逐步解說，請參閱執行元數據掃描。

中繼資料掃描不需要特殊授權。它適用於所有租使用者的元數據，包括位於非進階版工作區中的專案。