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

Быстрый старт - запуск образца рабочей нагрузки

  • Статья

В этом кратком руководстве показано, как создать и запустить рабочую нагрузку Microsoft Fabric с помощью примера рабочей нагрузки.

В этом примере демонстрируется хранение и чтение данных из и в хранилища данных типа lakehouse. Для этого необходимо сгенерировать токены для службы хранилища Azure в потоках on-Behalf-Of (OBO).

Необходимые компоненты

Шаг 1. Настройка хранилища Azure

Вам нужно предоставить согласие на использование службы хранилища Azure. На этом шаге вы проверяете, установлено ли Azure Storage в арендатора, и если оно не установлено, устанавливаете.

  1. Войдите в портал Azure.

  2. Найдите приложения для предприятий и выберите их из результатов поиска.

  3. В раскрывающемся списке фильтра Тип приложения выберите Все приложения, а затем нажмите Применить.

  4. В поле поиска по имени приложения или идентификатору объекта введите Azure Storage.

  5. Если службы хранилища Azure нет в списке, откройте PowerShell в качестве администратора и выполните следующие команды:

    Install-Module az
Import-Module az
Connect-AzureAD
New-AzureADServicePrincipal -AppId e406a681-f3d4-42a8-90b6-c2b029497af1

Шаг 2. Скачивание примера

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

  1. Перейдите в репозиторий Sample Project Directory, выберите Code, а затем выберите Download ZIP.

  2. Извлеките содержимое ZIP-файла в локальный каталог на компьютере. Создается новая папка с именем Microsoft-Fabric-workload-development-sample-main.

Шаг 3. Получение идентификатора клиента

Выполните следующие действия, чтобы получить идентификатор клиента.

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

  2. Выберите Помощь & Поддержка (значок вопроса ?) и затем выберите О программе.

  3. Из URL клиентаскопируйте строку чисел и букв после https://app.powerbi.com/home?ctid=. Это идентификатор клиента.

    Например, если URL-адрес клиента https://app.powerbi.com/home?ctid=bbbbcccc-1111-dddd-2222-eeee3333ffff, идентификатор клиента bbbbcccc-1111-dddd-2222-eeee3333ffff.

Шаг 4. Создание приложения идентификатора Microsoft Entra

Используйте предоставленный скрипт для создания приложения Azure Entra ID.

  1. Откройте PowerShell.

  2. Перейдите к папке Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Authentication.

  3. Выполните команду на этом шаге. Чтобы пройти проверку подлинности, используйте учетные данные пользователя, который вы используете для создания рабочей нагрузки.

    .\CreateDevAADApp.ps1 -applicationName "myWorkloadApp" -workloadName "Org.WorkloadSample" -tenantId "<your-tenant-id>"

  4. Скопируйте следующие сведения из выходных данных скрипта:

    • ApplicationIdUri / Аудитория - Например, api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR
    • URI перенаправления - http://localhost:60006/close
    • идентификатор приложения. Например, 00001111-aaaa-2222-bbbb-3333cccc4444
    • секрет - например, aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2

Шаг 5. Обновление файла env.dev

  1. Перейдите в папку Microsoft-Fabric-workload-development-sample-main и перейдите в папку Фронтенд.

  2. Откройте файл .env.dev с помощью текстового редактора.

  3. Введите следующие сведения:

    • DEV_AAD_CONFIG_AUDIENCE= — аудитория из выходных данных скрипта. Например, DEV_AAD_CONFIG_AUDIENCE=api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR.
    • DEV_AAD_CONFIG_APPID= — идентификатор приложения из выходных данных скрипта. Например, DEV_AAD_CONFIG_APPID=00001111-aaaa-2222-bbbb-3333cccc4444.

  4. Сохраните файл .env.dev.

Шаг 6. Запуск интерфейса

Откройте PowerShell и выполните следующие действия:

  1. Перейдите к папке Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Frontend.

  2. Чтобы установить зависимости, выполните команду npm install. Создается новая папка с именем node_modules.

  3. Чтобы запустить интерфейс, выполните команду npm start.

    После успешного запуска внешнего интерфейса появится сообщение, включающее успешно в PowerShell, и веб-браузер откроется с помощью URL-адреса http://localhost:60006/. Чтобы убедиться, что фронтенд успешно запущен, в браузере перейдите к http://localhost:60006/manifests.

Шаг 7. Открытие Visual Studio 2022

