排出量データの分析
重要
この機能の一部またはすべては、プレビュー リリースの一部として利用できます。 コンテンツおよび機能は変更される場合があります。
Microsoft Fabricのサステナビリティ データ ソリューションのAzure排出量分析機能を使用して排出量データにアクセスするには、次の2つの方法を使用できます。
SQLを通じて排出データにアクセスします
以下の手順で、 AnalyzeAzureEmissionsDataset で利用可能なSQLエンドポイント を介して、 ComputedESGMetrics レイクハウス の集計データにアクセスできます。
Azure排出量分析情報 機能のホームページで、 AnalyzeAzureEmissionsDataset セマンティック モデルを 選択 します。
ComputedESGMetrics SQL endポイントする に移動します。
「SQL接続文字列をコピー」 を使用すると、Azure Data StudioやSQL Server Management Studio (SSMS) などの互換性のあるSQLクライアント ツールを使用して、データセット を外部で使用できます。
APIを通じて排出データにアクセスする
Microsoft Entra IDテナント にアプリIDを作成し、 アプリIDの新しいクライアント シークレットを作成します。
このユースケースでは、 この組織ディレクトリ内のアカウントのみのアカウント タイプでアプリケーションを登録します。 この場合はリダイレクトURIは必要ないのでスキップします。 このシナリオでは必要ないため、 プラットフォーム設定の構成 の手順をスキップすることもできます。
管理者レベルのテナント設定を構成します。 「管理者ロールを理解する Microsoft Fabric 」 ドキュメント Microsoft Fabric で定義されている管理者ロールのいずれかを持っていることを確認します。 必要に応じて、テナント管理者に問い合わせて次の手順を完了してください。 Microsoft Fabric
Sustainabilityデータ ソリューションをデプロイしたFabricのワークスペースを開きます。
選択 右上隅の 設定 アイコンをクリックして設定サイドパネルを開き、選択 管理ポータルを開きます。
テナント設定 セクションで、 開発者設定 に移動し、組織全体または特定のセキュリティ グループに対して サービス プリンシパルがFabric APIを使用できる 権限を有効にします。
先ほど作成したアプリIDがセキュリティ グループのメンバーであることを確認します。
アプリIDに権限を割り当てます。
ワークスペース ビューに移動し、 アクセスの管理 オプションを 選択 して、ワークスペース レベルでロールを管理します。
選択 は、 ユーザーまたはグループの追加 ボタンをクリックし、次のいずれかのロールを持つアプリIDを追加します: メンバー、 投稿者、または 管理者。アクセスされたデータはOneLakeの内部ショートカットであるため、この 手順 は必須です。
REST APIを呼び出します。
ヒント
これらのREST API呼び出しは、任意のHTTPクライアント アプリケーションに統合できます。
構成されたアプリIDの アクセス トークン を取得します。 クライアント資格情報を使用してアプリIDのトークンを取得するには、IDドキュメントの「2.0ワークフロー」の「デーモン アプリケーションを使用してWeb APIを呼び出すためのトークンを取得する」 「トークンを取得する」 を参照してください。 Microsoft Entra OAuth トークン要求では、スコープ パラメータは "https://storage.azure.com/.default" である必要があります。
次のAPI呼び出しを使用して、IngestedRawDataレイクハウス に存在するデータ パーティション ファイルを一覧表示します。
ワークスペースID: ワークスペースの一意の識別子。 Microsoft Fabric たとえば、IngestedRawDataレイクハウス が Microsoft Fabric で開かれるとき、これはURLの最初のGUIDになります。
lakehouseId: インポートされたAzure排出データを持つ レイクハウス の一意の識別子。 ここで、取り込まれた生データ レイクハウスID。 たとえば、IngestedRawDataレイクハウス が開かれるときのURLの2番目のGUIDです Microsoft Fabric。
登録番号: データを読み取る必要がある課金登録ID。 ここで渡される課金登録IDは、IngestedRawDataレイクハウス の "Files/AzureEmissions" のパスで使用可能なフォルダー名の1つと同じです。
リクエスト：
HTTP GET https://onelake.dfs.fabric.microsoft.com/<workspaceId>?recursive=false&resource=filesystem&directory=<lakehouseId>%2FFiles%2FAzureEmissions%2F<enrollmentNumber>応答:
ファイルプロパティのリストを返します。 これらは、指定された登録番号の排出データを格納するデータ パーティション ファイルです。
特定のデータ パーティション ファイルの内容を取得します。
ワークスペースID: ワークスペースの一意の識別子。 Microsoft Fabric
emittingPartitionFilePath: 以前のAPI呼び出しから取得されたパーティション ファイルの1つの相対パス。 たとえば、次のように視覚化できます。
<lakehouseId>/Files/AzureEmissions/<enrollmentNumber>/<emissionsPartitionFileName>.parquet
リクエスト：
HTTP GET https://onelake.dfs.fabric.microsoft.com/<workspaceId>/<emissionsPartitionFilePath>応答:
排出データ パーティション ファイルの内容。 ここで、APIはParquetファイルを読み取っているため、応答 本体は適切なParquetライブラリまたはツールを通じて解析する必要があります。 たとえば、APIを使用して排出データを読み取る .NETアプリケーションを使用している場合は、C# Parquetライブラリの1つを使用してParquetコンテンツをデコードし、アプリケーション側に保存できます。
