Aracılığıyla paylaş

Hızlı Başlangıç - İş yükü örneği çalıştırma

Bu hızlı başlangıç kılavuzunda, örnek bir iş yükü kullanarak Microsoft Fabric iş yükü oluşturma ve çalıştırma adımları gösterilmektedir.

Bu örnek, lakehouse'lara veri depolamayı ve lakehouse'lardan veri okumayı gösterir. Bunu yapmak için, Adına (OBO) akışlarında Azure Depolama hizmeti için belirteçler oluşturmanız gerekir.

Önkoşullar

  • İş yükü geliştirme için ayarlanmış bir ortam.

  • Azure depolama kiracınızda yüklü değilse, kiracıda Genel yönetici olmanız gerekir.

  • ASP.NET Core Runtime 6.0 - ASP.NET Core, örnek iş yükünü oluşturmak için kullanılır.

  • örnek iş yükünü oluşturmak için .NET 6.0 Runtime - .NET kullanılır.

1. Adım: Azure depolamayı ayarlama

Azure Depolama'yı kullanmak için onay almanız gerekir. Bu adımda, kiracıda Azure Depolama'nın yüklü olup olmadığını kontrol edersiniz; eğer yüklü değilse, bunu yüklersiniz.

  1. Azure portalına oturum açın.

  2. Kurumsal uygulamaları arayın ve arama sonuçlarından seçin.

  3. Uygulama türü filtre açılan listesinden Tüm uygulamalar'i seçin ve ardından Uygula'yı seçin.

  4. Arama kutusuna, uygulama adı veya nesne kimliğine göreAzure Depolamagirin.

  5. Azure Depolama listelenmiyorsa, PowerShell yönetici olarak açın ve aşağıdaki komutları çalıştırın:

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

2. Adım: Örneği indirme

Örnek iş yükünü çalıştırmak için bu adımları izleyin.

  1. Örnek Proje Dizini deposuna gidin, Kod'a ve ardından ZIP İndir'e tıklayın.

  2. Zip dosyasının içeriğini makinenizdeki yerel bir dizine ayıklayın. Microsoft-Fabric-workload-development-sample-main adlı yeni bir klasör oluşturulur.

3. Adım: Kiracı kimliğinizi alma

Kiracı kimliğinizi almak için bu adımları izleyin.

  1. İş yükünü oluşturmak için kullanmak istediğiniz kullanıcıyla Doku'da oturum açın.

  2. Yardım ve Destek (soru işareti ?) seçin ve ardından Hakkında seçin.

  3. Kiracı URL'sindenhttps://app.powerbi.com/home?ctid=sonra sayı ve harf dizesini kopyalayın. Bu dize kiracı kimliğinizi gösterir.

    Örneğin, kiracı URL'niz https://app.powerbi.com/home?ctid=bbbbcccc-1111-dddd-2222-eeee3333ffffise kiracı kimliğiniz bbbbcccc-1111-dddd-2222-eeee3333ffff.

4. Adım: Microsoft Entra ID uygulaması oluşturma

Microsoft Entra ID uygulaması oluşturmak için sağlanan betiği kullanın.

  1. PowerShellaçın.

  2. Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Authentication klasörüne gidin.

  3. Bu adımda komutunu çalıştırın. Kimlik doğrulaması yapmak için, iş yükünü oluşturmak için kullandığınız kullanıcının kimlik bilgilerini kullanın.

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

  4. Komut dosyasının çıktısından aşağıdaki ayrıntıları kopyalayın:

    • ApplicationIdUri / Audience - Örneğin, api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR
    • Yeniden YönlendirmeURI'si - http://localhost:60006/close
    • Uygulama Kimliği - Örneğin, 00001111-aaaa-2222-bbbb-3333cccc4444
    • gizli - Örneğin, aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2

5. Adım: .env.dev dosyasını güncelleştirme

  1. Microsoft-Fabric-workload-development-sample-main klasörüne gidin ve Ön Uç klasörüne gidin.

  2. .env.dev dosyasını bir metin düzenleyicisiyle açın.

  3. Aşağıdaki ayrıntıları girin:

    • DEV_AAD_CONFIG_AUDIENCE= - Betik çıktısındaki hedef grup. Örneğin, DEV_AAD_CONFIG_AUDIENCE=api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR.
    • DEV_AAD_CONFIG_APPID= - Betik çalıştırıldıktan sonra elde edilen uygulama kimliği. Örneğin, DEV_AAD_CONFIG_APPID=00001111-aaaa-2222-bbbb-3333cccc4444.

  4. .env.dev dosyasını kaydedin.

6. Adım: Ön ucu çalıştırma

PowerShell açın ve aşağıdakileri yapın:

  1. Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Frontend klasörüne gidin.

  2. Bağımlılıkları yüklemek için npm installkomutunu çalıştırın. node_modules adlı yeni bir klasör oluşturulur.

  3. Ön ucu başlatmak için npm startkomutunu çalıştırın.

    Ön uç başarıyla çalıştırıldıktan sonra PowerShell'de başarıyla içeren bir ileti görürsünüz ve web tarayıcınız http://localhost:60006/ URL'si ile açılır. Ön ucun başarıyla çalışıp çalışmadığını denetlemek için tarayıcınızda http://localhost:60006/manifestsadresine gidin.

7. Adım: Visual Studio'yu açma

