Bagikan melalui

Mulai Cepat - Menjalankan sampel beban kerja

Panduan mulai cepat ini menunjukkan kepada Anda cara membuat dan menjalankan beban kerja Microsoft Fabric menggunakan beban kerja sampel.

Sampel ini menunjukkan penyimpanan dan pembacaan data dari dan ke lakehouse. Untuk melakukannya, Anda perlu membuat token untuk layanan Azure Storage di alur On-Behalf-Of (OBO).

Prerequisites

Langkah 1: Menyiapkan penyimpanan Azure

Anda memerlukan persetujuan untuk menggunakan Azure Storage. Dalam langkah ini Anda memeriksa apakah Azure Storage diinstal di penyewa, dan jika bukan Anda menginstalnya.

  1. Masuk ke portal Microsoft Azure .

  2. Cari aplikasi Enterprise dan pilih dari hasil pencarian.

  3. Dari daftar dropdown Filter jenis aplikasi , pilih Semua aplikasi lalu pilih Terapkan.

  4. Dalam kotak pencarian Cari menurut nama aplikasi atau ID objek, masukkan Azure Storage.

  5. Jika Azure Storage tidak tercantum, buka PowerShell sebagai administrator dan jalankan perintah berikut:

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

Langkah 2: Unduh sampel

Ikuti langkah-langkah ini untuk menjalankan beban kerja sampel.

  1. Navigasikan ke repositori Direktori Proyek Sampel , pilih Kode, lalu pilih Unduh ZIP.

  2. Ekstrak konten file zip ke direktori lokal di komputer Anda. Folder baru yang disebut Microsoft-Fabric-workload-development-sample-main dibuat.

Langkah 3: Dapatkan ID penyewa Anda

Ikuti langkah-langkah ini untuk mendapatkan ID penyewa Anda.

  1. Masuk ke Fabric dengan pengguna yang ingin Anda gunakan untuk membuat beban kerja.

  2. Pilih Bantuan & Dukungan (tanda tanya ?) lalu pilih Tentang.

  3. Dari URL Penyewa , salin string angka dan huruf setelah https://app.powerbi.com/home?ctid=. String ini ID penyewa Anda.

    Misalnya, jika URL penyewa Anda https://app.powerbi.com/home?ctid=bbbbcccc-1111-dddd-2222-eeee3333ffff, ID penyewa Anda bbbbcccc-1111-dddd-2222-eeee3333ffff.

Langkah 4: Membuat aplikasi ID Microsoft Entra

Gunakan skrip yang disediakan untuk membuat aplikasi ID Microsoft Entra.

  1. Buka PowerShell.

  2. Navigasi ke folder Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Authentication .

  3. Jalankan perintah dalam langkah ini. Untuk mengautentikasi, gunakan kredensial pengguna yang Anda gunakan untuk membuat beban kerja.

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

  4. Salin detail berikut dari output skrip:

    • ApplicationIdUri / Audience - Misalnya, api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR
    • URI Pengalihan - http://localhost:60006/close
    • Id Aplikasi - Misalnya, 00001111-aaaa-2222-bbbb-3333cccc4444
    • rahasia - Misalnya,

Langkah 5: Perbarui file .env.dev

  1. Navigasikan ke folder Microsoft-Fabric-workload-development-sample-main dan masuk ke folder Frontend.

  2. Buka file .env.dev dengan editor teks.

  3. Masukkan detail berikut:

    • DEV_AAD_CONFIG_AUDIENCE= - Audiens dari output skrip. Misalnya, DEV_AAD_CONFIG_AUDIENCE=api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR.
    • DEV_AAD_CONFIG_APPID= - ID aplikasi dari output skrip. Misalnya, DEV_AAD_CONFIG_APPID=00001111-aaaa-2222-bbbb-3333cccc4444.

  4. Simpan file .env.dev .

Langkah 6: Jalankan frontend

Buka PowerShell dan lakukan hal berikut:

  1. Navigasi ke folder Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Frontend .

  2. Untuk menginstal dependensi, jalankan perintah npm install. Folder baru yang disebut node_modules dibuat.

  3. Untuk memulai frontend, jalankan perintah npm start.

    Setelah frontend berhasil dijalankan, Anda akan melihat pesan yang menyertakan berhasil di PowerShell, dan browser web Anda akan terbuka dengan URL http://localhost:60006/. Untuk memeriksa apakah frontend berhasil berjalan, di browser Anda, navigasikan ke http://localhost:60006/manifests.

Langkah 7: Buka Visual Studio

Langkah-langkah lainnya dalam mulai cepat ini dilakukan di Visual Studio. Gunakan langkah ini untuk membuka solusi Anda di Visual Studio. Setelah solusi terbuka, Anda dapat membuka Visual Studio saat menyelesaikan langkah-langkah yang tersisa.

  1. Navigasikan ke folder Microsoft-Fabric-workload-development-sample-main dan kemudian ke folder Backend.

  2. Di Visual Studio, buka file Fabric_Extension_BE_Boilerplate.sln.

