カスタム メトリックの作成
重要
この機能の一部またはすべては、プレビュー リリースの一部として利用できます。 コンテンツおよび機能は変更される場合があります。
事前構築されたメトリックに使用されるのと同じパターンに従うことで、カスタム メトリックを定義および計算する機能を拡張できます。
集計テーブルの生成
計算するメトリックに基づいて、次のいずれかのシナリオが適用可能です。 追従する あなたに当てはまるシナリオの手順。
シナリオ 1
事前に構築された集計テーブルは、必要なディメンション セットで必要な測定データをサポートしているため、集計テーブルに変更を加える必要はありません。
DatasetForMetricsMeasures_DTST セマンティック モデルを更新します。
シナリオ 2
事前構築された集計テーブルは必要な測定データをサポートしていますが、必要なディメンションがありません。
集計テーブルの計算ロジックを含むノートブック内の計算ロジックを更新して、事前構築された集計テーブルに必要なディメンションを追加します。 たとえば、EmissionsAggregateテーブルの計算ロジックを更新する必要がある場合は、 CreateAggregateForEmissionsMetrics_INTBのロジックを更新します。
更新された計算ロジックを使用してノートブックを実行し、集計テーブルを生成します。
ヒント
事前構築されたメトリックの計算に影響を与えないようにするため、事前構築された集計から既存のディメンションを削除しないでください。
DatasetForMetricsMeasures_DTST セマンティック モデルの集計テーブルを更新します。
ワークスペース ページから DatasetForMetricsMeasures_DTST セマンティック モデルをダウンロードし、 Power BI Desktop でモデルを開きます。
Power BI Desktopで、更新された集計テーブルを右クリックし、選択 [クエリの編集] をクリックして Power Query エディターを開きます。
Power Query エディターで、リボンの [詳細エディター] を選択して詳細エディターを開きます。
クエリ コードを更新して、列が参照されるすべてのステップに新しい列を含め、新しい列の必要に応じてエラー処理を調整します。 完了を選択します。
更新されたデータを表示するには、選択 Refreshプレビュー にアクセスしてください。 確認後、選択 閉じる & Apply をクリックして、変更をデータ モデルに適用します。
追加されたメジャーとスキーマの変更を含む更新された Power BI ファイルを保存します。 更新されたセマンティック モデルをサービス内のターゲット ワークスペースに公開し、ワークスペース内の以前のバージョンを上書きします。 Power BI
シナリオ 3
事前に構築された集計テーブルは、必要な測定データをサポートしていません。
ノートブックで計算ロジック (事前構築された集計テーブルに使用されるものと同様のパターンを使用) を定義して、カスタム集計テーブルを作成します。
ノートブックを実行して、 computedESGMetrics_LH レイクハウス に集計テーブルを生成します。
カスタム集計テーブルを DatasetForMetricsMeasures_DTSTに追加します。
ワークスペース ページからセマンティック モデルをダウンロードし、 Power BI Desktop でモデルを開きます。
Power BI Desktopでは、選択 OneLakeデータ ハブ、選択 レイクハウス、そしてポップアップ 選択 で ComputedESGMetrics レイクハウス です。 接続 ボタンのドロップダウン矢印を選択し、次に選択 接続 してSQLエンドポイント にします。
選択 セマンティック モデルにインポートするカスタム集計テーブル。 選択 ロード してテーブルを取り込み Power BI Desktopます。
ウィンドウのプロンプトで、 接続設定 を インポート モード に設定して、データをモデルに取り込み、選択 OK を実行します。
テーブルが データ ペインに読み込まれたら、新しく追加されたテーブルを右クリックし、選択 クエリの編集 をクリックして Power Query エディターを開きます。
クエリ エディター ペインで詳細エディターを開き、クエリ コードを確認します。 予期しないデータの問題を管理するために、必要なエラー処理コードを追加します。
デフォルトでは、このコードはクエリ エディター ペインに表示されます。
let Source = Sql.Database("x6eps4xrq2xudenlfv6naeo3i4-lzqqwvhquhb2e7afwzp3ge4.msit-datawarehouse.fabric.microsoft.com", "SDS_ESGDE_ems_ComputedESGMetrics_LH"), <Table Name>= Source{[Schema="dbo",Item="<Table Name from the Lakehouse>"]}[Data] in <Table Name>このクエリを次のコードに置き換え、カスタム集計テーブルに存在するテーブルと列に基づいて必要な変更を加えます。
let Source = Sql.Database("x6eps4xrq2xudenlfv6naeo3i4-lzqqwvhquhb2e7afwzp3ge4.msit-datawarehouse.fabric.microsoft.com", "SDS_ESGDE_ems_ComputedESGMetrics_LH"), dbo_EmissionsAggregate = try Source{[Schema="dbo",Item="EmissionsAggregate"]}[Data] otherwise #table( type table [ #"ReportingPeriod"=number, #"PartyId"=number, #"PartyTypeName"=text, #"PartyName"=text, #"SecondaryPartyId"=number, #"SecondaryPartyTypeName"=text, #"SecondaryPartyName"=text, #"EmissionSource"=text, #"isRolledUp"=logical, #"CO2eEmissionUnits"=number, #"UnitOfMeasureName"=text ], {}) in dbo_EmissionsAggregate変更を保存するには、選択 完了 を実行します。
変更を適用するには、エディターで 選択 閉じる & Apply をクリックします。 Power Query
モデル ビューで、必要に応じて新しく追加されたテーブルの間に リレーションシップ を追加します。
更新された Power BI Desktop ファイルを保存します。 Power BI サービスで [ファイル] > [公開] > [公開先] Power BI を選択し、対象のワークスペースを選択して、モデルをワークスペースに公開します。 このアクションは、モデルのIDを変更せずに、ワークスペース内の既存のセマンティック モデルを上書きします。
カスタムメトリックを計算するための別の Power BI メジャーを作成します
「 メトリック データの計算と保存」で説明したように、ESGメトリックの計算は、 Power BI メジャー、フィルター、ディメンションの観点から指定されます。
事前に構築されたメジャーのリストを確認し、カスタム メトリックの計算に既存のメジャーを再利用できるかどうかを確認できます。 既存のメジャーを再利用できる場合は、これをスキップできます 手順。
既存のメジャーを使用できない場合は、 Power BI DatasetForMetricsMeasures_DTST に別のメジャーを作成します。
選択 は、ワークスペース リスト ビューから DatasetForMetricsMeasures_DTST セマンティック モデル項目を取得します。
選択 セマンティック モデル ページから データ モデルを開きます 。
ヒント
[データ モデルを開く] がグレー表示されている場合は、ワークスペース設定に移動します。 Power BI/[一般] を開き、 サービス (プレビュー) 設定で Power BI ユーザーはデータ モデルを編集できる をオンにします。
データ サイド パネルから 選択 ESG_Measures を選択し、次に 選択 新しいメジャー を選択してメジャーを作成します。
メジャー名を更新し、データ分析式 (DAX) クエリの形式で計算ロジックを追加します。 メジャーの詳細については、ドキュメントの「データ分析用のメジャーを作成する」を参照してください。 Power BI Power BI Desktop Power BI
メトリック定義を作成する
メトリック定義は、 create_metric_definition() 事前構築されたユーティリティ関数を使用して作成できます。 この関数の詳細については、 create_metric_definition を参照してください。
関数パラメータで、 メトリック プロパティ をJSONファイルとして指定します。 たとえば、水リスクが高い地域や極めて高い地域の施設について、施設別の水消費量を計算したい場合があります。 事前に構築されたメトリックは、水リスクエリアの全体的な水消費量のみを提供しますが、施設ごとの内訳は提供しません。 次のコード スニペット を使用して、 水リスクのある地域の施設別総水消費量 のカスタム メトリック定義を作成できます。
%run SDS_ESGM_SDS_UtilitiesForMetrics_INTB
metrics_manager = MetricsManager()
metrics_manager.create_metric_definition(
{
"metric_name": "Total water consumption in areas at water risk facility wise",
"measure_name": "WaterConsumption",
"dimensions": [
"WaterUtilizationAggregate[ReportingPeriod]",
"WaterUtilizationAggregate[UnitOfMeasureName]",
"WaterUtilizationAggregate[PartyName]",
"WaterUtilizationAggregate[PartyTypeName]"
],
"filters": {
"WaterUtilizationAggregate[isRolledUp]": [
"False"
],
"WaterUtilizationAggregate[WaterRiskIndexName]": [
"Extremely High",
"High"
],
"WaterUtilizationAggregate[UnitOfMeasureName]": [
"Cubic metres"
]
},
"sustainability_area": "Water and marine resources",
"labels": {
"Reporting standard": [
"CSRD"
],
"Disclosure datapoint": [
"E3-4_02"
]
}
})
関数が正常に実行されると、メトリック定義が ComputedESGMetrics_LH レイクハウス の MetricsDefinitions テーブルに行として追加されます。
ヒント
各メトリックのメトリック名は一意である必要があります。 MetricsDefinitions テーブル内の既存のメトリックの名前と一致する名前でカスタム メトリックを作成すると、関数はエラーになります。
メトリック定義JSONファイルでは、カスタム メトリックにフィルター プロパティとラベル プロパティが必要ない場合は、指定をスキップできます。
メトリック データの生成と保存
メトリック データを生成および保存するには、事前構築済みメトリックに指定されているのと同じ手順を使用します。 前の 手順 で作成したカスタム メトリック名を metric_names パラメータに指定します。
メトリック データの使用
カスタム メトリック データが ComputedESGMetrics テーブルで使用可能な場合は、次のシナリオでデータを使用できます。
カスタムメトリックデータを視覚化して分析する
「メトリック データを視覚化および分析する」の手順に従って、事前に構築されたダッシュボードでカスタム メトリック データを視覚化および分析できます Power BI 。 ...
カスタム メトリックにレポート期間と測定単位名以外の追加のディメンションがある場合、事前構築されたダッシュボードは、他の1つのディメンションをスライサーとして、他の2つのディメンションをマルチライン フィルターとして視覚化できます。
translate_metrics_output_for_report_config.json ファイルで、スライサーと複数行フィルターで考慮されるメトリック テーブルのディメンションを指定できます。
たとえば、次の列を含むカスタム メトリックとして、 「GHG排出量の国別分解」 を作成します。
- 価値
- Country
- 範囲
- 会計算出方法
- 報告期間
- 測定単位名
事前に構築されたダッシュボードでこのメトリックを視覚化するには、次のように構成でデータを指定します。
{ "metric_name": "Disaggregation of GHG emissions - by country", "dimensions_for_multiple_lines": [ "Scope", "AccountingMethod" ], "dimension_for_slicer": "CountryOrRegion" }この スニペット は、ダッシュボードにスライサーとして CountryOrRegion ディメンションを追加します。 Scope および AccountingMethod ディメンションはアンダースコア (_) で連結され、ダッシュボードに基本フィルター (または複数行フィルター) として追加されます。
構成が更新されたら、ここで指定されているのと同じ手順を実行して、事前構築されたメトリックのデータを視覚化できます。 TranslateOutputOfMetricsForReport_INTB ノートブック。
DatasetForMetricsDashboard_DTST セマンティック モデルを更新します。
DashboardForMetrics_RPT 項目を開きます。 メトリックにマッピングされた持続可能性領域に基づいて、4つのタブのいずれかにカスタム メトリックが表示されます。
ヒント
持続可能性領域が、 気候変動、 社会、 ガバナンス、 水資源と海洋資源、または 資源利用と循環型経済以外の値として指定されている場合は、事前に構築された Power BI レポートをカスタマイズする必要があります。
コンプライアンス マネージャーで監査メトリック データを公開する
カスタム メトリックの場合は、次の詳細を含むカスタム メトリックのオブジェクトを追加して、 translate_metrics_output_for_CM_config.json を更新します。
metricName: メトリックの名前。
metricExtractDataPath: メトリックの変換されたJSONファイルを含む、 ComputedESGMetrics_LHレイクハウス の ReportingData/ year フォルダーに作成するメトリック フォルダーの名前。
ヒント
metricExtractDataPathでは特殊文字またはスペースはサポートされていません。
開示要件: CSRDテンプレート コンプライアンス マネージャーの開示要件 (改善アクション) の名前。 コンプライアンス マネージャーは、この値を読み取り、コンプライアンス マネージャーCSRD評価でメトリック データを適切な改善アクションにマッピングできます。
列: 各メトリック列の列 表示名。下流のアプリケーションのメトリック データのユーザー フレンドリな列名が表示されます。
構成が更新されたら、次のパラメータを使用して TranslateOutputOfMetricsForCM_INTB ノートブックを実行します。
metric_names: 生成されたカスタム メトリックの名前。
reporting_period: メトリック データのレポート年。
num_previous_years: reporting_period データとともに送信する必要がある比較年データの数。
ノートブックの実行後、JSONファイルとしてのメトリック データは、 ComputedESGMetrics.json のファイル セクションの ReportingData フォルダーで使用できるようになります。 Sustainabilityデータ コネクタを使用して、コンプライアンス マネージャーに公開されたメトリック データを取り込むことができるようになりました。
