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


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

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

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

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

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

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

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

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

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

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

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

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

  1. Κλωνοποιήστε το αποθετήριο: Κλωνοποιήστε το αποθετήριο που βρίσκεται εδώ: https://go.microsoft.com/fwlink/?linkid=2272254

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

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

    npm start
    

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

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

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

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

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

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

  1. Κλωνοποιήστε την πλάκα: Κλωνοποιήστε το έργο στερεότυπης πλάκας που βρίσκεται εδώ: https://go.microsoft.com/fwlink/?linkid=2272254

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

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

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

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

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

    Σημείωμα

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

    • CapacityGuid: Το αναγνωριστικό εκχωρημένων πόρων σας βρίσκεται στην πύλη Fabric στην Ρυθμίσεις εκχωρημένων πόρων της πύλης διαχείρισης.

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

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

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

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

    • Appid
    • ResourceID
    • RedirectURI
  7. Δημιουργία πακέτου διακήρυξης: Δημιουργήστε τη λύση για να δημιουργήσετε το αρχείο πακέτου διακήρυξης, το οποίο περιλαμβάνει επικύρωση και συσκευασία των απαραίτητων αρχείων 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.

  8. Εκτελέστε το DevGateway: Εκτελέστε "Microsoft.Fabric.Workload.DevGateway.exe" και πραγματοποιήστε έλεγχο ταυτότητας ως διαχειριστής εκχωρημένων πόρων.

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

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

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