Compartilhar via


Início Rápido – Executar um exemplo de carga de trabalho

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, você precisa gerar tokens para o serviço de Armazenamento do Azure em fluxos OBO (On-Behalf-Of).

Pré-requisitos

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; se não estiver, você deve instalá-lo.

  1. Faça login no portal do Azure .

  2. Pesquise por aplicativos empresariais e selecione-os nos resultados da pesquisa.

  3. Na lista suspensa do filtro Tipo de aplicativo, selecione Todos os aplicativos e selecione Aplicar.

  4. Na caixa de pesquisa Pesquisar por nome de aplicativo ou ID de objeto, insira Azure Storage.

  5. Se Azure Storage não estiver listado, abra 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: Baixar o exemplo

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

  1. Navegue até o repositório do Diretório de Projeto de Exemplo, selecione Código e selecione Baixar o ZIP.

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

Etapa 3: Obter a ID do locatário

Siga estas etapas para obter a ID do locatário.

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

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

  3. Na URL do Locatário, copie a cadeia de caracteres de números e letras após https://app.powerbi.com/home?ctid=. Essa é sua ID de locatário.

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

Etapa 4: Criar um aplicativo de ID do Microsoft Entra

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

  1. Abra o PowerShell .

  2. Navegue para 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/público-alvo – por exemplo, api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR
    • RedirectURI - http://localhost:60006/close
    • id do aplicativo – por exemplo, 00001111-aaaa-2222-bbbb-3333cccc4444
    • secreto – 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 Front-end.

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

  3. Insira os seguintes detalhes:

    • DEV_AAD_CONFIG_AUDIENCE= – o público-alvo da saída do script. Por exemplo, DEV_AAD_CONFIG_AUDIENCE=api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR.
    • DEV_AAD_CONFIG_APPID= – A 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 front-end

Abra PowerShell e faça o seguinte:

  1. Navegue até a 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 front-end, execute o comando npm start.

    Depois que o front-end 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 front-end está sendo executado com êxito, no navegador, navegue até http://localhost:60006/manifests.

Etapa 7: Abrir o Visual Studio 2022

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

  1. Navegue até a pasta Microsoft-Fabric-workload-development-sample-main e então navegue até a pasta Backend.

  2. No do 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, abra o arquivo appsettings.json e preencha os seguintes campos:

    • PublisherTenantId – ID do locatário. Por exemplo, PublisherTenantId: "bbbbcccc-1111-dddd-2222-eeee3333ffff".
    • ClientId – a ID do aplicativo 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".
    • Público-alvo – o ApplicationIdUri/Público-alvo 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, abra o arquivo WorkloadManifest.xml e preencha os seguintes campos:

    • appID – sua ID do aplicativo. Por exemplo, <AppId>00001111-aaaa-2222-bbbb-3333cccc4444</AppId>.
    • RedirectUri – seu URI de redirecionamento. <RedirectUri>http://localhost:60006/close</RedirectUri>.
    • ResourceId – o ApplicationIdUri/Público-alvo 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 do Visual Studio, selecione Criar > Criar Solução. O build cria um pacote NuGet que inclui os arquivos XML e JSON de front-end e back-end.

  2. Na janela de Saída, siga o caminho listado na linha que começa com 1>Pacote criado com êxito.

    Neste exemplo de saída, o caminho é realçado em 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.

Etapa 10: Copiar para sua unidade local

  1. No Gerenciador de Soluções , abra o arquivo workload-dev-mode.json.

  2. Preencha os seguintes campos:

    • WorkspaceGuid – ID do workspace do Fabric.

      Você pode encontrar a ID do seu espaço de trabalho navegando até o espaço de trabalho que está usando no Fabric. Quando você estiver no workspace, copie a cadeia de caracteres de números e letras no endereço da URL após https://app.powerbi.com/groups/. A ID do workspace termina com uma barra invertida. 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, sua ID do espaço de trabalho será bbbbcccc-1111-dddd-2222-eeee3333ffff.

    • ManifestPackageFilePath – o caminho do arquivo do 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 de src/Config para C:\.

Etapa 11: Executar o modelo

  1. No menu do Visual Studio 2022, selecione a seta ao lado de IIS Express e, no menu suspenso, selecione Modelo.

  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 o PowerShell e navegue até a pasta DevGateway.

  2. No PowerShell, execute o comando: .\Microsoft.Fabric.Workload.DevGateway.exe. Quando a saída exibe a mensagem informação: 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:

  • Front-end – um Powershell com o comando npm start em execução, conforme descrito na Etapa 6.
  • Modelo – um PowerShell que executa o modelo, conforme descrito na Etapa 11.
  • DevGateway – um PowerShell executando DevGateway.exe, conforme descrito na Etapa 12.
  1. Abra o Microsoft Fabric.

  2. Navegue até o workspace que você está usando para desenvolvimento.

  3. Selecione Novo item.

  4. Abra Item de Exemplo (versão prévia).