共用方式為


分析排放資料

重要

這其中部分或所有的功能會做為預覽版本的一部分來提供。 內容和功能隨時可能變更。

您可以通過 Sustainability 數據解決方案 Microsoft Fabric中的 Azure emissions insights 功能使用兩種方法來訪問排放數據:

通過 SQL 獲取排放數據

您可以通過 AnalyzeAzureEmissionsDataset 中提供的 SQL 端點訪問 ComputedESGMetrics 湖存放庫 中的 聚合數據,步驟如下:

  1. Azure emissions insights 功能主頁上,選擇 AnalyzeAzureEmissionsDataset 語義模型。

  2. 導航到 ComputedESGMetrics SQL 結束指向

    ComputedESGMetrics SQL 結束指向的屏幕截圖。

  3. 可以使用 複製 SQL 連接字串 在外部將資料集與相容的 SQL 用戶端工具 (如 Azure Data Studio 和 SQL Server Management Studio (SSMS)) 一起使用。

    複製 SQL 連接字串的屏幕截圖。

通過 API 存取排放數據

  1. 在 ID Microsoft Entra 租戶 中創建應用程式身份,並為 應用程式身份創建新的用戶端金鑰。

    對於此使用案例,請僅在 此組織目錄中使用 Accounts(帳戶)類型註冊應用程式。 跳過重定向 URI,因為在這種情況下不需要它。 您還可以跳過 Configure platform settings 步驟,因為此方案不需要這些步驟。

  2. 配置管理員級別的租戶設置。 確保您具有文檔中的 Understand admin roles Microsoft Fabric 中定義的 Microsoft Fabric 管理員角色之一。 如果需要,請與租戶 Microsoft Fabric 管理員聯繫以完成以下步驟:

    1. 在 Fabric 中打開您部署了 Sustainability 資料解決方案的工作區。

    2. 選擇右上角的設置 圖示以打開設置側面板,然後選擇 Admin portal

    3. 在 Tenant settings(租戶設置 部分中,轉到 Developer settings ( 開發人員設置 ) 並為整個組織或特定安全組啟用 Service principals can use Fabric APIs(服務委託人可以使用 Fabric APIs 許可權。

    4. 驗證您之前創建的應用程式身份是否是安全組的成員。

      安全組截圖。

  3. 為應用程式識別分配權限:

    1. 導航到工作區檢視,然後選擇 Manage access(管理訪問許可權 選項以在工作區級別管理角色。

    2. 選擇 Add people or groups(添加人員或組) 按鈕,添加具有以下角色之一的應用程式身份: Member 投稿人 Admin 此步驟是必需的,因為訪問的數據是 OneLake 內部的快捷方式。

    Add people 螢幕的屏幕截圖。

  4. 調用 REST API:

    注意

    您可以將這些 REST API 呼叫整合到任何 HTTP 用戶端應用程式中。

    1. 獲取已配置應用程式身份的存取權杖。 請參閱 ID 文件中的獲取權杖以使用守護程式應用程式 Microsoft Entra 調用 Web API,以使用用戶端憑據 OAuth 2.0 工作流程獲取應用程式身份的令牌。 Scope 參數應為“https://storage.azure.com/.default"在 Token 請求中。

    2. 使用以下 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> 
      

      回覆:

      返回檔案屬性的清單。 這些是存儲指定註冊編號的排放數據的數據分區檔。

    3. 獲取特定數據分區文件的內容。

      • workspaceId:工作區的唯一 Microsoft Fabric 標識符。

      • emissionsPartitionFilePath:從上一個 API 調用中獲取的分區檔之一的相對路徑。 例如,這可以可視化如下:

        <lakehouseId>/Files/AzureEmissions/<enrollmentNumber>/<emissionsPartitionFileName>.parquet 
        

      要求:

      HTTP GET https://onelake.dfs.fabric.microsoft.com/<workspaceId>/<emissionsPartitionFilePath> 
      

      回覆:

      排放數據分區文件的內容。 在這裡,由於 API 正在讀取 Parquet 檔,因此必須通過適當的 Parquet 庫或工具解析回覆正文。 例如,如果您使用 .NET 應用程式通過 API 讀取排放數據,則可以使用其中一個 C# Parquet 庫來解碼 Parquet 內容並將其存儲在應用程式端。

下一步