Compartir a través de

Inicio rápido: Ejecución de un ejemplo de carga de trabajo

  • Artículo

En esta guía de inicio rápido se muestra cómo crear y ejecutar una carga de trabajo de Microsoft Fabric mediante una carga de trabajo de ejemplo.

En este ejemplo se muestra cómo almacenar o leer datos en almacenes de lagos. Para ello, debe generar tokens para el servicio Azure Storage en flujos con derechos delegados (OBO).

Requisitos previos

Paso 1: Configuración del almacenamiento de Azure

Necesita consentimiento para usar Azure Storage. En este paso, compruebas si Azure Storage está instalado en el tenant, y si no lo está, lo instalas.

  1. Inicie sesión en el portal de Azure .

  2. Busque aplicaciones empresariales y selecciónelo de los resultados de búsqueda.

  3. En la lista desplegable del filtro Tipo de aplicación, seleccione Todas las aplicaciones y, a continuación, Aplicar.

  4. En el cuadro de búsqueda Buscar por nombre de aplicación o identificador de objeto, escriba Azure Storage.

  5. Si no aparece azure Storage, abra powerShell como administrador y ejecute los siguientes comandos:

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

Paso 2: Descargar el ejemplo

Siga estos pasos para ejecutar la carga de trabajo de ejemplo.

  1. Vaya al repositorio Directorio del proyecto de ejemplo, seleccione Código y, a continuación, seleccione Descargar ZIP.

  2. Extraiga el contenido del archivo ZIP en un directorio local de la máquina. Se crea una nueva carpeta denominada Microsoft-Fabric-workload-development-sample-main.

Paso 3: Obtención del identificador de inquilino

Siga estos pasos para obtener el identificador de inquilino.

  1. Inicie sesión en Fabric con el usuario que desea usar para crear la carga de trabajo.

  2. Seleccione Ayuda y soporte técnico (el signo de interrogación ?) y, a continuación, seleccione Información.

  3. En la URL de inquilino, copie la cadena de números y letras después de https://app.powerbi.com/home?ctid=. Este es el identificador de inquilino.

    Por ejemplo, si la dirección URL del inquilino es https://app.powerbi.com/home?ctid=bbbbcccc-1111-dddd-2222-eeee3333ffff, el identificador de inquilino es bbbbcccc-1111-dddd-2222-eeee3333ffff.

Paso 4: Crear una aplicación de Microsoft Entra ID

Use el script proporcionado para crear una aplicación de identificador de Azure Entra.

  1. Abra PowerShell.

  2. Vaya a la carpeta Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Authentication.

  3. Ejecute el comando en este paso. Para autenticarse, use las credenciales del usuario que usa para crear la carga de trabajo.

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

  4. Copie los detalles siguientes de la salida del script:

    • ApplicationIdUri / Audience: por ejemplo, api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR
    • RedirectURI - http://localhost:60006/close
    • Id. de aplicación - por ejemplo, 00001111-aaaa-2222-bbbb-3333cccc4444
    • secreto: por ejemplo, aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2

Paso 5: Actualizar el archivo .env.dev

  1. Vaya a la carpeta Microsoft-Fabric-workload-development-sample-main y luego a la carpeta Frontend.

  2. Abra el archivo .env.dev con un editor de texto.

  3. Escriba los detalles siguientes:

    • DEV_AAD_CONFIG_AUDIENCE=: la audiencia de la salida del script. Por ejemplo, DEV_AAD_CONFIG_AUDIENCE=api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR.
    • DEV_AAD_CONFIG_APPID= - el identificador de la aplicación obtenido de la salida del script. Por ejemplo, DEV_AAD_CONFIG_APPID=00001111-aaaa-2222-bbbb-3333cccc4444.

  4. Guarde el archivo .env.dev de .

Paso 6: Ejecutar el front-end

Abra PowerShell y haga lo siguiente:

  1. Vaya a la carpeta Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Frontend.

  2. Para instalar las dependencias, ejecute el comando npm install. Se crea una nueva carpeta denominada node_modules.

  3. Para iniciar el front-end, ejecute el comando npm start.

    Una vez que el front-end se ejecute correctamente, verá un mensaje con la palabra correcto en PowerShell y el explorador web se abrirá con la dirección URL de http://localhost:60006/. Para comprobar que el front-end se está ejecutando correctamente, en el explorador, vaya a http://localhost:60006/manifests.

Paso 7: Abrir Visual Studio 2022

