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.
Pesquise por aplicativos empresariais e selecione-os nos resultados da pesquisa.
Na lista suspensa do filtro Tipo de aplicativo, selecione Todos os aplicativos e selecione Aplicar.
Na caixa de pesquisa Pesquisar por nome de aplicativo ou ID de objeto, insira Azure Storage.
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.
Navegue até o repositório do Diretório de Projeto de Exemplo, selecione Código e selecione Baixar o ZIP.
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.
Faça logon no Fabric com o usuário que você deseja usar para criar a carga de trabalho.
Selecione Ajuda e Suporte (o ponto de interrogação ?) e selecione Sobre.
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.
Abra o PowerShell .
Navegue para a pasta Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Authentication.
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>"
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
- ApplicationIdUri/público-alvo – por exemplo,
Etapa 5: Atualizar o arquivo .env.dev
Navegue até a pasta Microsoft-Fabric-workload-development-sample-main e navegue até a pasta Front-end.
Abra o arquivo .env.dev com um editor de texto.
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
.
- DEV_AAD_CONFIG_AUDIENCE= – o público-alvo da saída do script. Por exemplo,
** Salve o arquivo .env.dev.
Etapa 6: Executar o front-end
Abra PowerShell e faça o seguinte:
Navegue até a pasta Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Frontend.
Para instalar as dependências, execute o comando
npm install
. Uma nova pasta chamada node_modules é criada.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.
Navegue até a pasta Microsoft-Fabric-workload-development-sample-main e então navegue até a pasta Backend.
No do Visual Studio 2022, abra o arquivo Fabric_Extension_BE_Boilerplate.sln.
Etapa 8: Atualizar os arquivos de back-end
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"
.
- PublisherTenantId – ID do locatário. Por exemplo,
Salve o arquivo appsettings.json.
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>
.
- appID – sua ID do aplicativo. Por exemplo,
Salve o arquivo WorkloadManifest.xml.
Etapa 9: Criar o pacote NuGet
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.
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
No Gerenciador de Soluções , abra o arquivo workload-dev-mode.json.
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 forhttps://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"
,
Salve o arquivo workload-dev-mode.json.
Copie o arquivo workload-dev-mode.json de src/Config para
C:\
.
Etapa 11: Executar o modelo
No menu do Visual Studio 2022, selecione a seta ao lado de IIS Express e, no menu suspenso, selecione Modelo.
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
Abra o PowerShell e navegue até a pasta DevGateway.
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:
Abra o Microsoft Fabric.
Navegue até o workspace que você está usando para desenvolvimento.
Selecione Novo item.
Abra Item de Exemplo (versão prévia).