Generowanie i przechowywanie danych metryk
Ważne
Niektóre lub wszystkie te funkcje są dostępne w wersji zapoznawczej. Zawartość i funkcjonalność mogą ulec zmianie.
Po wygenerowaniu tabeli agregacji można uruchomić logikę obliczeń (agregację lub obliczenie) zdefiniowaną w definicji metryki na podstawie zestawu danych tabeli agregacji w celu wygenerowania danych wyjściowych metryki.
Logika obliczeniowa metryki jest definiowana za pomocą:
Power BI miary: zawiera logikę obliczeniową w postaci języka formuł języka DAX (Data Analysis Expressions). Power BI Miary są definiowane w DatasetForMetricsMeasures_DTST wstępnie utworzonym modelu semantycznym wdrożonym w ramach funkcji. Aby dowiedzieć się więcej na temat Power BI miar, przejdź do tematu Tworzenie miar do analizy danych w Power BI Desktop Power BI dokumentacji.
Wymiary: określa wymiary/kolumny wymagane w danych wyjściowych metryki. Te wymiary mogą pochodzić z tabel zagregowanych lub tabel obliczeniowych w modelu semantycznym DatasetForMetricsMeasures_DTST .
Filtry: określa wartości z zagregowanych wymiarów tabeli, które muszą być filtrowane.
Przykładowa wstępnie utworzona metryka emisji kategorii Zakres 3 (protokół GHG).
Poniżej znajduje się definicja metryki tej metryki z pliku 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"
]
}
}
Na podstawie definicji metryki dane wyjściowe metryki składają się z:
- Kolumny określone jako wymiary w definicji danych
- Kolumna wartości, która jest obliczana przez uruchomienie logiki obliczeniowej określonej w definicji metryki
W przypadku przykładowej metryki te kolumny wyjściowe to:
- EmissionSource: przechwytuje nazwę kategorii zakresu 3.
- Nazwa jednostki miary: Określa jednostkę miary wartości emisji, np. mtCO2e.
- Okres raportowania: Określa rok sprawozdawczy.
- Wartość: Przechwytuje wartość emisji dla kategorii zakresu 3 dla określonego okresu raportowania.
W przypadku tej metryki należy obliczyć sumę jednostek CO2eEmissionsUnits , w których zakres to zakres 3 , a metoda rozliczania ma wartość null lub lokalizacja oparta na źródle emisji i okresie raportowania z tabeli EmissionsAggregate.
To obliczenie jest wykonywane w następujący sposób przez logikę obliczeniową określoną w definicji metryki:
Miara Emissions wykonuje sumę CO2eEmissions z tabeli EmissionsAggregate i jest zdefiniowana w DatasetForMetricsMeasures_DTST modelu semantycznym:
Aby wyświetlić wstępnie utworzone Power BI miary, które są używane do obliczania wstępnie utworzonych metryk, wykonaj następujące kroki:
- Otwórz DatasetForMetricsMeasures_DTST z obszaru roboczego.
- Wybierz Otwórz model danych.
- Wybierz opcję ESG_measures w panelu bocznym Dane .
Jeśli opcja Otwórz model danych jest wyszarzona, przejdź do ustawień przestrzeni roboczej. Otwórz Power BI/Ogólne i włącz ustawienie Użytkownicy mogą edytować modele danych w Power BI usłudze (wersja zapoznawcza).
Miara Wymiary wykonuje agregację w wymiarach określonych w kolumnach definicji metryki (okres raportowania), źródła emisji i jednostki miary w tabeli zagregowanej. Te kolumny z wymiarów danych wyjściowych metryki.
Filtry określa wymagane wartości dla różnych kolumn tabeli EmissionsAggregate do zsumowania przez miarę. W tym przykładzie wiersze, w których zakres to zakres 3, metoda księgowania to wartość null lub oparta na lokalizacji, a jednostką miary jest mtCO2e.
Aby obliczyć dane metryk z Power BI miarami, wymiarami i filtrami, wstępnie utworzony notes używa funkcji evaluate_measure interfejsu języka Python biblioteki języka Python semantycznej połączyć SemPy.
Wymagania wstępne dotyczące generowania danych metryk
- Tabela agregacji wymagana do wygenerowania metryki powinna już znajdować się w ComputedESGMetrics_LH magazyn lakehouse.
- Przed uruchomieniem logiki obliczeniowej dla metryki upewnij się, że definicje metryk są ładowane jako tabele w ComputedESGMetrics magazyn lakehouse. Jeśli nie zaktualizujesz definicji metryki, nie musisz ponownie ładować definicji. Uruchom bezpośrednio notes Załaduj definicję metryki lub uruchom działanie Załaduj definicję metryki potoku ExecuteComputationForMetrics .
Generowanie i przechowywanie danych metryk
Uruchom działanie Generuj dane wyjściowe dla metryk w potoku ExecuteComputationOfMetrics_DTPL lub bezpośrednio uruchom notes GenerateOutputForMetrics_INTB , aby uruchomić logikę obliczeń metryk na zestaw danych tabeli agregacji i zapisać dane wyjściowe w tabeli ComputedESGMetrics w ComputedESGMetrics_LH magazyn lakehouse.
Możesz określić te parametry, aby wygenerować dane wyjściowe dla określonego zestawu metryk. Jeśli chcesz wygenerować dane wyjściowe dla wszystkich definicji metryk załadowanych w tabeli MetricsDefinitions , nie określaj wartości parametru w potoku i ustaw ją jako Brak w notesie.
Notatka
W wartościach parametrów jest rozróżniana wielkość liter.
metric_names: Określ listę nazw metryk. Nazwę metryk można pobrać ze wstępnie utworzonej biblioteki metryk lub wykonać zapytanie dotyczące tabeli MetricsDefinitions w pliku ComputedESGMetrics_LH magazyn lakehouse. Na przykład ["Emisje gazów cieplarnianych z zakresu 3 według kategorii (protokół GHG)","Całkowite zużycie wody"].
sustainability_areas: Określ listę obszarów zrównoważonego rozwoju. Na przykład ["Zmiany klimatu","Zasoby wodne i morskie"]. Wszystkie metryki zmapowane do obszaru zrównoważonego rozwoju określonego w parametrze są brane pod uwagę przy obliczaniu. Obszar zrównoważonego rozwoju, który jest mapowany na metrykę, można znaleźć w bibliotece wstępnie utworzonych metryk lub wykonać zapytanie dotyczące tabeli MetricsDefinitions w ComputedESGMetrics_LH magazyn lakehouse.
Notatka
Jeśli określisz zarówno sustainability_areas , jak i metric_names, parametr metric_names ma priorytet i jest brany pod uwagę przy obliczeniach.
Po pomyślnym uruchomieniu notesu lub działania potoku możesz sprawdzić dane wyjściowe metryk w tabeli ComputedESGMetrics w ComputedESGMetrics_LH magazyn lakehouse. ComputedESGMetrics to pojedyncza tabela, w której przechowywane są dane wyjściowe dla wszystkich wskaźników. W tej tabeli przedstawiono szczegóły schematu tabeli.
Nazwa kolumny Podpis Identyfikator metryczny Unikatowy identyfikator metryki. Oznacza metrykę, dla której są generowane dane. Jest to klucz obcy do tabeli MetricsDefinitions . ReportingPeriod Oznacza okres raportowania (rok), dla którego jest generowana wartość metryki. UnitOfMeasureName (NazwaJednostkiMiary) Reprezentuje jednostkę miary dla wartości metryki (np. mtCO2e dla wartości emisji). Wartość Oznacza wartość metryki dla określonego okresu raportowania i wartości wymiaru. NazwaWymiaru Jeśli dane wyjściowe metryki mają inny wymiar oprócz ReportingPeriod, ta nazwa wymiaru jest określona w kolumnie DimensionName . Odpowiednia wartość to DimensionValue, a typ danych to DimensionType. Wartość wymiaru Zawiera określoną wartość wymiaru określonego w kolumnie NazwaWymiaru . Typ wymiaru Określa typ danych wymiaru w polu NazwaWymiaru. Index Index i MetricId jednoznacznie identyfikują określony wiersz metryki. Ta kolumna jest przydatna podczas pobierania określonych danych wyjściowych metryki z wymiarami jako oddzielnymi kolumnami z tej pojedynczej tabeli danych wyjściowych metryki. Jeśli chcesz przechowywać dane każdej metryki jako oddzielną ramkę danych lub tabelę, możesz użyć funkcji get_metric_output_by_id , aby uzyskać ramkę danych wyjściowych metryki.