Κοινή χρήση μέσω

Γρήγορη εκκίνηση - Εκτέλεση δείγματος φόρτου εργασίας

  • Άρθρο

Αυτός ο οδηγός γρήγορης εκκίνησης σάς δείχνει πώς μπορείτε να δημιουργήσετε και να εκτελέσετε έναν φόρτο εργασίας Microsoft Fabric χρησιμοποιώντας ένα δείγμα φόρτου εργασίας.

Αυτό το δείγμα παρουσιάζει την αποθήκευση και την ανάγνωση δεδομένων από και προς λίμνες. Για να το κάνετε αυτό, πρέπει να δημιουργήσετε διακριτικά για την υπηρεσία υπηρεσίας αποθήκευσης Azure σε ροέςBehalf-Of (OBO).

Προαπαιτούμενα στοιχεία

  • Ένα περιβάλλον που έχει ρυθμιστεί για την ανάπτυξη φόρτου εργασίας.

  • Εάν χώρου αποθήκευσης Azure δεν έχει εγκατασταθεί στον μισθωτή σας, πρέπει να είστε καθολικός διαχειριστής στον μισθωτή.

  • ASP.NET Core Runtime 6.0 - το ASP.NET Core χρησιμοποιείται για τη δημιουργία του δείγματος φόρτου εργασίας.

  • .NET 6.0 χρόνου εκτέλεσης - Το .NET χρησιμοποιείται για τη δημιουργία του δείγματος φόρτου εργασίας.

Βήμα 1: Ρύθμιση χώρου αποθήκευσης Azure

Χρειάζεστε τη συγκατάθεσή σας για να χρησιμοποιήσετε την Υπηρεσία αποθήκευσης Azure. Σε αυτό το βήμα ελέγχετε εάν η Υπηρεσία αποθήκευσης Azure είναι εγκατεστημένη στον μισθωτή και, εάν δεν είναι, την εγκαθιστάτε.

  1. Συνδεθείτε στοπύλης Azure.

  2. Κάντε αναζήτηση για εφαρμογές Enterprise και επιλέξτε τις από τα αποτελέσματα αναζήτησης.

  3. Από την αναπτυσσόμενη λίστα Τύπος εφαρμογής , επιλέξτε Όλες οι εφαρμογές και, στη συνέχεια, επιλέξτε Εφαρμογή.

  4. Στο Αναζήτηση με βάση το όνομα εφαρμογής ή το αναγνωριστικό αντικειμένου πλαίσιο αναζήτησης, πληκτρολογήστε υπηρεσία αποθήκευσης Azure.

  5. Εάν δεν εμφανίζεται το υπηρεσίας αποθήκευσης Azure , ανοίξτε το PowerShell ως διαχειριστής και εκτελέστε τις ακόλουθες εντολές:

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

Βήμα 2: Λήψη του δείγματος

Ακολουθήστε αυτά τα βήματα για να εκτελέσετε το δείγμα φόρτου εργασίας.

  1. Μεταβείτε στο αποθετήριο δείγματος Project Directory, επιλέξτε Code και, στη συνέχεια, επιλέξτε Λήψη zip.

  2. Εξαγάγετε τα περιεχόμενα του αρχείου zip σε έναν τοπικό κατάλογο στον υπολογιστή σας. Δημιουργείται ένας νέος φάκελος που ονομάζεται Microsoft-Fabric-workload-development-sample-main.

Βήμα 3: Λήψη του αναγνωριστικού μισθωτή σας

Ακολουθήστε αυτά τα βήματα για να λάβετε το αναγνωριστικό μισθωτή σας.

  1. Συνδεθείτε στο Fabric με τον χρήστη που θέλετε να χρησιμοποιήσετε για να δημιουργήσετε τον φόρτο εργασίας.

  2. Επιλέξτε το Βοήθεια & υποστήριξης (το ερωτηματικό ?) και, στη συνέχεια, επιλέξτε Πληροφορίες για.

  3. Από το διεύθυνση URL μισθωτή, αντιγράψτε τη συμβολοσειρά αριθμών και γραμμάτων μετά https://app.powerbi.com/home?ctid=. Αυτό είναι το αναγνωριστικό μισθωτή σας.

    Για παράδειγμα, εάν η διεύθυνση URL μισθωτή σας είναι https://app.powerbi.com/home?ctid=bbbbcccc-1111-dddd-2222-eeee3333ffff, το αναγνωριστικό μισθωτή σας είναι bbbbcccc-1111-dddd-2222-eeee3333ffff.

Βήμα 4: Δημιουργία εφαρμογής αναγνωριστικού Microsoft Entra

