Μετασχηματισμός δεδομένων με την εκτέλεση σημειωματάριου

Χρησιμοποιήστε τη δραστηριότητα Σημειωματάριο για να εκτελέσετε σημειωματάρια που δημιουργείτε στο Microsoft Fabric ως μέρος των διοχετεύσεων Data Factory. Τα σημειωματάρια σάς επιτρέπουν να εκτελείτε εργασίες Apache Spark για να εισαγάγετε, να εκκαθαρίσετε ή να μετασχηματίσετε τα δεδομένα σας ως μέρος των ροών εργασιών δεδομένων σας. Είναι εύκολο να προσθέσετε μια δραστηριότητα σημειωματαρίου στις διοχετεύσεις σας στο Fabric και αυτός ο οδηγός σας καθοδηγεί σε κάθε βήμα.

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

Για να ξεκινήσετε, πρέπει να συμπληρώσετε τις ακόλουθες προϋποθέσεις:

Δημιουργία δραστηριότητας σημειωματάριου

  1. Δημιουργήστε μια νέα διοχέτευση στον χώρο εργασίας σας.

  2. Κάντε αναζήτηση για Σημειωματάριο στο τμήμα παραθύρου "Δραστηριότητες διοχέτευσης" και επιλέξτε το για να το προσθέσετε στον καμβά διοχέτευσης.

    Στιγμιότυπο οθόνης του περιβάλλοντος εργασίας χρήστη Fabric με επισημασμένο το παράθυρο

  3. Επιλέξτε τη νέα δραστηριότητα Σημειωματάριο στον καμβά, εάν δεν είναι ήδη επιλεγμένη.

    Στιγμιότυπο οθόνης που εμφανίζει την καρτέλα

    Ανατρέξτε στην καθοδήγηση Γενικές ρυθμίσεις για να ρυθμίσετε τις παραμέτρους της καρτέλας Γενικές ρυθμίσεις.

Ρύθμιση παραμέτρων σημειωματάριου

Επιλέξτε την καρτέλα Ρυθμίσεις.

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

Επιλέξτε ένα υπάρχον σημειωματάριο από το αναπτυσσόμενο μενού Σημειωματάριο και προαιρετικά καθορίστε τυχόν παραμέτρους που θα μεταβιβαστούν στο σημειωματάριο.

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

Χρήση του Fabric Workspace Identity (WI) στη δραστηριότητα "Σημειωματάριο"

  1. Δημιουργία της ταυτότητας χώρου εργασίας

    Πρέπει να ενεργοποιήσετε το WI στον χώρο εργασίας σας (μπορεί να χρειαστεί λίγος χρόνος για να φορτωθεί). Δημιουργήστε μια ταυτότητα χώρου εργασίας στον χώρο εργασίας σας Fabric. Σημειώστε ότι το WI θα πρέπει να δημιουργηθεί στον ίδιο χώρο εργασίας με τη διοχέτευσή σας.

    Ρίξτε μια ματιά στα έγγραφα σχετικά με την Ταυτότητα χώρου εργασίας.

  2. Ενεργοποίηση ρυθμίσεων σε επίπεδο μισθωτή

    Ενεργοποιήστε την ακόλουθη ρύθμιση μισθωτή (είναι απενεργοποιημένη από προεπιλογή): Οι κύριες υπηρεσίες μπορούν να καλέσουν Fabric δημόσια API.

    Μπορείτε να ενεργοποιήσετε αυτήν τη ρύθμιση στην πύλη διαχείρισης Fabric. Για περισσότερες πληροφορίες σχετικά με αυτήν τη ρύθμιση, ανατρέξτε στο άρθρο Ενεργοποίηση ελέγχου ταυτότητας κύριας υπηρεσίας για API διαχειριστή.

  3. Εκχώρηση δικαιωμάτων χώρου εργασίας στην ταυτότητα χώρου εργασίας

    Ανοίξτε τον χώρο εργασίας, επιλέξτε Διαχείριση πρόσβασης και εκχωρήστε δικαιώματα στην ταυτότητα χώρου εργασίας. Η πρόσβαση των συμβαλλόντων είναι επαρκής για τα περισσότερα σενάρια. Εάν το Σημειωματάριό σας δεν βρίσκεται στον ίδιο χώρο εργασίας με τη διοχέτευσή σας, θα πρέπει να εκχωρήσετε στο WI που δημιουργήσατε στον χώρο εργασίας της διοχέτευσής σας τουλάχιστον πρόσβαση Συμβάλλοντα στον χώρο εργασίας του Σημειωματαρίου σας.

    Ρίξτε μια ματιά στα έγγραφα στο Δώστε στους χρήστες πρόσβαση σε χώρους εργασίας.

Αυτόματη συμπλήρωση βασικών παραμέτρων για τη δραστηριότητα σημειωματαρίου

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

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

  • Το σημειωματάριό σας πρέπει να περιλαμβάνει ένα κελί παραμέτρων.
  • Μόνο οι μεταβλητές που ορίζονται σε αυτό το κελί ανιχνεύονται ως παράμετροι.

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

Πώς λειτουργεί

Όταν επιλέγετε ένα σημειωματάριο σε μια δραστηριότητα σημειωματαρίου:

  • Το σύστημα ανακτά αυτόματα παραμέτρους από το σημειωματάριο όταν κάνετε εναλλαγή στις Βασικές παραμέτρους στις Ρυθμίσεις.
  • Η ενότητα Βασικές παράμετροι συμπληρώνεται με:
    • Ονόματα
    • Τύποι
    • Προεπιλεγμένες τιμές

Στιγμιότυπο οθόνης που εμφανίζει τις βασικές παραμέτρους στη δραστηριότητα σημειωματάριου που συμπληρώνεται αυτόματα.

Μπορείτε να ελέγξετε τις παραμέτρους που συμπληρώνονται αυτόματα και (προαιρετικά) να παρακάμψετε τις τιμές παραμέτρων.

Συμπεριφορές κλειδιού

  • Οι παράμετροι συμπληρώνονται αυτόματα όταν επιλέγετε ένα σημειωματάριο.
  • Η αλλαγή σημειωματαρίων ανανεώνει τη λίστα παραμέτρων.
  • Δεν υπάρχει κελί παραμέτρου → δεν έχουν συμπληρωθεί παράμετροι.

Ορισμός ετικέτας περιόδου λειτουργίας

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

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

Σημείωμα

Για να μπορέσετε να χρησιμοποιήσετε την ετικέτα περιόδου λειτουργίας, η λειτουργία υψηλής ταυτόχρονης εκτέλεσης για διοχέτευση που εκτελεί πολλά σημειωματάρια πρέπει να είναι ενεργοποιημένη. Μπορείτε να βρείτε αυτή την επιλογή στην περιοχή Λειτουργία υψηλής ταυτόχρονης εκτέλεσης για Spark στην περιοχή Ρυθμίσεις χώρου εργασίας

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

Αποθήκευση και εκτέλεση ή προγραμματισμός της διοχέτευσης

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

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

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

Γνωστά προβλήματα