Bu hızlı başlangıçtaki adımların geri kalanı Visual Studio'da gerçekleştirilir. Çözümünüzü Visual Studio'da açmak için bu adımı kullanın. Çözümünüz açıldıktan sonra, kalan adımları tamamlarken Visual Studio'yu açık tutabilirsiniz.

  1. Microsoft-Fabric-workload-development-sample-main klasörüne gidin ve Backend klasörüne gidin.

  2. Visual Studio'daFabric_Extension_BE_Boilerplate.sln dosyasını açın.

8. Adım: Arka uç dosyalarını güncelleştirme

  1. Çözüm Gezgini'de, Fabric_Extension_BE_Boilerplate öğesini açın ve appsettings.json dosyasını açarak aşağıdaki alanları doldurun:

    • PublisherTenantId - Kiracı kimliğiniz. Örneğin, PublisherTenantId: "bbbbcccc-1111-dddd-2222-eeee3333ffff".
    • ClientId - Betik çıktısından Uygulama Kimliği. Örneğin, ClientId: "00001111-aaaa-2222-bbbb-3333cccc4444".
    • ClientSecret - Betik çıktısından gizli anahtar. Örneğin, ClientSecret: "aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2".
    • Audience - Betik çıktısından ApplicationIdUri / Audience. Örneğin, Audience: "api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR".

  2. appsettings.json dosyasını kaydedin.

  3. Çözüm Gezgini'nde, > manifesti klasörünü genişletin ve WorkloadManifest.xml dosyasını açın ve aşağıdaki alanları doldurun:

    • AppID - Uygulama Kimliğiniz. Örneğin, <AppId>00001111-aaaa-2222-bbbb-3333cccc4444</AppId>.
    • RedirectUri - Yeniden yönlendirme URI'niz. <RedirectUri>http://localhost:60006/close</RedirectUri>.
    • ResourceId - Betiğin çıktısında bulunan ApplicationIdUri / Audience. Örneğin, <ResourceId>api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR</ResourceId>.

  4. WorkloadManifest.xml dosyasını kaydedin.

9. Adım: NuGet paketini derleme

  1. Visual Studio menüsünden Derleme > Derleme Çözümüöğesini seçin. Derleme, ön uç ve arka uç XML ve JSON dosyalarını içeren bir NuGet paketi oluşturur.

  2. Çıktı penceresinden, 1 ile başlayan satırda listelenen yolu alın:>Başarıyla oluşturulan paket.

    Bu çıkış örneğinde yol kalın harflerle vurgulanır. 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.

10. Adım: Yerel sürücünüze kopyalama

  1. Çözüm Gezginiworkload-dev-mode.json dosyasını açın.

  2. Aşağıdaki alanları doldurun:

    • WorkspaceGuid - Fabric çalışma alanı kimliğiniz.

      Kullandığınız çalışma alanında Fabric'e giderek çalışma alanı kimliğinizi bulabilirsiniz. Çalışma alanına girdikten sonra URL'den https://app.powerbi.com/groups/sonra sayı ve harf dizesini kopyalayın. Çalışma alanı kimliği eğik çizgiyle biter. Örneğin, çalışma alanı URL'niz https://app.powerbi.com/groups/bbbbcccc-1111-dddd-2222-eeee3333ffff/list?experience=power-biise çalışma alanı kimliğiniz bbbbcccc-1111-dddd-2222-eeee3333ffff.

    • ManifestPackageFilePath - Bildirim paketi dosyasının yolu (9. adım). Örneğin, "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. workload-dev-mode.json dosyasını kaydedin.

  4. workload-dev-mode.json dosyasını src/Config'dan C:\'e kopyalayın.

11. Adım: Şablonu çalıştırma

  1. Visual Studio 2022'de, menüden IIS Express yanındaki oku seçin ve açılan menüden Boilerplate seçin.

  2. Şablon seçin ve Visual Studio'nun isteklerini yetkilendirin. Çalışan çözüm hakkında bilgi içeren bir komut istemi açılır.

12. Adım: DevGateway dosyasını çalıştırma

Uyarı

Windows kullanmıyorsanız DevGateway Kapsayıcısı'nda açıklandığı gibi DevGateway'i bir Docker kapsayıcısında çalıştırmanız gerekir.

  1. PowerShell açın ve DevGateway klasörüne gidin.

  2. PowerShell'de şu komutu çalıştırın: .\Microsoft.Fabric.Workload.DevGateway.exe. Çıktıda bilgi: DevGateway başladı mesajı görüntülendiğinde. iş yükü başarıyla çalışıyor.

    10. adımdakiworkload-dev-mode.json dosyayı belirli bir klasöre kaydettiyseniz parametresiyle DevMode:LocalConfigFilePath komutunu çalıştırın.

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

13. Adım: Fabric'te örnek iş yükünü açın

Bahşiş

Fabric'de örnek iş yükünü açmak için üç PowerShell penceresi açmanız ve çalıştırıyor olmanız gerekir:

  • Ön uç - 6. Adım'da açıklandığı gibi komutunun npm start çalıştığı bir PowerShell.
  • Ortak-11. Adımda açıklandığı gibi, ortak değeri çalıştıran bir PowerShell.
  • DevGateway - 12. Adım'da açıklandığı gibi çalıştıran DevGateway.exebir PowerShell.

  1. Microsoft Fabric'i açın.

  2. Geliştirme için kullandığınız çalışma alanına gidin.

  3. Yeni öğe seçin.

  4. Örnek Öğe (önizleme)açın.

İlgili içerik

  • Last updated on