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

• Um ambiente configurado para desenvolvimento de carga de trabalho.

• Se o 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 – o .NET é usado para criar a carga de trabalho de amostra.

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 do Projeto de Exemplo, selecione Código e, em seguida, selecione Baixar 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 cadeia de caracteres da ID do 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 Microsoft 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

O restante das etapas neste início rápido são executadas no Visual Studio. Use esta etapa para abrir sua solução no Visual Studio. 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 Visual Studio, 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.

   Se você salvou o workload-dev-mode.json arquivo da etapa 10 em uma pasta específica, execute o comando com o DevMode:LocalConfigFilePath parâmetro.

   .\Microsoft.Fabric.Workload.DevGateway.exe -DevMode:LocalConfigFilePath <path_to_config_json_path>
   

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

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).

Conteúdo relacionado

• Entenda o exemplo de desenvolvimento