Остальные действия, описанные в этом кратком руководстве, выполняются в Visual Studio 2022. Используйте этот шаг, чтобы открыть решение в Visual Studio 2022. После открытия решения вы можете открыть Visual Studio во время выполнения оставшихся шагов.

  1. Перейдите в папку Microsoft-Fabric-workload-development-sample-main и перейдите в папку Backend.

  2. В Visual Studio 2022откройте файл Fabric_Extension_BE_Boilerplate.sln.

Шаг 8. Обновление внутренних файлов

  1. Вобозревателя решений разверните Fabric_Extension_BE_Boilerplate и откройте файл appsettings.json и заполните следующие поля:

    • PublisherTenantId — идентификатор клиента. Например, PublisherTenantId: "bbbbcccc-1111-dddd-2222-eeee3333ffff".
    • ClientId — идентификатор приложения из выходных данных скрипта. Например, ClientId: "00001111-aaaa-2222-bbbb-3333cccc4444".
    • ClientSecret — секрет из выходных данных скрипта. Например, ClientSecret: "aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2".
    • Audience — ApplicationIdUri / Audience из выходных данных скрипта. Например, Audience: "api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR".

  2. Сохраните файл appsettings.json.

  3. В обозревателе решений разверните папку Пакеты, манифест >, откройте файл WorkloadManifest.xml и заполните следующие поля.

    • идентификатор приложения — ваш идентификатор приложения. Например, <AppId>00001111-aaaa-2222-bbbb-3333cccc4444</AppId>.
    • RedirectUri — URI перенаправления. <RedirectUri>http://localhost:60006/close</RedirectUri>.
    • ResourceId — ApplicationIdUri / Audience из результатов скрипта. Например, <ResourceId>api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR</ResourceId>.

  4. Сохраните файл WorkloadManifest.xml.

Шаг 9. Создание пакета NuGet

  1. В меню Visual Studio выберите build > Build Solution. Сборка создает пакет NuGet, включающий интерфейсные и внутренние XML-файлы и JSON.

  2. В окне выходных данных выберите путь, указанный в строке, начиная с 1>успешно созданного пакета.

    В этом примере выходных данных путь выделен полужирным шрифтом. 1>Successfully created package C:\Dev kit\Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Backend\src\bin\Debug\ManifestPackage.1.0.0.nupkg.

Шаг 10. Копирование на локальный диск

  1. Вобозревателя решений откройте файл workload-dev-mode.json.

  2. Заполните следующие поля:

    • WorkspaceGuid — ваш идентификатор рабочей области Fabric.

      Идентификатор рабочей области можно найти, перейдя к рабочей области, которую вы используете в Fabric. Когда вы находитесь в рабочей области, из URL-адреса скопируйте строку чисел и букв после https://app.powerbi.com/groups/. Идентификатор рабочей области заканчивается косой чертой. Например, если URL-адрес рабочей области https://app.powerbi.com/groups/bbbbcccc-1111-dddd-2222-eeee3333ffff/list?experience=power-bi, то идентификатор рабочей области bbbbcccc-1111-dddd-2222-eeee3333ffff.

    • ManifestPackageFilePath — путь к файлу пакета манифеста (шаг 9). Например, "ManifestPackageFilePath": "C:\Dev kit\Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Backend\src\bin\Debug\ManifestPackage.1.0.0.nupkg",

  3. Сохраните файл workload-dev-mode.json.

  4. Скопируйте файл workload-dev-mode.json из src/Config в C:\.

Шаг 11. Запуск стандартного кода

  1. В Visual Studio 2022 в меню щелкните стрелку рядом с IIS Express и в раскрывающемся меню выберите Boilerplate.

  2. Выберите "Шаблонный код" и авторизуйте запросы Visual Studio. Откроется командная строка с информацией о работающем решении.

Шаг 12. Запуск файла DevGateway

  1. Откройте PowerShell и перейдите в папку DevGateway.

  2. В PowerShell выполните команду: .\Microsoft.Fabric.Workload.DevGateway.exe. Когда выходные данные отображают сообщение сведения: DevGateway запущен. Рабочая нагрузка успешно выполняется.

Шаг 13. Открытие примера рабочей нагрузки в Fabric

Совет

Чтобы открыть пример рабочей нагрузки в Fabric, необходимо открыть и запустить три окна PowerShell:

  • Frontend — это Powershell с командой npm start на исполнении, как описано в шаге 6.
  • Шаблон — PowerShell, запускающий шаблон, как описано в шаге 11.
  • DevGateway — Powershell под управлением DevGateway.exe, как описано в шаге 12.

  1. Откройте Microsoft Fabric.

  2. Перейдите в рабочую область, которую вы используете для разработки.

  3. Выберите Новый элемент.

  4. Откройте пример элемента (предварительная версия).

Связанный контент