Partilhar via

Guia de início rápido - Executar um exemplo de carga de trabalho

  • Artigo

Este guia de início rápido mostra como criar e executar uma carga de trabalho do Microsoft Fabric usando uma carga de trabalho de exemplo.

Este exemplo demonstra o armazenamento e a leitura de dados de e para lakehouses. Para fazer isso, precisas gerar tokens para o serviço de Armazenamento do Azure em fluxos OBO (Behalf-Of).

Pré-requisitos

  • Um ambiente que está configurado para o desenvolvimento da carga de trabalho.

  • Se de armazenamento do Azure não estiver instalado em seu locatário, você deverá ser um administrador global no locatário.

  • ASP.NET Core Runtime 6.0 - ASP.NET Core é usado para criar a carga de trabalho de exemplo.

  • .NET 6.0 Runtime - .NET é usado para construir o workload de exemplo.

Etapa 1: Configurar o armazenamento do Azure

Você precisa de consentimento para usar o Armazenamento do Azure. Nesta etapa, você verifica se o Armazenamento do Azure está instalado no locatário e, se não é, você o instala.

  1. Inicie sessão no portal do Azure.

  2. Pesquise aplicativos Enterprise e selecione-o nos resultados da pesquisa.

  3. Na lista suspensa de filtro Tipo de aplicação, selecione Todas as aplicações e, em seguida, selecione Aplicar.

  4. Na caixa de pesquisa Pesquisar por nome de aplicação ou ID de objeto, digite Armazenamento do Azure.

  5. Se o Armazenamento do Azure não estiver listado, abra o PowerShell como administrador e execute os seguintes comandos:

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

Etapa 2: Baixe o exemplo

Siga estas etapas para executar a carga de trabalho de exemplo.

  1. Navegue até o repositório Sample Project Directory, selecione Code e, em seguida, selecione Download ZIP.

  2. Extraia o conteúdo do arquivo zip para um diretório local em sua máquina. Uma nova pasta chamada Microsoft-Fabric-workload-development-sample-main é criada.

Passo 3: Obter o ID do inquilino

Siga estes passos para obter o seu ID de inquilino.

  1. Faça login no Fabric com o usuário que você deseja usar para criar a carga de trabalho.

  2. Selecione o Ajuda & Suporte (o ponto de interrogação ?) e, em seguida, selecione Sobre.

  3. A partir do URL do Inquilino, copie a sequência de números e letras após https://app.powerbi.com/home?ctid=. Este é o seu ID de inquilino.

    Por exemplo, se o URL do locatário for https://app.powerbi.com/home?ctid=bbbbcccc-1111-dddd-2222-eeee3333ffff, o ID do locatário é bbbbcccc-1111-dddd-2222-eeee3333ffff.

Etapa 4: Criar um aplicativo Microsoft Entra ID

Use o script fornecido para criar um aplicativo Azure Entra ID.

  1. Abra PowerShell.

  2. Navegue até a pasta Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Authentication.

  3. Execute o comando nesta etapa. Para autenticar, use as credenciais do usuário que você está usando para criar a carga de trabalho.

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

  4. Copie os seguintes detalhes da saída do script:

    • ApplicationIdUri / Audience - Por exemplo, api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR
    • RedirectURI - http://localhost:60006/close
    • Application Id - Por exemplo, 00001111-aaaa-2222-bbbb-3333cccc4444
    • segredo - Por exemplo, aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2

Etapa 5: Atualizar o arquivo .env.dev

  1. Navegue até a pasta Microsoft-Fabric-workload-development-sample-main e navegue até a pasta Frontend.

  2. Abra o arquivo .env.dev com um editor de texto.

  3. Insira os seguintes detalhes:

    • DEV_AAD_CONFIG_AUDIENCE= - A audiência proveniente do output do script. Por exemplo, DEV_AAD_CONFIG_AUDIENCE=api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR.
    • DEV_AAD_CONFIG_APPID= - O ID do aplicativo da saída do script. Por exemplo, DEV_AAD_CONFIG_APPID=00001111-aaaa-2222-bbbb-3333cccc4444.

  4. Salve o arquivo .env.dev.

Etapa 6: Executar o frontend

Abra PowerShell e faça o seguinte:

  1. Navegue até à pasta Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Frontend.

  2. Para instalar as dependências, execute o comando npm install. Uma nova pasta chamada node_modules é criada.

  3. Para iniciar o frontend, execute o comando npm start.

    Quando o frontend for executado com êxito, você verá uma mensagem que inclui com êxito no PowerShell e seu navegador da Web será aberto com a URL http://localhost:60006/. Para verificar se o frontend está sendo executado com êxito, em seu navegador, navegue até http://localhost:60006/manifests.

Etapa 7: abrir o Visual Studio 2022

