通过

快速入门 - 运行工作负荷示例

  • 项目

本快速入门指南演示如何使用示例工作负荷创建和运行 Microsoft Fabric 工作负荷。

此示例演示如何将数据存储到湖屋中和读取其中的数据。 为此，需要在代理(OBO)流中为 Azure 存储服务生成令牌。

先决条件

步骤 1：设置 Azure 存储

你需要同意使用 Azure 存储。 在此步骤中，您需要检查租户中是否已安装 Azure 存储，如果未安装，则进行安装。

  1. 登录到 Azure 门户。

  2. 在搜索框中搜索“企业应用程序”，然后从结果中选择。

  3. 从“应用程序类型”筛选下拉列表中，选择“所有应用程序”，然后选择“应用”。

  4. 在“按应用程序名称或对象 ID 搜索”框中，输入“Azure 存储”。

  5. 如果未列出 Azure 存储，请以管理员身份打开 PowerShell 并运行以下命令：

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

步骤 2：下载示例

按照以下步骤运行示例工作负荷。

  1. 导航到 示例项目目录 存储库，选择 代码，然后选择 下载 ZIP。

  2. 将 zip 文件的内容提取到计算机上的本地目录。 将创建名为 Microsoft-Fabric-workload-development-sample-main 的新文件夹。

步骤 3：获取租户 ID

按照以下步骤获取租户 ID。

  1. 使用要用于创建工作负载的用户登录 Fabric。

  2. 选择“帮助和支持”（问号 ？），然后选择“关于”。

  3. 从 租户 URL中，复制 https://app.powerbi.com/home?ctid=后的数字和字母字符串。 这是租户 ID。

    例如，如果您的租户 URL 是 https://app.powerbi.com/home?ctid=bbbbcccc-1111-dddd-2222-eeee3333ffff，则租户 ID 是 bbbbcccc-1111-dddd-2222-eeee3333ffff。

步骤 4：创建Microsoft Entra ID 应用程序

使用提供的脚本创建 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 / Audience - 例如，api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR
    • 重定向URI - http://localhost:60006/close
    • 应用程序 ID - 例如，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= - 脚本输出中的应用程序 ID。 例如，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 中会显示指示“成功”的消息，同时 Web 浏览器会打开 http://localhost:60006/ URL。 若要检查前端是否成功运行，请在浏览器中导航到 http://localhost:60006/manifests。

步骤 7：打开 Visual Studio 2022

本快速入门中的其余步骤在 Visual Studio 2022 中执行。 使用此步骤在 Visual Studio 2022 中打开解决方案。 解决方案打开后，可以在完成剩余步骤时保持 Visual Studio 打开状态。

  1. 导航到 Microsoft-Fabric-workload-development-sample-main 文件夹，然后导航到“后端”文件夹。

  2. 在 Visual Studio 2022中，打开文件 Fabric_Extension_BE_Boilerplate.sln。

步骤 8：更新后端文件

  1. 在 解决方案资源管理器中，展开 Fabric_Extension_BE_Boilerplate 并打开 appsettings.json 文件并填写以下字段：

    • PublisherTenantId：您的租户 ID。 例如，PublisherTenantId: "bbbbcccc-1111-dddd-2222-eeee3333ffff"。
    • ClientId - 脚本输出中的应用程序 Id。 例如，ClientId: "00001111-aaaa-2222-bbbb-3333cccc4444"。
    • ClientSecret - 从脚本输出中获取的 秘钥。 例如，ClientSecret: "aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2"。
    • 受众 - 脚本输出中的 ApplicationIdUri / Audience。 例如，Audience: "api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR"。

  2. 保存 appsettings.json 文件。

  3. 在 解决方案资源管理器中，展开文件夹 包 > 清单 并打开 WorkloadManifest.xml 文件并填写以下字段：

    • AppID - 你的应用 ID。 例如，<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 菜单中，选择“生成”>“生成解决方案”。 生成过程将创建一个 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 工作区 ID。

      可以通过导航到您在 Fabric 中使用的工作区来查看工作区 ID。 进入工作区后，从 URL 复制 https://app.powerbi.com/groups/后的数字和字母字符串。 工作区 ID 以左斜线结尾。 例如，如果工作区 URL 是 https://app.powerbi.com/groups/bbbbcccc-1111-dddd-2222-eeee3333ffff/list?experience=power-bi，则工作区 ID 是 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 窗口：

  • 前端 - 一个正在运行命令 npm start 的 PowerShell，如步骤 6 中所述。
  • 样板 - 一个正在运行样板的 Powershell，如步骤 11 中所述。
  • DevGateway - 一个正在运行 DevGateway.exe 的 Powershell，如步骤 12 中所述。

  1. 打开 Microsoft Fabric。

  2. 导航到用于开发的工作区。

  3. 选择“新建项”。

  4. 打开“示例项(预览版)”。

相关内容