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


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

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

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

Προτού ξεκινήσετε, βεβαιωθείτε ότι έχετε εγκαταστήσει τα ακόλουθα στο σύστημά σας:

Οδηγός βήματος

Ενεργοποίηση προσαρμοσμένων φόρτων εργασίας

Ρυθμίστε τις παραμέτρους της πύλης διαχείρισης ως εξής:

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

  2. Από την περιοχή Ρυθμίσεις, μεταβείτε στην πύλη διαχείρισης.

    Στιγμιότυπο οθόνης που δείχνει πώς μπορείτε να μεταβείτε στην πύλη διαχείρισης Fabric.

  3. Στην ενότητα Πρόσθετοι φόρτοι εργασίας, ενεργοποιήστε τη ρύθμιση μισθωτή Διαχειριστές εκχωρημένων πόρων και συμβάλλοντες στην προσθήκη και κατάργηση επιπλέον φόρτων εργασίας. Μπορείτε να την ενεργοποιήσετε για ολόκληρο τον οργανισμό ή συγκεκριμένες ομάδες.

Ρύθμιση του δείγματος έργου

  1. Κλωνοποιήστε το αποθετήριο: Κλωνοποιήστε το αποθετήριο δεδομένων εδώ: Δείγμα καταλόγου έργου

  2. Εγκατάσταση εξαρτήσεων: Μεταβείτε στον Frontend κατάλογο στο κλωνοποιημένο αποθετήριο δεδομένων και εκτελέστε την ακόλουθη εντολή:

    npm install
    
  3. Εκκίνηση του τοπικού διακομιστή: Εκκινήστε έναν τοπικό διακομιστή Node.js χρησιμοποιώντας την webpack εκτέλεση:

    npm start
    

    Ο διακομιστής συνήθως εκτελείται στη θύρα 60006. Επιβεβαιώστε ότι ο διακομιστής λειτουργεί, μεταβαίνοντας και ελέγχοντας 127.0.0.1:60006/manifests το αρχείο ρύθμισης παραμέτρων .env.dev στον φάκελο προσκηνίων.

  4. Ενεργοποίηση λειτουργίας προγραμματιστή προσκηνίου: Στις ρυθμίσεις μισθωτή στην πύλη διαχείρισης, στην ενότητα Πρόσθετοι φόρτοι εργασίας και ενεργοποιήστε τους διαχειριστές εκχωρημένων πόρων μπορείτε να αναπτύξετε πρόσθετους φόρτους εργασίας. Ρύθμιση μισθωτή. Αυτή η ρύθμιση επιτρέπει τις συνδέσεις στον τοπικό διακομιστή σας και διατηρείται σε περιόδους λειτουργίας προγράμματος περιήγησης.

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

Όταν ο τοπικός διακομιστής εκτελεστεί και ενεργοποιηθεί η λειτουργία προγραμματιστή, το νέο δείγμα φόρτου εργασίας εμφανίζεται στο μενού.

  1. Πρόσβαση στο δείγμα φόρτου εργασίας: Για να ξεκινήσετε την εμπειρία Δημιουργία, μεταβείτε στην αρχική σελίδα δείγματος φόρτου εργασίας.

