Анализ данных о выбросах
Внимание!
Некоторые или все функции доступны в рамках предварительного выпуска. Содержимое и функциональность могут быть изменены.
Вы можете использовать два метода для доступа к данным о выбросах с помощью возможности анализа выбросов Azure в решениях по данным об устойчивом развитии в Microsoft Fabric:
Доступ к данным по выбросам через SQL
Вы можете получить доступ к агрегированным данным в ComputedESGMetrics хранилище и озеро данных через SQL конечная точка, доступный в AnalyzeAzureEmissionsDataset , выполнив следующие действия:
На домашней странице возможностей Azure emission insights выберите семантическую модель AnalyzeAzureEmissionsDataset .
Перейдите к конечной точке ComputedESGMetrics SQL.
Вы можете использовать Копировать строку подключения SQL для внешнего использования набор данных с совместимыми клиентскими инструментами SQL, такими как Azure Data Studio и SQL Server Management Studio (SSMS).
Доступ к данным о выбросах через API
Создайте идентификатор приложения в вашем Microsoft Entra клиенте идентификатора и создайте новый секрет клиента для идентификатора приложения.
Для этого варианта использования зарегистрируйте приложение с типом учетной записи Учетные записи только в этом организационном каталоге. Пропустите URI перенаправления, поскольку в данном случае он не требуется. Вы также можете пропустить шаги Настройка параметров платформы , поскольку они не требуются для этого сценария.
Настройте параметры арендатора на уровне администратора. Убедитесь, что у вас есть одна из ролей администратора, как определено в разделе Понимание Microsoft Fabric ролей администратора в Microsoft Fabric документации. При необходимости обратитесь к своему Microsoft Fabric администратору арендатора, чтобы выполнить следующие шаги:
Откройте рабочую область в Fabric, в которой вы развернули решения по обработке данных об устойчивом развитии.
Выберите значок Настройки в правом верхнем углу, чтобы открыть боковую панель настроек, а затем выберите Портал администратора.
В разделе Настройки клиента перейдите в Настройки разработчика и включите разрешение Субъекты службы могут использовать API Fabric для всей организации или для определенной группы безопасности.
Убедитесь, что созданное вами ранее удостоверение приложения входит в группу безопасности.
Назначьте разрешения для идентификатора приложения:
Перейдите в представление рабочей области и выберите опцию Управление доступом , чтобы управлять ролями на уровне рабочей области.
Нажмите кнопку Добавить людей или группы , чтобы добавить идентификатор приложения с одной из следующих ролей: Участник, участник или Администратор. Этот шаг является обязательным, поскольку доступ к данным осуществляется с помощью внутреннего ярлыка OneLake.
Вызов API REST:
Заметка
Вы можете интегрировать эти вызовы REST API в любое клиентское HTTP-приложение.
Получите маркер доступа для настроенного идентификатора приложения. Обратитесь к разделу Получение токенов для вызова веб-API с помощью демон-приложения в Microsoft Entra документации по идентификаторам, чтобы получить токен для идентификатора приложения с использованием клиентских учетных данных OAuth рабочего процесса 2.0. Параметр области действия в запросе токена должен быть "https://storage.azure.com/.default".
Перечислите файлы разделов данных, присутствующие в 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>
Ответ:
Возвращает список свойств файла. Это файлы разделов данных, в которых хранятся данные о выбросах для указанного номера регистрации.
Извлечь содержимое определенного файла раздела данных.
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 и сохранения его на стороне приложения.