Guia de 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 On-Behalf-Of (OBO).

Prerequisites

• Um ambiente configurado para o desenvolvimento da 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 - .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. Faça logon no portal do Azure.

2. Pesquise aplicações empresariais e selecione-as nos resultados da pesquisa.

3. Na lista suspensa Filtro de tipo de aplicativo , selecione Todos os aplicativos e, em seguida, selecione Aplicar.

4. Na caixa Pesquisar por nome de aplicativo ou pesquisa de 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 Diretório de projetos 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 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 a Ajuda & Suporte (o ponto de interrogação ?) e, em seguida, 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 sua ID de locatário.

   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 será bbbbcccc-1111-dddd-2222-eeee3333ffff.

Etapa 4: Criar um aplicativo Microsoft Entra ID

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

1. Abra o 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= - O público a partir da saída do roteiro. 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é 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 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 http://localhost:60006/ URL. 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

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 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, 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 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".
   • Audience - O ApplicationIdUri / Audience 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 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 Saída , pegue 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.

Passo 10: Copie para a unidade local

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

2. Preencha os seguintes campos:

   • WorkspaceGuid - Sua ID de espaço de trabalho de malha.

     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 sequência de números e letras após https://app.powerbi.com/groups/. O ID do espaço de trabalho termina com uma barra para frente. 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 clichê

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 as informações da mensagem : 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 espaço de trabalho que você está usando para desenvolvimento.

3. Selecione Novo item.

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

Conteúdo relacionado

• Compreender o exemplo de desenvolvimento