次の方法で共有


排出量データの分析

重要

この機能の一部またはすべては、プレビュー リリースの一部として利用できます。 コンテンツおよび機能は変更される場合があります。

Microsoft Fabric の持続可能性データ ソリューションの Azure 排出量分析情報機能で排出データにアクセスするには、次の 2 つの方法を使用できます

SQL を使用して排出データにアクセスする

AnalyzeAzureEmissionsDataset で使用可能な SQL エンドポイントを使用して ComputedESGMetrics レイクハウスの集計データにアクセスするには、次の手順に従います。

  1. Azure 排出量分析情報 機能のホーム ページで、AnalyzeAzureEmissionsDataset セマンティック モデルを選択します。

  2. ComputedESGMetrics SQL エンドポイント に移動します。

    ComputedESGMetrics SQL エンドポイントのスクリーンショット。

  3. SQL 接続文字列のコピー を使用すると、Azure Data Studio や SQL Server Management Studio (SSMS) などの互換性のある SQL クライアント ツールを利用してデータセットを外部で使用できます。

    SQL 接続文字列のコピーのスクリーンショット。

API を使用して排出データにアクセスする

  1. Microsoft Entra ID テナントでアプリ ID を作成 し、アプリ ID の新しいクライアント シークレットを作成 します。

    このユース ケースでは、この組織ディレクトリ内のアカウントのみ のアカウント タイプでアプリケーションを登録します。 リダイレクト URI は、このケースでは必須ではないため、スキップします。 プラットフォーム設定の構成 の手順は、このシナリオでは必要ないため、スキップすることもできます。

  2. 管理者レベルのテナント設定を構成します。 Microsoft Fabric ドキュメントの Microsoft Fabric 管理者ロールを理解する に定義されている管理者ロールを 1 つを持っていることを確認します。 必要に応じて Microsoft Fabric テナント管理者に問い合わせて、次の手順を完了します。

    1. 持続可能性データ ソリューションを展開した Fabric でワークスペースを開きます。

    2. ページの右上隅の 設定 を選択して、設定サイド パネルを開き、管理ポータル を選択します。

    3. テナント設定 セクションで、開発者設定 に移動し サービス プリンシパルは Fabric API を使用できます のアクセス許可を組織全体または特定のセキュリティ グループに対して有効にします。

    4. 前に作成したアプリ ID がセキュリティ グループのメンバーであることを確認します。

      セキュリティ グループのスクリーンショット。

  3. アプリ ID にアクセス許可を割り当てます:

    1. ワークスペース ビューに移動し、アクセスを管理 オプションを選択して、ワークスペース レベルでロールを管理します。

    2. ユーザーまたはグループの追加 ボタンを選択して、メンバー共同作成者、または 管理者 のいずれかのロールを持つアプリ ID を追加します。アクセスされるデータは OneLake 内部ショートカットであるため、この手順は必須です。

    ユーザーの追加画面のスクリーンショット。

  4. REST API を呼び出します:

    注意

    これらの REST API 呼び出しは、任意の HTTP クライアント アプリケーションに統合できます。

    1. 構成されたアプリ ID のアクセス トークンをフェッチします。 OAuth 2.0 クライアント資格情報ワークフローを使用してアプリ ID のトークンをフェッチするには、Microsoft Entra ID ドキュメントの デーモン アプリケーションを使用して Web API を呼び出すためのトークンを取得する を参照してください。 トークン要求でのスコープ パラメーター は "https://storage.azure.com/.default" です。

    2. 次の API 呼び出しを使用して、IngestedRawData レイクハウス に存在するデータ パーティション ファイルを一覧表示します。

      • workspaceId: Microsoft Fabric ワークスペースの一意識別子。 たとえば、IngestedRawData レイクハウスを Microsoft Fabric で開いている場合の URL の最初の GUID です。

      • lakehouseId: インポートされた Azure 排出データを持つレイクハウスの一意の識別子。 ここでは、取り込まれた生データ レイクハウス ID です。 たとえば、IngestedRawData レイクハウスを Microsoft Fabric で開いている場合の URL の 2 つ目の GUID です。

      • enrollmentNumber: データを読み取る必要がある請求先登録 ID。 ここで渡される請求先登録 ID は、IngestedRawData レイクハウスの "Files/AzureEmissions" のパスで使用可能なフォルダー名のいずれかと同じです。

      要求:

      HTTP GET https://onelake.dfs.fabric.microsoft.com/<workspaceId>?recursive=false&resource=filesystem&directory=<lakehouseId>%2FFiles%2FAzureEmissions%2F<enrollmentNumber> 
      

      応答:

      ファイルのプロパティの一覧を返します。 これらは、指定された登録番号の排出データを格納するデータ パーティション ファイルです。

    3. 特定のデータ パーティション ファイルの内容をフェッチします。

      • workspaceId: Microsoft Fabric ワークスペースの一意識別子。

      • emissionsPartitionFilePath: 前の API 呼び出しからフェッチされたパーティション ファイルのいずれかの相対パス。 たとえば、これは次のように視覚化できます。

        <lakehouseId>/Files/AzureEmissions/<enrollmentNumber>/<emissionsPartitionFileName>.parquet 
        

      要求:

      HTTP GET https://onelake.dfs.fabric.microsoft.com/<workspaceId>/<emissionsPartitionFilePath> 
      

      応答:

      排出データ パーティション ファイルの内容。 ここでは、API が Parquet ファイルを読み取っているため、適切な Parquet ライブラリまたはツールを使用して応答本文を解析する必要があります。 たとえば、.NET アプリケーションを使用していて、API を使用して排出データを読み取る場合は、C# Parquet ライブラリのいずれかを使用して Parquet コンテンツをデコードし、アプリケーション側に格納できます。

次のステップ