El resto de los pasos de este inicio rápido se realizan en Visual Studio 2022. Use este paso para abrir la solución en Visual Studio 2022. Una vez abierta la solución, puede mantener Visual Studio abierto mientras completa los pasos restantes.

  1. Vaya a la carpeta Microsoft-Fabric-workload-development-sample-main y luego a la carpeta Backend.

  2. En Visual Studio 2022, abre el archivo Fabric_Extension_BE_Boilerplate.sln.

Paso 8: Actualizar los archivos de back-end

  1. En el Explorador de soluciones , expande Fabric_Extension_BE_Boilerplate y abre el archivo appsettings.json y rellena los campos siguientes.

    • PublisherTenantId - Tu identificador de inquilino. Por ejemplo, PublisherTenantId: "bbbbcccc-1111-dddd-2222-eeee3333ffff".
    • ClientId: el id. de aplicación de la salida del script. Por ejemplo, ClientId: "00001111-aaaa-2222-bbbb-3333cccc4444".
    • ClientSecret: el secreto de la salida del script. Por ejemplo, ClientSecret: "aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2".
    • Audience: el ApplicationIdUri / Audience de la salida del script. Por ejemplo, Audience: "api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR".

  2. Guarde el archivo appsettings.json.

  3. En el Explorador de soluciones, expanda la carpeta Paquetes > manifest y abra el archivo WorkloadManifest.xml y rellene los siguientes campos.

    • AppID: tu ID de aplicación. Por ejemplo, <AppId>00001111-aaaa-2222-bbbb-3333cccc4444</AppId>.
    • RedirectUri: el URI de redirección. <RedirectUri>http://localhost:60006/close</RedirectUri>.
    • ResourceId: el ApplicationIdUri / Audience de la salida del script. Por ejemplo, <ResourceId>api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR</ResourceId>.

  4. Guarde el archivo WorkloadManifest.xml.

Paso 9: Compilación del paquete NuGet

  1. En el menú de Visual Studio, seleccione Compilar > Compilar solución. La compilación crea un paquete NuGet que incluye los archivos XML y JSON de front-end y back-end.

  2. En la ventana Salida, tome la ruta de acceso que aparece en la fila que comienza con 1>Paquete creado correctamente.

    En este ejemplo de salida, la ruta de acceso se resalta en negrita. 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.

Paso 10: Copiar en la unidad local

  1. En el Explorador de soluciones, abra el archivo workload-dev-mode.json.

  2. Rellene los campos siguientes:

    • WorkspaceGuid: id. del área de trabajo de Fabric.

      Puede encontrar su ID del área de trabajo navegando al área de trabajo que está usando en Fabric. Una vez que esté en el área de trabajo, copie la cadena de números y letras después de https://app.powerbi.com/groups/ de la dirección URL. El id. del área de trabajo termina con una barra diagonal. Por ejemplo, si la dirección URL del área de trabajo es https://app.powerbi.com/groups/bbbbcccc-1111-dddd-2222-eeee3333ffff/list?experience=power-bi, el identificador del área de trabajo es bbbbcccc-1111-dddd-2222-eeee3333ffff.

    • ManifestPackageFilePath: ruta del archivo del paquete de manifiesto (paso 9). Por ejemplo, "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. Guarde el archivo workload-dev-mode.json.

  4. Copie el archivo workload-dev-mode.json de src/Config en C:\.

Paso 11: Ejecutar el código base

  1. En Visual Studio 2022, en el menú, seleccione la flecha situada junto a IIS Express y, en el menú desplegable, seleccione Boilerplate.

  2. Seleccione Boilerplate y autorice las solicitudes de Visual Studio. Se abre un símbolo del sistema con información sobre la solución en ejecución.

Paso 12: Ejecutar el archivo DevGateway

  1. Abra PowerShell y vaya a la carpeta DevGateway.

  2. En PowerShell, ejecute el comando: .\Microsoft.Fabric.Workload.DevGateway.exe. Cuando la salida muestre el mensaje info: DevGateway ha comenzado, la carga de trabajo se estará ejecutando correctamente.

Paso 13: Apertura de la carga de trabajo de ejemplo en Fabric

Sugerencia

Para abrir la carga de trabajo de ejemplo en Fabric, debe tener tres ventanas de PowerShell abiertas y en ejecución:

  • Frontend: PowerShell con el comando npm start en ejecución, como se describe en el Paso 6.
  • Boilerplate - Un script de Powershell que ejecuta el boilerplate, como se describe en paso 11.
  • DevGateway: powershell que ejecuta DevGateway.exe, como se describe en paso 12.

  1. Abra Microsoft Fabric.

  2. Vaya al área de trabajo que está usando para el desarrollo.

  3. Seleccione Nuevo elemento.

  4. Abra Elemento de ejemplo (versión preliminar).

Contenido relacionado