產生和儲存計量資料
重要
這其中部分或所有的功能會做為預覽版本的一部分來提供。 內容和功能隨時可能變更。
聚合表生成后，您可以在聚合表資料集上運行指標定義中定義的計算邏輯 (聚合或計算) 來生成指標輸出數據。
度量的計算邏輯定義為：
Power BI measures：包含數據分析表達式 (DAX) 公式語言形式的計算邏輯。 Power BI 度量值在作為功能的一部分部署的 DatasetForMetricsMeasures_DTST 預構建語義模型中定義。 Power BI 要瞭解有關度量的更多資訊，請轉到 文檔中的創建用於數據分析的 Power BI Desktop Power BI 度量。
維度：指定量度輸出中所需的維度/列。 這些維度可以來自聚合表，也可以來自 DatasetForMetricsMeasures_DTST 語義模型中的計算表 。
Filters：指定聚合表維度中需要篩選的值。
一個示例預構建指標範圍 3 類別排放 (GHG 協定)。
以下是 metrics_definitions_config.json 檔中此指標的指標定義：
{
"metric_name": "Scope 3 GHG emissions by category (GHG Protocol)",
"measure_name": "Emissions",
"dimensions": [
"EmissionsAggregate[EmissionSource]",
"EmissionsAggregate[UnitOfMeasureName]",
"EmissionsAggregate[ReportingPeriod]"
],
"filters": {
"EmissionsAggregate[isRolledUp]": [
"False"
],
"EmissionsAggregate[Scope]": [
"Scope 3"
],
"EmissionsAggregate[AccountingMethod]": [
"Location based",
null
],
"EmissionsAggregate[UnitOfMeasureName]": [
"mtCO2e"
]
},
"sustainability_area": "Climate Change",
"labels": {
"Reporting standard": [
"CSRD"
],
"Disclosure datapoint": [
"E1-6_04"
]
}
}
根據指標定義，指標輸出包括：
- 在量度定義中指定為維度的列
- 通過運行度量定義中指定的計算邏輯計算的 value 列
對於示例指標，這些輸出列為：
- EmissionSource：捕獲範圍 3 類別名稱。
- 計量單位名稱：提及排放值的計量單位，例如 mtCO2e。
- 報告週期：指定報告年度。
- 值：捕獲特定報告期間範圍 3 類別的排放值。
對於此指標，您需要計算 CO2eEmissionsUnits 的總 和，其中 Scope 是 Scope 3 且 AccountingMethod 為 null，或者 基於 EmissionsAggregate 表中的 Location at Emission source 和 Reporting period。
此計算由度量定義中指定的計算邏輯執行如下：
Emissions 度量執行 EmissionsAggregate 表中的 CO2eEmissions 之和，並在 DatasetForMetricsMeasures_DTST 語義模型中定義：
要檢視用於計算預生成指標的預生成 Power BI 度量值，請執行以下步驟：
- 從工作區打開 DatasetForMetricsMeasures_DTST 。
- 選取打開資料模型。
- 從 Data 側面板中選擇 ESG_measures 。
如果 Open data model (打開數據模型 ) 顯示為灰色，則導航到 Workspace 設置。 打開 Power BI/常規並打開 使用者可以在服務（預覽版） Power BI 中編輯數據模型 設置。
維度 度量在聚合表的度量定義 (報告期間)、排放源和度量單位列中指定的維度執行聚合。 這些列來自指標輸出的維度。
Filters 指定 EmissionsAggregate 表的不同列所需的值，以便按度量值求和。 在此示例中，範圍為範圍 3，會計方法為 null 或基於位置，度量單位為 mtCO2e 的行。
為了使用 Power BI 度量、維度和篩選條件計算指標數據，預構建的筆記本使用 語義連結的 Python 庫 SemPy 的 Python 介面的 evaluate_measure函數。
生成指標數據的先決條件
- 生成指標所需的聚合表應已存在於 ComputedESGMetrics_LH 湖存放庫中。
- 在運行指標的計算邏輯之前，請確保將指標定義作為表載入到 ComputedESGMetrics 湖存放庫中。 除非您更新指標定義，否則無需重新載入定義。 直接運行 Load metric definition 筆記本，或運行 ExecuteComputationForMetrics 管道的 Load metric definition 活動。
生成和存儲指標數據
在 ExecuteComputationOfMetrics_DTPL 管道中運行 Generate output for metrics 活動 ，或直接運行 GenerateOutputForMetrics_INTB 筆記本以在聚合表 資料集 上運行指標計算邏輯，並將輸出數據存儲在 ComputedESGMetrics_LH 湖存放庫 的 ComputedESGMetrics 表中 。
您可以指定這些參數來為一組特定的指標生成輸出。 如果要為 MetricsDefinitions 表中載入 的所有指標定義生成輸出，請不要在管道中指定參數值，並在筆記本中將其 設置為 None 。
注意
參數值區分大小寫。
metric_names：指定指標名稱清單。 您可以從預構建的指標庫中 獲取指標名稱 ，也可以查詢 ComputedESGMetrics_LH 湖存放庫 中的 MetricsDefinitions 表。 例如，[“按類別劃分的範圍 3 溫室氣體排放（溫室氣體核算體系）”，“總用水量”]。
sustainability_areas：指定可持續性領域清單。 例如，[“氣候變化”，“水和海洋資源”]。 映射到參數中指定的可持續性區域的所有指標都將被考慮進行計算。 您可以從預構建指標庫 中找到映射到指標 的可持續性區域，也可以查詢 ComputedESGMetrics_LH 湖存放庫 中的 MetricsDefinitions 表。
注意
如果同時 指定 sustainability_areas 和 metric_names，則 metric_names 參數優先並考慮進行計算。
筆記本或管道活動成功運行后，您可以在 ComputedESGMetrics_LH 湖存放庫 的 ComputedESGMetrics 表中查看指標輸出 。 ComputedESGMetrics 是一個表，用於存儲所有指標的輸出。 此表顯示了表的架構詳細資訊。
資料行名稱 Description 指標 ID 量度的唯一標識碼。 表示為其生成數據的量度。 它是 MetricsDefinitions 表的 外鍵。 ReportingPeriod 表示生成度量值的報告期間（年）。 UnitOfMeasureName (度量單位名稱) 表示度量值的度量單位（例如，mtCO2e 表示排放值）。 數值 表示特定 ReportingPeriod 和 DimensionValue的量度值。 維度名稱 如果量度輸出具有除 ReportingPeriod 之外的其他維度，則此維度名稱將在 DimensionName 列中指定 。 相應的值在 DimensionValue 中，數據類型在 DimensionType 中。 維度值 包含在 DimensionName 列中指定的 維度的特定值。 維度類型 在 DimensionName 中指定維度的數據類型。 Index Index 和 MetricId 唯一標識指標的特定行。 當從此單個量度輸出表中檢索維度作為單獨列的特定量度輸出時，此列非常有用。 如果要將每個指標的數據存儲為單獨的 DataFrame 或 Table，可以使用 get_metric_output_by_id 函數 框 獲取指標輸出數據。
