分析排放数据
重要提示
此功能的部分或全部属于预览版内容。 相关内容和功能可能会发生更改。
您可以通过 Sustainability 数据解决方案 Microsoft Fabric中的 Azure emissions insights 功能使用两种方法来访问排放数据：
通过 SQL 获取排放数据
您可以通过 AnalyzeAzureEmissionsDataset 中提供的 SQL 终结点访问 ComputedESGMetrics 湖屋 中的 聚合数据，步骤如下：
在 Azure emissions insights 功能主页上，选择 AnalyzeAzureEmissionsDataset 语义模型。
导航到 ComputedESGMetrics SQL 结束指向。
可以使用 复制 SQL 连接字符串 在外部将数据集与兼容的 SQL 客户端工具（如 Azure Data Studio 和 SQL Server Management Studio（SSMS））一起使用。
通过 API 访问排放数据
在 ID Microsoft Entra 租户 中创建应用程序身份，并为 应用程序身份创建新的客户端密钥。
对于此使用案例，请仅在 此组织目录中使用 Accounts（账户）类型注册应用程序。 跳过重定向 URI，因为在这种情况下不需要它。 您还可以跳过 Configure platform settings 步骤，因为此方案不需要这些步骤。
配置管理员级别的租户设置。 确保您具有文档中的 Understand admin roles Microsoft Fabric 中定义的 Microsoft Fabric 管理员角色之一。 如果需要，请与租户 Microsoft Fabric 管理员联系以完成以下步骤：
在 Fabric 中打开您部署了 Sustainability 数据解决方案的工作区。
选择设置 图标以打开设置侧面板，然后选择 管理员门户。
在 Tenant settings（租户设置 ） 部分中，转到 Developer settings（ 开发人员设置 ）并为整个组织或特定安全组启用 Service principals can use Fabric APIs（服务委托人可以使用 Fabric APIs ） 权限。
验证您之前创建的应用程序身份是否是安全组的成员。
为应用程序标识分配权限：
导航到工作区视图，然后选择 Manage access（管理访问权限 ）选项以在工作区级别管理角色。
选择“添加人员或组 ”按钮以添加具有以下角色之一的应用程序标识： 成员、 参与者或 管理员。此步骤是必需的，因为访问的数据是 OneLake 内部快捷方式。
调用 REST API：
备注
您可以将这些 REST API 调用集成到任何 HTTP 客户端应用程序中。
获取已配置应用程序身份的访问令牌。 请参阅 ID 文档中的获取令牌以使用守护程序应用程序 Microsoft Entra 调用 Web API，以使用客户端凭据 OAuth 2.0 工作流程获取应用程序身份的令牌。 Scope 参数应为“https://storage.azure.com/.default"在 Token 请求中。
使用以下 API 调用列出 IngestedRawData 湖屋中存在的数据分区文件。
workspaceId：工作区的唯一 Microsoft Fabric 标识符。 例如，在中打开 IngestedRawData 湖屋 Microsoft Fabric 时，它是 URL 中的第一个 GUID。
lakehouseId：具有导入的 Azure 排放数据的湖屋的唯一标识符。 此处，提取的原始数据湖屋 ID。 例如，在中打开 IngestedRawData 湖屋时，它是 URL 中的第二个 GUID Microsoft Fabric。
enrollmentNumber：需要读取其数据的计费注册 ID。 此处传递的计费注册 ID 与 IngestedRawData 湖屋中“Files/AzureEmissions”路径下可用的文件夹名称之一相同。
请求：
HTTP GET https://onelake.dfs.fabric.microsoft.com/<workspaceId>?recursive=false&resource=filesystem&directory=<lakehouseId>%2FFiles%2FAzureEmissions%2F<enrollmentNumber>响应:
返回文件属性的列表。 这些是存储指定注册编号的排放数据的数据分区文件。
获取特定数据分区文件的内容。
workspaceId：工作区的唯一 Microsoft Fabric 标识符。
emissionsPartitionFilePath：从上一个 API 调用中获取的分区文件之一的相对路径。 例如，这可以可视化如下：
<lakehouseId>/Files/AzureEmissions/<enrollmentNumber>/<emissionsPartitionFileName>.parquet
请求：
HTTP GET https://onelake.dfs.fabric.microsoft.com/<workspaceId>/<emissionsPartitionFilePath>响应:
排放数据分区文件的内容。 在这里，由于 API 正在读取 Parquet 文件，因此必须通过适当的 Parquet 库或工具解析回复正文。 例如，如果您使用 a .NET 应用程序通过 API 读取排放数据，则可以使用其中一个 C# Parquet 库来解码 Parquet 内容并将其存储在应用程序端。