O restante das etapas neste início rápido é executado no Visual Studio 2022. Use esta etapa para abrir sua solução no Visual Studio 2022. Depois que sua solução estiver aberta, você poderá manter o Visual Studio aberto enquanto conclui as etapas restantes.

  1. Navegue até a pasta Microsoft-Fabric-workload-development-sample-main e depois até a pasta Backend.

  2. No Visual Studio 2022, abra o arquivo Fabric_Extension_BE_Boilerplate.sln.

Etapa 8: Atualizar os arquivos de back-end

  1. No Gerenciador de Soluções, expanda Fabric_Extension_BE_Boilerplate e abra o arquivo appsettings.json e preencha os seguintes campos:

    • PublisherTenantId - O seu ID de inquilino. Por exemplo, PublisherTenantId: "bbbbcccc-1111-dddd-2222-eeee3333ffff".
    • ClientId - O Application Id da saída do script. Por exemplo, ClientId: "00001111-aaaa-2222-bbbb-3333cccc4444".
    • ClientSecret - O segredo da saída do script. Por exemplo, ClientSecret: "aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2".
    • Audience - O ApplicationIdUri / Audience a partir da saída do script. Por exemplo, Audience: "api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR".

  2. Salve o arquivo appsettings.json.

  3. No Gerenciador de Soluções, expanda a pasta Pacotes > manifesto e abra o arquivo WorkloadManifest.xml e preencha os seguintes campos:

    • AppID - Sua ID de aplicativo. Por exemplo, <AppId>00001111-aaaa-2222-bbbb-3333cccc4444</AppId>.
    • RedirectUri - Seu URI de redirecionamento. <RedirectUri>http://localhost:60006/close</RedirectUri>.
    • ResourceId - O ApplicationIdUri / Audience a partir da saída do script. Por exemplo, <ResourceId>api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR</ResourceId>.

  4. Salve o arquivo WorkloadManifest.xml.

Etapa 9: Criar o pacote NuGet

  1. No menu Visual Studio, selecione Build > Build Solution. A compilação cria um pacote NuGet que inclui os arquivos XML e JSON de frontend e backend.

  2. Na janela Output, tome o caminho indicado na linha que se inicia com 1>Pacote criado com êxito.

    Neste exemplo de saída, o caminho é destacado a negrito. 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.

Passo 10: Copie para a unidade local

  1. No Solution Explorer, abra o arquivo workload-dev-mode.json.

  2. Preencha os seguintes campos:

    • WorkspaceGuid - A sua ID do espaço de trabalho Fabric.

      Você pode encontrar sua ID de espaço de trabalho navegando até o espaço de trabalho que está usando no Fabric. Quando estiver no espaço de trabalho, copie a cadeia de números e letras após https://app.powerbi.com/groups/. O identificador do espaço de trabalho termina com uma barra inclinada. Por exemplo, se a URL do espaço de trabalho for https://app.powerbi.com/groups/bbbbcccc-1111-dddd-2222-eeee3333ffff/list?experience=power-bi, o ID do espaço de trabalho será bbbbcccc-1111-dddd-2222-eeee3333ffff.

    • ManifestPackageFilePath - O caminho do arquivo de pacote de manifesto (etapa 9). Por exemplo, "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. Salve o arquivo workload-dev-mode.json.

  4. Copie o arquivo workload-dev-mode.json do src/Config para C:\.

Passo 11: Execute o código base

  1. No Visual Studio 2022, a partir do menu, selecione a seta ao lado de IIS Express e, no menu pendente, selecione Boilerplate.

  2. Selecione Boilerplate e autorize as solicitações do Visual Studio. Um prompt de comando é aberto com informações sobre a solução em execução.

Etapa 12: Executar o arquivo DevGateway

  1. Abra PowerShell e navegue até a pasta DevGateway.

  2. No PowerShell, execute o comando: .\Microsoft.Fabric.Workload.DevGateway.exe. Quando a saída mostra a mensagem info: DevGateway iniciado. A carga de trabalho está sendo executada com êxito.

Etapa 13: Abrir a carga de trabalho de exemplo no Fabric

Dica

Para abrir a carga de trabalho de exemplo no Fabric, você precisa ter três janelas do PowerShell abertas e em execução:

  • Frontend - Um Powershell com o comando npm start em execução, conforme descrito em Etapa 6.
  • Boilerplate - Um Powershell executando o boilerplate, conforme descrito no Passo 11.
  • DevGateway - Um Powershell executando DevGateway.exe, conforme descrito em Etapa 12.

  1. Abra o Microsoft Fabric.

  2. Navegue até o espaço de trabalho que você está usando para desenvolvimento.

  3. Selecione Novo item.

  4. Abra Item de Amostra (Visualização).

Conteúdos relacionados