Χρησιμοποιήστε την παρεχόμενη δέσμη ενεργειών για να δημιουργήσετε μια εφαρμογή αναγνωριστικού Azure Entra.

  1. Ανοίξτε το PowerShell.

  2. Μεταβείτε στο φάκελο Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Authentication.

  3. Εκτελέστε την εντολή σε αυτό το βήμα. Για τον έλεγχο ταυτότητας, χρησιμοποιήστε τα διαπιστευτήρια του χρήστη που χρησιμοποιείτε για να δημιουργήσετε τον φόρτο εργασίας.

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

  4. Αντιγράψτε τις παρακάτω λεπτομέρειες από το αποτέλεσμα της δέσμης ενεργειών:

    • ApplicationIdUri / ακροατηρίου - Για παράδειγμα, api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR
    • - http://localhost:60006/close Ανακατεύθυνσης
    • Αναγνωριστικό εφαρμογής - Για παράδειγμα, 00001111-aaaa-2222-bbbb-3333cccc4444
    • μυστικό - Για παράδειγμα, aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2

Βήμα 5: Ενημέρωση του αρχείου .env.dev

  1. Μεταβείτε στον φάκελο Microsoft-Fabric-workload-development-sample-main και μεταβείτε στον φάκελο Frontend.

  2. Ανοίξτε το αρχείο .env.dev με ένα πρόγραμμα επεξεργασίας κειμένου.

  3. Πληκτρολογήστε τις ακόλουθες λεπτομέρειες:

    • DEV_AAD_CONFIG_AUDIENCE= - Το κοινό από το αποτέλεσμα της δέσμης ενεργειών. Για παράδειγμα, DEV_AAD_CONFIG_AUDIENCE=api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR.
    • DEV_AAD_CONFIG_APPID= - Το αναγνωριστικό εφαρμογής από το αποτέλεσμα της δέσμης ενεργειών. Για παράδειγμα, DEV_AAD_CONFIG_APPID=00001111-aaaa-2222-bbbb-3333cccc4444.

  4. Αποθηκεύστε το αρχείο .env.dev.

Βήμα 6: Εκτέλεση του προσκηνίου

Ανοίξτε PowerShell και κάντε τα εξής:

  1. Μεταβείτε στον φάκελο Microsoft-Fabric-workload-development-sample-main\Microsoft-Fabric-workload-development-sample-main\Frontend.

  2. Για να εγκαταστήσετε τις εξαρτήσεις, εκτελέστε την εντολή npm install. Δημιουργείται ένας νέος φάκελος με την ονομασία node_modules.

  3. Για να ξεκινήσετε το προσκήνιο, εκτελέστε την εντολή npm start.

    Όταν ολοκληρωθεί με επιτυχία η εκτέλεση του προσκηνίου, θα δείτε ένα μήνυμα που περιλαμβάνει με επιτυχία στο PowerShell και το πρόγραμμα περιήγησης web θα ανοίξει με τη διεύθυνση URL του http://localhost:60006/. Για να ελέγξετε ότι το frontend εκτελείται με επιτυχία, στο πρόγραμμα περιήγησής σας, μεταβείτε στο http://localhost:60006/manifests.

Βήμα 7: Άνοιγμα του Visual Studio 2022

Τα υπόλοιπα βήματα σε αυτήν τη γρήγορη εκκίνηση εκτελούνται στο Visual Studio 2022. Χρησιμοποιήστε αυτό το βήμα για να ανοίξετε τη λύση σας στο Visual Studio 2022. Όταν η λύση σας είναι ανοιχτή, μπορείτε να διατηρήσετε το Visual Studio ανοιχτό όσο ολοκληρώνετε τα υπόλοιπα βήματα.

  1. Μεταβείτε στον φάκελο Microsoft-Fabric-workload-development-sample-main και μεταβείτε στον φάκελο παρασκηνίου.

  2. Στο Visual Studio 2022, ανοίξτε το αρχείο Fabric_Extension_BE_Boilerplate.sln.

Βήμα 8: Ενημέρωση των αρχείων παρασκηνίου

  1. Στην Εξερεύνηση λύσεων, αναπτύξτε Fabric_Extension_BE_Boilerplate και ανοίξτε το αρχείο appsettings.json και συμπληρώστε τα ακόλουθα πεδία:

    • PublisherTenantId - Το αναγνωριστικό μισθωτή σας. Για παράδειγμα, PublisherTenantId: "bbbbcccc-1111-dddd-2222-eeee3333ffff".
    • ClientId - Το αναγνωριστικό εφαρμογής από το αποτέλεσμα της δέσμης ενεργειών. Για παράδειγμα, ClientId: "00001111-aaaa-2222-bbbb-3333cccc4444".
    • ClientSecret - Η μυστική από την έξοδο της δέσμης ενεργειών. Για παράδειγμα, ClientSecret: "aaaaa~0b0b0b0b0b0b0b0b0b.bb~2d2d2d2d2d2d2".
    • audience - Το ApplicationIdUri / Audience από το αποτέλεσμα της δέσμης ενεργειών. Για παράδειγμα, Audience: "api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR".

  2. Αποθηκεύστε το αρχείο appsettings.json.

  3. Στην Εξερεύνηση λύσεων, αναπτύξτε τον φάκελο Πακέτα > και ανοίξτε το αρχείο WorkloadManifest.xml και συμπληρώστε τα ακόλουθα πεδία:

    • AppID - Το αναγνωριστικό εφαρμογής σας. Για παράδειγμα, <AppId>00001111-aaaa-2222-bbbb-3333cccc4444</AppId>.
    • RedirectUri - Το URI ανακατεύθυνσης. <RedirectUri>http://localhost:60006/close</RedirectUri>.
    • ResourceId - Το ApplicationIdUri / Audience από το αποτέλεσμα της δέσμης ενεργειών. Για παράδειγμα, <ResourceId>api://localdevinstance/<your-tenant-id>/Org.WorkloadSample/OyR</ResourceId>.

  4. Αποθηκεύστε το αρχείο WorkloadManifest.xml.