Langkah 8: Memperbarui file backend

  1. Di Penjelajah Solusi, perluas Fabric_Extension_BE_Boilerplate lalu buka file appsettings.json dan isi bidang berikut:

    • PublisherTenantId - ID penyewa Anda. Misalnya, PublisherTenantId: "bbbbcccc-1111-dddd-2222-eeee3333ffff".
    • ClientId - Id Aplikasi dari output skrip. Misalnya, ClientId: "00001111-aaaa-2222-bbbb-3333cccc4444".
    • ClientSecret - Rahasia dari output skrip. Misalnya, ClientSecret: "aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2".
    • Audiens - ApplicationIdUri / Audience dari output skrip. Misalnya, Audience: "api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR".

  2. Simpan file appsettings.json .

  3. Di Penjelajah Solusi, perluas folder Paket > Manifes, kemudian buka file WorkloadManifest.xml dan isi bidang berikut:

    • AppID - ID Aplikasi Anda. Misalnya, <AppId>00001111-aaaa-2222-bbbb-3333cccc4444</AppId>.
    • RedirectUri - URI pengalihan Anda. <RedirectUri>http://localhost:60006/close</RedirectUri>.
    • ResourceId - ApplicationIdUri / Audience dari output skrip. Misalnya, <ResourceId>api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR</ResourceId>.

  4. Simpan file WorkloadManifest.xml .

Langkah 9: Bangun paket NuGet

  1. Dari menu Visual Studio, pilih Build > Build Solution. Build membuat paket NuGet yang menyertakan file XML dan JSON frontend dan backend.

  2. Dari jendela Output , ambil jalur yang tercantum dalam baris yang dimulai dengan 1>Paket yang berhasil dibuat.

    Dalam contoh output ini, jalur disorot dalam huruf tebal. 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.

Langkah 10: Salin ke drive lokal Anda

  1. Di Penjelajah Solusi, buka file workload-dev-mode.json.

  2. Isi bidang berikut:

    • WorkspaceGuid - ID ruang kerja Fabric Anda.

      Anda dapat menemukan ID ruang kerja dengan menavigasi ke ruang kerja yang Anda gunakan di Fabric. Setelah Anda berada di ruang kerja, dari URL salin deretan angka dan huruf setelah https://app.powerbi.com/groups/. ID ruang kerja berakhir dengan garis miring ke depan. Misalnya, jika URL ruang kerja Anda https://app.powerbi.com/groups/bbbbcccc-1111-dddd-2222-eeee3333ffff/list?experience=power-bi, ID ruang kerja Anda bbbbcccc-1111-dddd-2222-eeee3333ffff.

    • ManifestPackageFilePath - Jalur file paket manifes (langkah 9). Misalnya, "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. Simpan file workload-dev-mode.json .

  4. Salin file workload-dev-mode.json dari src/Config ke .

Langkah 11: Jalankan template standar

  1. Di Visual Studio 2022, dari menu, pilih panah di samping IIS Express dan dari menu dropdown pilih Boilerplate.

  2. Pilih Boilerplate dan otorisasi permintaan Visual Studio. Jendela perintah terbuka dengan informasi tentang solusi yang sedang berjalan.

Langkah 12: Jalankan file DevGateway

Nota

Jika Anda tidak menggunakan Windows, Anda perlu menjalankan DevGateway dalam kontainer Docker seperti yang dijelaskan dalam Kontainer DevGateway.

  1. Buka PowerShell dan navigasikan ke folder DevGateway.

  2. Di PowerShell, jalankan perintah: .\Microsoft.Fabric.Workload.DevGateway.exe. Saat output menampilkan info pesan: DevGateway dimulai. beban kerja berhasil berjalan.

    Jika Anda menyimpan workload-dev-mode.json file dari langkah 10 ke folder tertentu, jalankan perintah dengan DevMode:LocalConfigFilePath parameter .

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

Langkah 13: Buka beban kerja sampel di Fabric

Tips

Untuk membuka beban kerja sampel di Fabric, Anda harus membuka dan menjalankan tiga jendela PowerShell:

  • Frontend - PowerShell dengan perintah npm start berjalan, seperti yang dijelaskan di Langkah 6.
  • Boilerplate - PowerShell yang menjalankan boilerplate, seperti yang dijelaskan di Langkah 11.
  • DevGateway - PowerShell yang berjalan DevGateway.exe, seperti yang dijelaskan di Langkah 12.

  1. Buka Microsoft Fabric.

  2. Navigasi ke ruang kerja yang Anda gunakan untuk pengembangan.

  3. Pilih Item baru.

  4. Buka Item Sampel (pratinjau).

Konten terkait

  • Last updated on