分析排放資料
重要
這其中部分或所有的功能會做為預覽版本的一部分來提供。 內容和功能隨時可能變更。
您可以通過 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 管理員聯繫以完成以下步驟:
為應用程式識別分配權限:
導航到工作區檢視,然後選擇 Manage access(管理訪問許可權 ) 選項以在工作區級別管理角色。
選擇 Add people or groups(添加人員或組) 按鈕,添加具有以下角色之一的應用程式身份: Member 、投稿人 或Admin 。此步驟是必需的,因為訪問的數據是 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 庫或工具解析回覆正文。 例如,如果您使用 .NET 應用程式通過 API 讀取排放數據,則可以使用其中一個 C# Parquet 庫來解碼 Parquet 內容並將其存儲在應用程式端。