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

Διακήρυξη φόρτου εργασίας

  • Άρθρο

Επισκόπηση

Τα WorkloadManifest.xml αρχεία και Item.xml απαιτούνται για τον ορισμό φόρτου εργασίας στο Fabric. Διαθέτουν για ρύθμιση τις βασικές ρυθμίσεις παραμέτρων των Στοιχείων φόρτου εργασίας και φόρτου εργασίας και λειτουργούν ως οδηγός για τη ρύθμιση και τη διαχείριση φόρτου εργασίας, βοηθώντας στον καθορισμό, την κοινή χρήση και την εγγραφή βασικών λεπτομερειών φόρτου εργασίας για ομαλή ενοποίηση στο Fabric.

Στο δείγμα αποθετηρίου δεδομένων μας, ένα .nupkg αρχείο δημιουργείται από τα αρχεία XML που βρίσκονται στον src/Packages/manifest φάκελο κατά τη διαδικασία δόμησης. Αυτό το αρχείο πακέτου περιέχει όλες τις απαραίτητες πληροφορίες σχετικά με τον φόρτο εργασίας σας. workload-dev-mode.json Στο αρχείο, υπάρχει ένα πεδίο που ονομάζεται ManifestPackageFilePath που θα πρέπει να παραπέμπει σε αυτό το αρχείο που μόλις δημιουργήθηκε.nupkg.

Διαδικασία αποστολής και εγγραφής

  1. Έλεγχος ταυτότητας χρήστη: Κατά τη διάρκεια της ανάπτυξης, όταν εκτελείται το δείγμα, ο έλεγχος ταυτότητας ξεκινά τη διαδικασία αποστολής και καταχώρησης. Αυτό εξασφαλίζει τη σωστή συσχέτιση του φόρτου εργασίας με την ταυτότητά σας.
  2. Ανάλυση διακήρυξης: Η διακήρυξη που αποστείλεται υποβάλλεται σε ανάλυση για να επικυρώσει τη δομή και το περιεχόμενό της. Αυτό το βήμα εξασφαλίζει ότι η διακήρυξη έχει μορφοποιηθεί σωστά και είναι έτοιμη για περαιτέρω επεξεργασία.
  3. Καταχώρηση φόρτου εργασίας: Εάν η ανάλυση είναι επιτυχής, ο φόρτος εργασίας καταχωρείται στο Fabric. Βασικές λεπτομέρειες ρύθμισης παραμέτρων, όπως το αναγνωριστικό φόρτου εργασίας, αποθηκεύονται στη βάση δεδομένων Fabric, επιτρέποντας την αποτελεσματική διαχείριση φόρτου εργασίας.

Διακήρυξη φόρτου εργασίας - Βασικά στοιχεία διακήρυξης

Η διακήρυξη, της οποίας η δομή ορίζεται από το WorkloadDefinition.xsd, περιγράφει τα βασικά χαρακτηριστικά ενός φόρτου εργασίας, όπως το όνομα, η εφαρμογή και τα τελικά σημεία.

Χαρακτηριστικό schemaVersion

Αντιπροσωπεύει τη δημοσιευμένη έκδοση WorkloadDefinition.xsd του Fabric.

Χαρακτηριστικό WorkloadName

Το μοναδικό αναγνωριστικό του φόρτου εργασίας σας. Σημειώστε ότι απαιτείται να έχει έναν "οργανισμό". το πρόθημα για το workloadName, έτσι ώστε το όνομα να αποτελείται από δύο λέξεις με διαχωριστικό '.', π.χ. 'Org.MyWorkload'. Άλλα προθέματα δεν είναι έγκυρα και θα προκαλέσουν αποτυχία αποστολής. Αυτό θα επιβληθεί στα παρακάτω σενάρια: σύνδεση ανάπτυξης, Αποστολή δοκιμής.

Στοιχείο έκδοσης

Η έκδοση της διακήρυξης θα πρέπει να είναι συμβατή με το SemVer .

Στοιχείο CloudServiceConfiguration

Η ρύθμιση παραμέτρων υπηρεσίας του φόρτου εργασίας σας, προς το παρόν υποστηρίζεται μόνο μία ρύθμιση παραμέτρων.

Αναγνωριστικό Microsoft Entra [Azure Active Directory (AAD)] Ρύθμιση παραμέτρων εφαρμογών

Η <AADApp> ενότητα ρυθμίζει την εφαρμογή Microsoft Entra ID [Azure Active Directory (AAD)] για διαδικασίες ελέγχου ταυτότητας και εξουσιοδότησης. Το AppId αντιπροσωπεύει το μοναδικό αναγνωριστικό για την εφαρμογή σας, το RedirectUri καθορίζει το URI στο οποίο θα στείλει το αναγνωριστικό Microsoft Entra την απόκριση ελέγχου ταυτότητας καθώς και τα ResourceId σημεία του μοναδικού αναγνωριστικού για τον πόρο στον οποίο αποκτά πρόσβαση η εφαρμογή. Για περισσότερες πληροφορίες σχετικά με τα στοιχεία , ResourceIdAppIdκαι RedirectUri που αντιπροσωπεύονται, μπορείτε να ανατρέξετε στην τεκμηρίωση ελέγχου ταυτότητας.

<AADApp>
    <AppId>YourApplicationId</AppId>
    <RedirectUri>YourRedirectUri</RedirectUri>
    <ResourceId>YourResourceId</ResourceId>
</AADApp>

Συμβουλευτείτε την τεκμηρίωση ελέγχου ταυτότητας για να κατανοήσετε AppIdβαθύτερα τα στοιχεία , ResourceIdκαι RedirectUri τη σημασία τους στο πλαίσιο των διαδικασιών ελέγχου ταυτότητας.

