元数据扫描概述

借助元数据扫描，可对组织结构项目的所有元数据进行编目和报告，从而帮助管理组织的 Microsoft Fabric 数据。 它使用一组统称为“扫描程序 API”的管理 REST API 来实现此目的。

使用扫描程序 API，可以提取信息，例如项目名称、所有者、敏感度标签和认可状态。 对于 Power BI 语义模型，还可以提取它们包含的某些对象的元数据，例如表和列名、度量值、DAX 表达式、混合查询等。 这些语义模型内部对象的元数据称为子项目元数据。

有关元数据扫描返回的项目和子项目元数据的更详细列表，请参阅管理员 - WorkspaceInfo GetScanResult API 的文档。

以下是扫描仪 API。 它们支持公有云和主权云。

• GetModifiedWorkspaces
• WorkspaceGetInfo
• WorkspaceScanStatus
• WorkspaceScanResult

重要

开发用于扫描的应用可以通过使用标准委派管理员访问令牌或服务主体进行身份验证。 这两个身份验证路径是相互排斥的。 在服务主体下运行时，你的应用必须未设置 Power BI 管理员同意所需的权限。 有关详细信息，请参阅为只读管理 API 启用服务主体身份验证。

基本流程

• 在组织中设置元数据扫描：在可以运行元数据扫描之前，结构管理员需要在组织中对其进行设置。 结构管理员应查看设置元数据扫描。

• 为管理员只读 API 启用服务主体身份验证。 服务主体是一种身份验证方法，可用于让 Microsoft Entra 应用程序访问 Microsoft Fabric 内容和 API。 请参阅为管理员只读 API 启用服务主体身份验证。

• 运行元数据扫描：有关演示如何运行扫描的演练，请参阅运行元数据扫描。

许可

元数据扫描无需特殊许可证。 它适用于你的所有租户元数据（包括位于非高级工作区中的项的元数据）。

相关内容

• 设置元数据扫描。
• 为只读管理员 API 启用服务主体身份验证。
• 运行元数据扫描
• 了解 Power BI REST 管理员 API。