Προετοιμασία του περιβάλλοντος ανάπτυξης

  1. Ανοίξτε τη λύση: Ανοίξτε τη λύση στο Visual Studio 2022 για να εξασφαλίσετε τη συμβατότητα με το net7.

  2. Καταχώρηση εφαρμογής: Ακολουθήστε τον οδηγό ελέγχου ταυτότητας για να ρυθμίσετε τον έλεγχο ταυτότητας αναγνωριστικού Microsoft Entra για ασφαλείς αλληλεπιδράσεις εντός της αρχιτεκτονικής.

  3. Ενημέρωση διεύθυνσης URL βάσης OneLake DFS: Τροποποιήστε το EnvironmentConstants.cs αρχείο στον src/Constants/ φάκελο ώστε να ταιριάζει με το περιβάλλον σας.

  4. Ρύθμιση παραμέτρων φόρτου εργασίας: Ενημέρωση src/Config/workload-dev-mode.json και src/appsettings.json με συγκεκριμένες λεπτομέρειες ρύθμισης παραμέτρων:

    • Αντιγράψτε workload-dev-mode.json από το src/Config και C:\ ενημερώστε τα παρακάτω πεδία ώστε να συμφωνούν με τις ρυθμίσεις παραμέτρων σας:

    Σημείωμα

    Μπορείτε να το αντιγράψετε σε οποιαδήποτε άλλη διαδρομή και να ρυθμίσετε το όρισμα γραμμής εντολών "-DevMode:LocalConfigFilePath" στο έργο σας για να καθορίσετε τη διαδρομή.

    • WorkspaceGuid: Το αναγνωριστικό του χώρου εργασίας σας. Βρείτε το στη διεύθυνση URL του προγράμματος περιήγησης όταν επιλέγετε έναν χώρο εργασίας στο Fabric, για παράδειγμα, https://app.fabric.microsoft.com/groups/{WorkspaceID}/.

    • ManifestPackageFilePath: Η θέση του πακέτου διακήρυξης. Όταν δημιουργείτε τη λύση, αποθηκεύει το πακέτο διακήρυξης στο src\bin\Debug. Μπορείτε να βρείτε περισσότερες λεπτομέρειες σχετικά με το πακέτο διακήρυξης στα επόμενα βήματα.

    • Φόρτος εργασίαςEndpointURL: Διεύθυνση URL τελικού σημείου φόρτου εργασίας.

    • Στο αρχείο src/appsettings.json, ενημερώστε τα παρακάτω πεδία ώστε να συμφωνούν με τις ρυθμίσεις παραμέτρων σας:

      • PublisherTenantId: Το αναγνωριστικό του μισθωτή εκδότη φόρτου εργασίας.
      • ClientId: Αναγνωριστικό προγράμματος-πελάτη (AppID) της εφαρμογής Microsoft Entra του φόρτου εργασίας.
      • ClientSecret: Ο μυστικός κωδικός για την εφαρμογή Microsoft Entra φόρτου εργασίας.
      • Κοινό: Το κοινό για τα εισερχόμενα διακριτικά Microsoft Entra βρίσκεται στην καταχώρηση της εφαρμογής σας που δημιουργήσατε στην ενότητα "Έκθεση API". Αυτό αναφέρεται επίσης ως το Αναγνωριστικό εφαρμογής URI.
  5. Ρύθμιση παραμέτρων του αρχείου WorkloadManifest.xml: Ρυθμίστε τις παραμέτρους του αρχείου WorkloadManifest.xml με τις παρακάτω λεπτομέρειες εφαρμογής Microsoft Entra:

    • Αναγνωριστικό εφαρμογής
    • ResourceID
    • RedirectURI
  6. Δημιουργία πακέτου διακήρυξης: Δημιουργήστε τη λύση για να δημιουργήσετε το αρχείο πακέτου διακήρυξης, το οποίο περιλαμβάνει επικύρωση και συσκευασία των απαραίτητων αρχείων XML και JSON.

    • Ενεργοποίηση Fabric_Extension_BE_Boilerplate_WorkloadManifestValidator.exe στον workloadManifest.xml στον κατάλογο Packages\manifest\files\ (μπορείτε να βρείτε τον κώδικα της διαδικασίας επικύρωσης στον κατάλογο \workloadManifestValidator). Εάν αποτύχει η επικύρωση, δημιουργείται ένα αρχείο σφάλματος που καθορίζει την αποτυχημένη επικύρωση.
    • Εάν το αρχείο σφάλματος υπάρχει, η δόμηση αποτυγχάνει με "Σφάλμα επικύρωσης workloadManifest". Μπορείτε να κάνετε διπλό κλικ στο σφάλμα στο VS Studio και θα εμφανιστεί το αρχείο σφάλματος.
    • Μετά την επιτυχή επικύρωση, συσκευάστε τα αρχεία WorkloadManifest.xml και FrontendManifest.json στο ManifestPackage.1.0.0.nupkg. Το πακέτο που προκύπτει μπορεί να βρεθεί στο src\bin\Debug.

    Αντιγράψτε το αρχείο ManifestPackage.1.0.0.nupkg στη διαδρομή που ορίζεται στο αρχείο ρύθμισης παραμέτρων workload-dev-mode.json.

  7. Εκτελέστε το DevGateway: Εκτελέστε "Microsoft.Fabric.Workload.DevGateway.exe" και εισέλθετε με έναν χρήστη που διαθέτει δικαιώματα διαχειριστή χώρου εργασίας για τον χώρο εργασίας που καθορίζεται στο WorkspaceGuid πεδίο της workload-dev-mode.json.

  8. Ξεκινήστε το Έργο: Ορίστε το έργο "Boilerplate" ως το έργο εκκίνησης στο Visual Studio και εκτελέστε το.

Πρόσθετα βήματα

  • Ενημερώστε τα αρχεία ρύθμισης παραμέτρων φόρτου εργασίας, ανάλογα με τις ανάγκες.
  • Δημιουργήστε τη λύση για να εξασφαλίσετε ότι όλες οι εξαρτήσεις συνδέονται σωστά.
  • Εκτελέστε το frontend και devgateway για να δημιουργήσετε επικοινωνία με το παρασκήνιο Fabric.
  • Δημιουργήστε στοιχεία και εκτελέστε εργασίες για να ελέγξετε τις πλήρεις δυνατότητες του φόρτου εργασίας σας.