Στοιχεία ServiceEndpoint

Αντιπροσωπεύουν τη ρύθμιση παραμέτρων ενός συγκεκριμένου λογικού τελικού σημείου, για παράδειγμα, το τελικό σημείο παρασκηνίου που περιλαμβάνει υλοποίηση για τα API CRUD και εργασιών του στοιχείου.

  • Η ρύθμιση παραμέτρων για το τελικό σημείο παρασκηνίου του φόρτου εργασίας αναφέρει τη διεύθυνση URL παρασκηνίου του φόρτου εργασίας σας.
<ServiceEndpoint>
    <Name>Workload</Name>
    <Url>YourWorkloadBackendUrl</Url>
    <IsEndpointResolutionService>...
    <EndpointResolutionContext>...
</ServiceEndpoint>
  • <IsEndpointResolutionService> Οι και EndpointResolutionContext ορίζονται με βάση το εάν το τελικό σημείο σας εφαρμόζει το API φόρτου εργασίας ή μόνο την επίλυση τελικού σημείου. Ανατρέξτε στο θέμα Ανάλυση τελικού σημείου για λεπτομερείς πληροφορίες σχετικά με το περιβάλλον επίλυσης και την απόκριση.

Σημείωμα

Η επίλυση τελικού σημείου για το Frontend δεν υποστηρίζεται.

Διακήρυξη στοιχείου - Στοιχεία διακήρυξης κλειδιού

Η διακήρυξη, της οποίας η δομή ορίζεται από το ItemDefinition.xsd, περιγράφει τα βασικά χαρακτηριστικά του στοιχείου ενός φόρτου εργασίας, όπως το όνομα και οι ορισμοί εργασίας.

Χαρακτηριστικό schemaVersion

Αντιπροσωπεύει τη δημοσιευμένη έκδοση ItemDefinition.xsd του Fabric.

Χαρακτηριστικό TypeName

Το μοναδικό αναγνωριστικό του στοιχείου σας.

Ρύθμιση παραμέτρων χρονοδιαγράμματος εργασίας

Η <JobScheduler> ενότητα περιλαμβάνει διάφορα στοιχεία που καθορίζουν τη συμπεριφορά και τις ρυθμίσεις του προγραμματισμού εργασιών, της παρακολούθησης και της διαχείρισης.

  • <OnDemandJobDeduplicateOptions> and <ScheduledJobDeduplicateOptions>: Καθορίστε επιλογές πολλαπλασιασμού για κατ' απαίτηση και προγραμματισμένες εργασίες στοιχείων, αντίστοιχα. Οι επιλογές περιλαμβάνουν None (χωρίς ανάλυση), PerItem (μία εργασία που εκτελείται για τον ίδιο τύπο στοιχείου και εργασίας) και PerUser (μία εργασία εκτελείται για τον ίδιο χρήστη και το ίδιο στοιχείο).
  • <ItemJobTypes>: Περιέχει ρυθμίσεις παραμέτρων για διαφορετικούς τύπους εργασιών στοιχείων.
  • <ItemJobType>: Περιγράφει έναν συγκεκριμένο τύπο εργασίας.
  • <Name>: Το όνομα του τύπου εργασίας. Πρέπει να χρησιμοποιήσετε το όνομα του στοιχείου ως πρόθεμα.

Για παράδειγμα, ας εξετάσουμε το δείγμα φόρτου εργασίας μας, ο οποίος περιλαμβάνει τρεις συγκεκριμένες εργασίες που ορίζονται στην <ItemJobTypes> ενότητα:

<JobScheduler>
    <OnDemandJobDeduplicateOptions>PerItem</OnDemandJobDeduplicateOptions>
    <ScheduledJobDeduplicateOptions>PerItem</ScheduledJobDeduplicateOptions>
    <ItemJobTypes>
    <ItemJobType Name="Org.WorkloadSample.SampleWorkloadItem.ScheduledJob" />
    <ItemJobType Name="Org.WorkloadSample.SampleWorkloadItem.CalculateAsText" />
    <ItemJobType Name="Org.WorkloadSample.SampleWorkloadItem.CalculateAsParquet" />
    </ItemJobTypes>
</JobScheduler>
  • CalculateAsText Job : Αυτός ο τύπος εργασίας χειρίζεται υπολογισμούς που βασίζονται σε κείμενο, λαμβάνοντας Operand1 και Operand2, εκτελώντας την επιλεγμένη λειτουργία και αποθηκεύοντας το αποτέλεσμα στο lakehouse.
  • CalculateAsParquet Job : Ειδικά προσαρμοσμένη για εργασία με δεδομένα Parquet, αυτός ο τύπος εργασίας λαμβάνει Operand1 επίσης και Operand2, εκτελεί την επιλεγμένη λειτουργία και αποθηκεύει το αποτέλεσμα στο lakehouse, ακολουθώντας τη μορφή δεδομένων Parquet. Ανατρέξτε στο θέμα Οδηγός κέντρου παρακολούθησης για περισσότερες πληροφορίες σχετικά με τις εργασίες και τις σχετικές ρυθμίσεις παραμέτρων.

Συνοπτικά, οι εκδηλώσεις φόρτου εργασίας και στοιχείου χρησιμεύουν ως έγγραφα υποδομής για την προσθήκη προσαρμοσμένων φόρτων εργασίας στο Fabric. Η διαδικασία ελέγχου ταυτότητας ενεργοποιεί μια απλή ακολουθία ενεργειών: αποστολή, ανάλυση και καταχώρηση, εξασφαλίζοντας κατάλληλη ρύθμιση παραμέτρων και αποτελεσματική διαχείριση φόρτου εργασίας εντός του οικοσυστήματος του Azure.