Βήμα 9: Δημιουργία του πακέτου NuGet

  1. Από το μενού Visual Studio, επιλέξτε Δημιουργία > Δομή λύσης. Η δόμηση δημιουργεί ένα πακέτο NuGet που περιλαμβάνει τα αρχεία XML και JSON προσκηνίου και παρασκηνίου.

  2. Από το παράθυρο εξόδου , κάντε λήψη της διαδρομής που παρατίθεται στη γραμμή, ξεκινώντας με 1πακέτο που δημιουργήθηκε με επιτυχία.

    Σε αυτό το παράδειγμα εξόδου, η διαδρομή επισημαίνεται με έντονη γραφή. 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: Αντιγραφή στην τοπική μονάδα δίσκου

  1. Στην Εξερεύνηση λύσεων, ανοίξτε το αρχείο workload-dev-mode.json.

  2. Συμπληρώστε τα παρακάτω πεδία:

    • WorkspaceGuid - Το αναγνωριστικό του χώρου εργασίας σας Fabric.

      Μπορείτε να βρείτε το αναγνωριστικό χώρου εργασίας σας μεταβαίνοντας στον χώρο εργασίας που χρησιμοποιείτε στο Fabric. Όταν βρίσκεστε στον χώρο εργασίας, από τη διεύθυνση URL αντιγράψτε τη συμβολοσειρά αριθμών και γραμμάτων μετά https://app.powerbi.com/groups/. Το αναγνωριστικό χώρου εργασίας τελειώνει με κάθετο. Για παράδειγμα, εάν η διεύθυνση URL του χώρου εργασίας σας είναι https://app.powerbi.com/groups/bbbbcccc-1111-dddd-2222-eeee3333ffff/list?experience=power-bi, το αναγνωριστικό του χώρου εργασίας σας είναι bbbbcccc-1111-dddd-2222-eeee3333ffff.

    • ManifestPackageFilePath - Η διαδρομή του αρχείου πακέτου διακήρυξης (βήμα 9). Για παράδειγμα, "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.

  4. Αντιγράψτε το αρχείο workload-dev-mode.json από το src/Config στο C:\.

Βήμα 11: Εκτελέστε την πινακίδα του λέβητα

  1. Στο Visual Studio 2022, από το μενού, επιλέξτε το βέλος δίπλα στο στοιχείο IIS Express και από το αναπτυσσόμενο μενού επιλέξτε Boilerplate.

  2. Επιλέξτε Boilerplate και εξουσιοδοτήστε τα αιτήματα του Visual Studio. Ανοίγει μια γραμμή εντολών με πληροφορίες σχετικά με την τρέχουσα λύση.

Βήμα 12: Εκτέλεση του αρχείου DevGateway

  1. Ανοίξτε PowerShell και μεταβείτε στον φάκελο DevGateway.

  2. Στο PowerShell, εκτελέστε την εντολή: .\Microsoft.Fabric.Workload.DevGateway.exe. Όταν το αποτέλεσμα εμφανίζει το μήνυμα πληροφορίες: Το DevGateway ξεκίνησε. ο φόρτος εργασίας εκτελείται με επιτυχία.

Βήμα 13: Ανοίξτε το δείγμα φόρτου εργασίας στο Fabric

Φιλοδώρημα

Για να ανοίξετε το δείγμα φόρτου εργασίας στο Fabric, πρέπει να έχετε τρία παράθυρα PowerShell ανοικτά και σε λειτουργία:

  • Frontend - Εκτελείται ένα Powershell με την εντολή npm start, όπως περιγράφεται στο βήμα 6 .
  • Boilerplate - Ένα Powershell που εκτελεί τη πινακίδα, όπως περιγράφεται στο βήμα 11 .
  • DevGateway - Ένα DevGateway.exepowershell που εκτελείται , όπως περιγράφεται στο βήμα 12 .

  1. Ανοίξτε το Microsoft Fabric.

  2. Μεταβείτε στον χώρο εργασίας που χρησιμοποιείτε για την ανάπτυξη.

  3. Επιλέξτε νέο στοιχείο.

  4. Ανοίξτε δείγμα στοιχείου (προεπισκόπηση).

Σχετικό περιεχόμενο