Поделиться через


Анализ данных о выбросах

Внимание!

Некоторые или все функции доступны в рамках предварительного выпуска. Содержимое и функциональность могут быть изменены.

Вы можете использовать два метода для доступа к данным о выбросах с помощью возможности анализа выбросов Azure в решениях по данным об устойчивом развитии в Microsoft Fabric:

Доступ к данным по выбросам через SQL

Вы можете получить доступ к агрегированным данным в ComputedESGMetrics хранилище и озеро данных через SQL конечная точка, доступный в AnalyzeAzureEmissionsDataset , выполнив следующие действия:

  1. На домашней странице возможностей Azure emission insights выберите семантическую модель AnalyzeAzureEmissionsDataset .

  2. Перейдите к конечной точке ComputedESGMetrics SQL.

    Скриншот конечной точки ComputedESGMetrics SQL.

  3. Вы можете использовать Копировать строку подключения SQL для внешнего использования набор данных с совместимыми клиентскими инструментами SQL, такими как Azure Data Studio и SQL Server Management Studio (SSMS).

    Скриншот строки подключения «Копировать SQL».

Доступ к данным о выбросах через API

  1. Создайте идентификатор приложения в вашем Microsoft Entra клиенте идентификатора и создайте новый секрет клиента для идентификатора приложения.

    Для этого варианта использования зарегистрируйте приложение с типом учетной записи Учетные записи только в этом организационном каталоге. Пропустите URI перенаправления, поскольку в данном случае он не требуется. Вы также можете пропустить шаги Настройка параметров платформы , поскольку они не требуются для этого сценария.

  2. Настройте параметры арендатора на уровне администратора. Убедитесь, что у вас есть одна из ролей администратора, как определено в разделе Понимание Microsoft Fabric ролей администратора в Microsoft Fabric документации. При необходимости обратитесь к своему Microsoft Fabric администратору арендатора, чтобы выполнить следующие шаги:

    1. Откройте рабочую область в Fabric, в которой вы развернули решения по обработке данных об устойчивом развитии.

    2. Выберите значок Настройки в правом верхнем углу, чтобы открыть боковую панель настроек, а затем выберите Портал администратора.

    3. В разделе Настройки клиента перейдите в Настройки разработчика и включите разрешение Субъекты службы могут использовать API Fabric для всей организации или для определенной группы безопасности.

    4. Убедитесь, что созданное вами ранее удостоверение приложения входит в группу безопасности.

      Скриншот группы безопасности.

  3. Назначьте разрешения для идентификатора приложения:

    1. Перейдите в представление рабочей области и выберите опцию Управление доступом , чтобы управлять ролями на уровне рабочей области.

    2. Нажмите кнопку Добавить людей или группы , чтобы добавить идентификатор приложения с одной из следующих ролей: Участник, участник или Администратор. Этот шаг является обязательным, поскольку доступ к данным осуществляется с помощью внутреннего ярлыка OneLake.

    Скриншот экрана добавления людей.

  4. Вызов API REST:

    Заметка

    Вы можете интегрировать эти вызовы REST API в любое клиентское HTTP-приложение.

    1. Получите маркер доступа для настроенного идентификатора приложения. Обратитесь к разделу Получение токенов для вызова веб-API с помощью демон-приложения в Microsoft Entra документации по идентификаторам, чтобы получить токен для идентификатора приложения с использованием клиентских учетных данных OAuth рабочего процесса 2.0. Параметр области действия в запросе токена должен быть "https://storage.azure.com/.default".

    2. Перечислите файлы разделов данных, присутствующие в IngestedRawData хранилище и озеро данных, используя следующий вызов API.

      • workspaceId: уникальный идентификатор Microsoft Fabric рабочей области. Например, это первый GUID в URL-адресе, когда IngestedRawData хранилище и озеро данных открывается в Microsoft Fabric.

      • lakehouseId: уникальный идентификатор хранилище и озеро данных, имеющий импортированные данные о выбросах Azure. Здесь представлен идентификатор принятых необработанных данных хранилище и озеро данных. Например, это второй GUID в URL-адресе, когда IngestedRawData хранилище и озеро данных открывается в Microsoft Fabric.

      • enrollmentNumber: Идентификатор регистрации для выставления счетов, данные которого необходимо считать. Передаваемый здесь идентификатор регистрации для выставления счетов совпадает с одним из имен папок, доступных по пути «Files/AzureEmissions» в IngestedRawData хранилище и озеро данных.

      Запрос:

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

      Ответ:

      Возвращает список свойств файла. Это файлы разделов данных, в которых хранятся данные о выбросах для указанного номера регистрации.

    3. Извлечь содержимое определенного файла раздела данных.

      • workspaceId: уникальный идентификатор Microsoft Fabric рабочей области.

      • emissionPartitionFilePath: Относительный путь к одному из файлов раздела, извлеченных из предыдущего вызова 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 и сохранения его на стороне приложения.

Следующий шаг