Στοιχείο ελέγχου προέλευσης και ανάπτυξη σημειωματάριου
Αυτό το άρθρο εξηγεί πώς οι διοχετεύσεις ενοποίησης και ανάπτυξης Git λειτουργούν για σημειωματάρια στο Microsoft Fabric. Μάθετε πώς μπορείτε να ρυθμίσετε μια σύνδεση στο αποθετήριο δεδομένων σας, να διαχειριστείτε τα σημειωματάριά σας και να τα αναπτύξετε σε διαφορετικά περιβάλλοντα.
Ενοποίηση Git σημειωματάριου
Τα σημειωματάρια Fabric προσφέρουν ενοποίηση Git για τον έλεγχο προέλευσης με το Azure DevOps. Με την ενοποίηση του Git, μπορείτε να δημιουργήσετε αντίγραφα ασφαλείας και να δημιουργήσετε εκδόσεις του σημειωματάριού σας, να το επαναφέρετε σε προηγούμενα στάδια ανάλογα με τις ανάγκες, να συνεργαστείτε ή να εργαστείτε μόνοι σας χρησιμοποιώντας διακλαδώσεις Git και να διαχειριστείτε πλήρως τον κύκλο ζωής του περιεχομένου του σημειωματάριου σας στο Fabric.
Σημείωμα
Ξεκινώντας από τον Οκτώβριο 2024, η ενοποίηση Notebook git υποστηρίζει τη μόνιμη σχέση αντιστοίχισης του συνημμένου περιβάλλοντος κατά τον συγχρονισμό σε νέο χώρο εργασίας, το οποίο σημαίνει ότι όταν δεσμεύετε το σημειωματάριο και το συνημμένο περιβάλλον μαζί στο git repo και το συγχρονίζετε σε έναν άλλο χώρο εργασίας, το σημειωματάριο και το περιβάλλον που μόλις δημιουργήσατε θα συνδέονται μεταξύ τους. Αυτή η αναβάθμιση θα έχει επιπτώσεις στα υπάρχοντα σημειωματάρια και τα εξαρτώμενα περιβάλλοντα που έχουν εκδόσεις στο git, το φυσικό αναγνωριστικό του συνημμένου περιβάλλοντος στο περιεχόμενο μετα-δεδομένων σημειωματάριου θα αντικατασταθεί με ένα λογικό αναγνωριστικό και η αλλαγή θα εφαρμοστεί στην προβολή διαφοράς.
Ρύθμιση σύνδεσης
Από τις ρυθμίσεις του χώρου εργασίας σας, μπορείτε εύκολα να ρυθμίσετε μια σύνδεση στο αποθετήριο δεδομένων σας για τη δέσμευση και τον συγχρονισμό αλλαγών. Για να ρυθμίσετε τη σύνδεση, ανατρέξτε στο θέμα Γρήγορα αποτελέσματα με την ενοποίηση Git. Όταν συνδεθείτε, τα στοιχεία σας, συμπεριλαμβανομένων των σημειωματάριων, εμφανίζονται στον πίνακα ελέγχου Προέλευση.
Αφού δεσμεύσετε με επιτυχία τις παρουσίες σημειωματάριου στο αποθετήριο Git, θα δείτε τη δομή του φακέλου σημειωματάριου στο αποθετήριο δεδομένων.
Τώρα, μπορείτε να εκτελέσετε μελλοντικές λειτουργίες, όπως Δημιουργία αιτήματος έλξης.
Αναπαράσταση σημειωματάριου στο Git
Η παρακάτω εικόνα είναι ένα παράδειγμα της δομής αρχείου κάθε στοιχείου σημειωματάριου στο αποθετήριο δεδομένων:
Όταν τοποθετείτε το στοιχείο σημειωματάριου στο αποθετήριο Git, ο κώδικας σημειωματάριου μετατρέπεται σε μορφή πηγαίου κώδικα, αντί για ένα τυπικό αρχείο .ipynb. Για παράδειγμα, ένα σημειωματάριο PySpark μετατρέπεται σε αρχείο notebook-content.py. Αυτή η προσέγγιση επιτρέπει ευκολότερη αξιολόγηση κώδικα χρησιμοποιώντας ενσωματωμένες δυνατότητες διαφοράς.
Στο αρχείο προέλευσης περιεχομένου στοιχείου, τα μετα-δεδομένα (συμπεριλαμβανομένης της προεπιλεγμένης λίμνης και του συνημμένου περιβάλλοντος), τα κελιά markdown και τα κελιά κώδικα διατηρούνται και διακρίνονται. Αυτή η προσέγγιση υποστηρίζει ακριβή ανάκτηση όταν συγχρονίζετε ξανά σε έναν χώρο εργασίας Fabric.
Η έξοδος κελιού σημειωματάριου δεν περιλαμβάνεται κατά τον συγχρονισμό με το Git.
Σημείωμα
- Προς το παρόν, τα αρχεία στους πόρους σημειωματάριου δεν δεσμεύονται για το αποθετήριο δεδομένων. Η δέσμευση αυτών των αρχείων υποστηρίζεται σε μελλοντική έκδοση.
- Συνιστούμε να διαχειρίζεστε τα σημειωματάρια και το εξαρτώμενο περιβάλλον τους στον ίδιο χώρο εργασίας και να χρησιμοποιείτε το Git για τον έλεγχο εκδόσεων τόσο του σημειωματάριου όσο και των στοιχείων περιβάλλοντος , το σύστημα Fabric Git θα χειρίζεται τη σχέση αντιστοίχισης κατά το συγχρονισμό του σημειωματάριου και του συνημμένου περιβάλλοντος σε νέους χώρους εργασίας.
- Το προεπιλεγμένο αναγνωριστικό λίμνης διατηρείται στο σημειωματάριο όταν συγχρονίζετε από το αποθετήριο σε έναν χώρο εργασίας Fabric. Εάν δεσμεύσετε ένα σημειωματάριο με την προεπιλεγμένη λίμνη, πρέπει να αναφέρετε ένα στοιχείο lakehouse που μόλις δημιουργήθηκε με μη αυτόματο τρόπο. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Ενοποίηση Git lakehouse.
Σημειωματάριο σε διοχετεύσεις ανάπτυξης
Μπορείτε επίσης να χρησιμοποιήσετε τη διοχέτευση ανάπτυξης για να αναπτύξετε τον κώδικα σημειωματάριου σε διαφορετικά περιβάλλοντα, όπως ανάπτυξη, δοκιμή και παραγωγή. Αυτή η δυνατότητα μπορεί να σας επιτρέψει να βελτιστοποιήσετε τη διαδικασία ανάπτυξής σας, να εξασφαλίσετε ποιότητα και συνέπεια και να μειώσετε τα μη αυτόματα σφάλματα με ελαφριές λειτουργίες χαμηλού κώδικα. Μπορείτε επίσης να χρησιμοποιήσετε κανόνες ανάπτυξης για να προσαρμόσετε τη συμπεριφορά των σημειωματάριών σας όταν αναπτύσσονται, όπως η αλλαγή της προεπιλεγμένης λίμνης ενός σημειωματάριου.
Σημείωμα
- Χρησιμοποιείτε τη νέα σχεδίαση διοχέτευσης ανάπτυξης τώρα, είναι δυνατή η πρόσβαση στο παλιό περιβάλλον εργασίας χρήστη, απενεργοποιώντας τη "Νέα διοχέτευση ανάπτυξης".
- Ξεκινώντας από τον Οκτώβριο, το σημειωματάριο Fabric υποστηρίζει τη δυνατότητα αυτόματης σύνδεσης που θα συνδέει την προεπιλεγμένη λίμνη και το συνημμένο περιβάλλον εντός του ίδιου χώρου εργασίας κατά την ανάπτυξη στο επόμενο στάδιο. Η αλλαγή θα έχει επιπτώσεις στα υπάρχοντα σημειωματάρια στη διοχέτευση ανάπτυξης.
- Η προεπιλεγμένη λίμνη και το συνημμένο περιβάλλον (όταν όλα τα εξαρτώμενα στοιχεία βρίσκονται στον ίδιο χώρο εργασίας) θα αντικατασταθούν από στοιχεία που μόλις δημιουργήθηκαν στον χώρο εργασίας προορισμού, η αλλαγή μετα-δεδομένων σημειωματάριου θα επισημανθεί στην προβολή διαφοράς στον επόμενο γύρο ανάπτυξης.
- Μπορείτε να ορίσετε κανόνες ανάπτυξης για την προεπιλεγμένη λίμνη για παράκαμψη της λίμνης που συνδέεται αυτόματα.
- Γνωστό ζήτημα: Η κατάσταση του κατεψυγμένου κελιού στο σημειωματάριο θα χαθεί κατά τη διάρκεια της ανάπτυξης. Προς το παρόν, εργαζόμαστε σε σχετικές εργασίες.
Χρησιμοποιήστε τα παρακάτω βήματα για να ολοκληρώσετε την ανάπτυξη του σημειωματάριου χρησιμοποιώντας τη διοχέτευση ανάπτυξης.
Δημιουργήστε μια νέα διοχέτευση ανάπτυξης ή ανοίξτε μια υπάρχουσα διοχέτευση ανάπτυξης. (Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Γρήγορα αποτελέσματα με τις διοχετεύσεις ανάπτυξης.)
Αναθέστε χώρους εργασίας σε διαφορετικά στάδια σύμφωνα με τους στόχους ανάπτυξής σας.
Επιλέξτε, προβάλετε και συγκρίνετε στοιχεία, συμπεριλαμβανομένων σημειωματάριων μεταξύ διαφορετικών σταδίων, όπως φαίνεται στο παρακάτω παράδειγμα. Το επισημασμένο σήμα υποδεικνύει πλήθος αλλαγμένων στοιχείων μεταξύ του προηγούμενου σταδίου και του τρέχοντος σταδίου.
Επιλέξτε Ανάπτυξη για να αναπτύξετε τα σημειωματάριά σας στα στάδια Ανάπτυξη, Δοκιμή και Παραγωγή.
(Προαιρετικό.) Μπορείτε να επιλέξετε Κανόνες ανάπτυξης για να δημιουργήσετε κανόνες ανάπτυξης για μια διαδικασία ανάπτυξης. Η καταχώρηση κανόνες ανάπτυξης βρίσκεται στο στάδιο προορισμού για μια διαδικασία ανάπτυξης.
Το Fabric υποστηρίζει την παραμετροποίηση της προεπιλεγμένης λίμνης για κάθε παρουσία σημειωματάριου κατά την ανάπτυξη με κανόνες ανάπτυξης. Υπάρχουν τρεις διαθέσιμες επιλογές για τον καθορισμό του προεπιλεγμένου lakehouse προορισμού: Ίδιο με το lakehouse προέλευσης, N/A(δεν υπάρχει προεπιλεγμένο lakehouse) και άλλο lakehouse.
Μπορείτε να επιτύχετε ασφαλή απομόνωση δεδομένων ρυθμίζοντας αυτόν τον κανόνα. Η προεπιλεγμένη λίμνη του σημειωματάριού σας αντικαθίσταται από αυτή που καθορίσατε ως προορισμό κατά τη διάρκεια της ανάπτυξης.
Σημείωμα
Κατά τον ορισμό της προεπιλεγμένης lakehouse σε κανόνες ανάπτυξης, το αναγνωριστικό Lakehouse πρέπει να έχει. Μπορείτε να λάβετε το αναγνωριστικό lakehouse από τη σύνδεση διεύθυνσης URL στοιχείου. Οι κανόνες ανάπτυξης έχουν υψηλότερη προτεραιότητα από την αυτόματη σύνδεση, η λίμνη αυτόματης σύνδεσης θα αντικατασταθεί όταν ρυθμιστεί ο κανόνας ανάπτυξης.
Παρακολουθήστε την κατάσταση ανάπτυξης από το ιστορικό ανάπτυξης.
