Generera och lagra måttdata
Viktigt
Några eller alla dessa funktioner ingår som en del av en förhandsversion. Innehållet och funktionerna kan komma att ändras.
När den aggregerade tabellen har genererats kan du köra beräkningslogiken (aggregering eller beräkning) som definierats i måttenhetsdefinitionen ovanpå den aggregerade tabellen datauppsättning för att generera måttenhetens utdata.
Beräkningslogiken för ett mått definieras med:
Power BI mått: Innehåller beräkningslogik i form av formelspråket DAX (Data Analysis Expressions). Power BI Mått definieras i den DatasetForMetricsMeasures_DTST fördefinierade semantiska modellen som används som en del av funktionen. Om du vill veta mer om Power BI mått går du till Skapa mått för dataanalys i Power BI Desktop dokumentationen Power BI .
Dimensioner: Anger de dimensioner/kolumner som krävs i måttutdata. Dessa dimensioner kan komma från aggregerade tabeller eller de beräknade tabellerna i den DatasetForMetricsMeasures_DTST semantiska modellen.
Filter: Anger de värden från de aggregerade tabelldimensionerna som behöver filtreras.
Ett exempel på ett fördefinierat mått för kategorivisa utsläpp i Scope 3 (GHG-protokollet).
Följande är måttdefinitionen för det här måttet från den metrics_definitions_config.json filen:
{
"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"
]
}
}
Baserat på måttenhetsdefinitionen består måttutdata av:
- Kolumnerna som anges som dimensioner i måttenhetsdefinitionen
- Värdekolumnen som beräknas genom att köra den beräkningslogik som anges i måttenhetsdefinitionen
För exempelmåttet är dessa utdatakolumner:
- EmissionSource: Samlar in kategorinamnet för omfång 3.
- Namn på måttenhet: Nämner måttenheten för utsläppsvärdet, till exempel mtCO2e.
- Rapporteringsperiod: Anger rapporteringsåret.
- Värde: Samlar in utsläppsvärdet för en scope 3-kategori för en specifik rapporteringsperiod.
För det här måttet måste du beräkna summan av CO2eEmissionsUnits där Scope är Scope 3 och AccountingMethod är null eller Location based at Emission source and Reporting period från tabellen EmissionsAggregate.
Den här beräkningen utförs på följande sätt av den beräkningslogik som anges i måttenhetsdefinitionen:
Emissionsmåttet utför summan av CO2eEmissions från tabellen EmissionsAggregate och definieras i den DatasetForMetricsMeasures_DTST semantiska modellen:
Följ dessa steg om du vill visa de fördefinierade Power BI mått som används för att beräkna fördefinierade mått:
- Öppna DatasetForMetricsMeasures_DTST från arbetsytan.
- Välj Öppna datamodell.
- Välj ESG_measures från sidopanelen Data .
Om Öppna datamodell är nedtonad navigerar du till inställningen Arbetsyta . Öppna Power BI/Allmänt och aktivera inställningen Användare kan redigera datamodeller i Power BI tjänsten (förhandsversion).
Dimensionsmåttet utför aggregeringen vid de dimensioner som anges i kolumnerna för mätvärdesdefinition (rapporteringsperiod), utsläppskälla och måttenhet i den aggregerade tabellen. Dessa kolumner från dimensionerna för måttutdata.
Filter anger de värden som krävs för olika kolumner i tabellen EmissionsAggregate som ska summeras efter måttet. I det här exemplet är rader där omfånget är scope 3, redovisningsmetoden är null eller platsbaserad och måttenheten är mtCO2e.
För att beräkna måttdata med Power BI mått, dimensioner och filter använder den fördefinierade notebook-filen evaluate_measure funktionen i Python-gränssnittet för den semantiska länkens Python-bibliotek, SemPy.
Förutsättningar för att generera måttdata
- Den aggregerade tabell som krävs för att generera måttet bör redan finnas i ComputedESGMetrics_LH sjöhus.
- Innan du kör beräkningslogiken för ett mått kontrollerar du att måttdefinitionerna läses in som tabeller i ComputedESGMetrics sjöhus. Om du inte uppdaterar måttdefinitionen behöver du inte läsa in definitionerna igen. Kör anteckningsboken för definition av inläsningsmått direkt eller kör aktiviteten Definition av inläsningsmått för pipelinen ExecuteComputationForMetrics .
Generera och lagra måttdata
Kör aktiviteten Generera utdata för mått i ExecuteComputationOfMetrics_DTPL-pipelinen eller kör den GenerateOutputForMetrics_INTB notebook-filen direkt för att köra måttberäkningslogik på den aggregerade tabellen datauppsättning och för att lagra utdata i tabellen ComputedESGMetrics i ComputedESGMetrics_LH sjöhus.
Du kan ange dessa parametrar för att generera utdata för en specifik uppsättning mått. Om du vill generera utdata för alla måttdefinitioner som läses in i tabellen MetricsDefinitions ska du inte ange något parametervärde i pipelinen och ange det som Ingen i notebook-filen.
Obs
Parametervärdena är skiftlägeskänsliga.
metric_names: Ange en lista med måttnamn. Du kan hämta måttnamnet från det fördefinierade måttbiblioteket eller fråga tabellen MetricsDefinitions i ComputedESGMetrics_LH sjöhus. Till exempel ["Scope 3 GHG-utsläpp per kategori (GHG-protokollet)","Total vattenförbrukning"].
sustainability_areas: Ange en lista över hållbarhetsområden. Till exempel ["Klimatförändringar","Vatten och marina resurser"]. Alla mätvärden som mappas till det hållbarhetsområde som anges i parametern beaktas vid beräkningen. Du kan hitta hållbarhetsområdet som är mappat till måttet från det fördefinierade måttbiblioteket eller fråga tabellen MetricsDefinitions i ComputedESGMetrics_LH sjöhus.
Obs
Om du anger både sustainability_areas och metric_names får den metric_names parametern prioritet och beaktas för beräkning.
När notebook-filen eller pipelineaktiviteten har körts kan du kontrollera måttutdata i tabellen ComputedESGMetrics i ComputedESGMetrics_LH sjöhus. ComputedESGMetrics är en enda tabell som lagrar utdata för alla mätvärden. I den här tabellen visas schemainformationen för tabellen.
Kolumnnamn Description MetricId (på engelska) Den unika identifieraren för mätvärdet. Anger den måttenhet som data genereras för. Det är en sekundärnyckel till tabellen MetricsDefinitions . ReportingPeriod Anger den rapporteringsperiod (år) för vilken måttenhetsvärdet genereras. UnitOfMeasureName (på engelska) Representerar måttenheten för det metriska värdet (t.ex. mtCO2e för utsläppsvärden). Värde Anger mätvärdets värde för den specifika ReportingPeriod och DimensionValue. DimensionName (på engelska) Om mätvärdets utdata har en annan dimension än ReportingPeriod anges det här dimensionsnamnet i kolumnen DimensionName . Motsvarande värde finns i DimensionValue och datatypen finns i DimensionType. DimensionVärde Innehåller det specifika värdet för dimensionen som anges i kolumnen DimensionName . DimensionTyp Anger datatypen för dimensionen i DimensionName. Index Index och MetricId identifierar unikt en viss rad i ett mått. Den här kolumnen är användbar när du hämtar en specifik metrisk utdata med dimensioner som separata kolumner från den här enskilda måttenhetsutdatatabellen. Om du vill lagra varje måttenhets data som en separat dataram eller tabell kan du använda funktionen get_metric_output_by_id för att hämta måttenhetens utdata ram.