Δημιουργία και διαχείριση σημειωματάριων Microsoft Fabric στο Visual Studio Code

Η επέκταση κώδικα Visual Studio (VS) για Synapse υποστηρίζει πλήρως τις λειτουργίες σημειωματάριου CRUD (δημιουργία, ανάγνωση, ενημέρωση και διαγραφή) στο Fabric. Η επέκταση υποστηρίζει επίσης τον συγχρονισμό μεταξύ τοπικών και απομακρυσμένων χώρων εργασίας. Όταν συγχρονίζετε αλλαγές, μπορείτε να αντιμετωπίσετε τυχόν διενέξεις ή διαφορές μεταξύ του τοπικού και του απομακρυσμένου χώρου εργασίας σας.

Με αυτή την επέκταση, μπορείτε επίσης να εκτελέσετε σημειωματάρια στον απομακρυσμένο υπολογισμό Apache Spark για Fabric.

Άνοιγμα σημειωματάριου με την επέκταση Synapse

Κάνοντας κλικ στο κουμπί Άνοιγμα στο VS Code στη σελίδα σύνταξης σημειωματάριου στην πύλη Fabric, μπορείτε να ανοίξετε απευθείας το ίδιο σημειωματάριο με την επέκταση Synapse VS Code για το Fabric. Αφού ενεργοποιήσετε την επέκταση στο VS Code και ανοίξετε το σημειωματάριο μία φορά, ο χώρος εργασίας σας θα πρέπει να συνδέεται αυτόματα στο σημειωματάριο.

Φιλοδώρημα

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

Προβολή της λίστας σημειωματάριων

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

• Προεπιλογή: Το λευκό κείμενο και κανένας χαρακτήρας στα δεξιά του ονόματος σημειωματάριου υποδεικνύουν την προεπιλεγμένη ή αρχικοποιημένη κατάσταση. Το σημειωματάριο υπάρχει στον απομακρυσμένο χώρο εργασίας και δεν το έχετε κάνει τοπικά.
• Τροποποιήθηκε: Ο χαρακτήρας M στα δεξιά του ονόματος και του κίτρινου κειμένου υποδεικνύει ότι έχετε κάνει λήψη και επεξεργασία του σημειωματάριου τοπικά στον κώδικα VS και δεν έχετε δημοσιεύσει ακόμα αυτές τις αλλαγές σε εκκρεμότητα στον απομακρυσμένο χώρο εργασίας.
• Τοπικά: Ο χαρακτήρας L και το πράσινο κείμενο υποδεικνύουν ότι λαμβάνεται το σημειωματάριο και το περιεχόμενο είναι το ίδιο με τον απομακρυσμένο χώρο εργασίας.
• Διένεξη: Ο χαρακτήρας C και το κόκκινο κείμενο υποδεικνύουν ότι υπάρχουν διενέξεις μεταξύ της τοπικής έκδοσης και της έκδοσης απομακρυσμένου χώρου εργασίας.

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

1. Στην Εξερεύνηση κώδικα VS, τοποθετήστε τον δείκτη του ποντικιού πάνω στη γραμμή εργαλείων σημειωματάριου. Εμφανίζεται η επιλογή Δημιουργία σημειωματάριου .

   

2. Επιλέξτε Δημιουργία σημειωματάριου και εισαγάγετε ένα όνομα και μια περιγραφή. Δημιουργείται ένα νέο σημειωματάριο στον απομακρυσμένο χώρο εργασίας και εμφανίζεται στη λίστα σημειωματάριού σας στην προεπιλεγμένη κατάσταση.

Λήψη σημειωματάριου

Για να επεξεργαστείτε το περιεχόμενο ενός σημειωματάριου, πρέπει να κάνετε λήψη του σημειωματάριου στο VS Code.

1. Στη λίστα σημειωματάριων στο VS Code, τοποθετήστε τον δείκτη επάνω στο όνομα του σημειωματάριου. Η επιλογή Λήψη εμφανίζεται δίπλα στο όνομα του σημειωματάριου.

   

2. Επιλέξτε Λήψη και αποθηκεύστε το σημειωματάριο στον τοπικό κατάλογο εργασίας σας.

Άνοιγμα σημειωματάριου

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

   

2. Επιλέξτε Άνοιγμα φακέλου σημειωματάριου και το σημειωματάριο θα ανοίξει στην οθόνη του προγράμματος επεξεργασίας κώδικα VS.

Διαγραφή σημειωματάριου

Φιλοδώρημα

Για να αποφύγετε την αποτυχία, κλείστε τον φάκελο σημειωματάριου στην προβολή Εξερεύνηση και κλείστε το σημειωματάριο στην προβολή προγράμματος επεξεργασίας πριν διαγράψετε το σημειωματάριο.

Για να διαγράψετε ένα σημειωματάριο:

1. Στην Εξερεύνηση κώδικα VS, τοποθετήστε τον δείκτη επάνω στο όνομα του σημειωματάριου που θέλετε να διαγράψετε. Οι επιλογές εμφανίζονται στα δεξιά του ονόματος, συμπεριλαμβανομένης της επιλογής "Διαγραφή σημειωματάριου ".

   

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

Δημοσίευση τοπικών αλλαγών στον απομακρυσμένο χώρο εργασίας

Για να προωθήσετε τις τοπικές αλλαγές σας στον απομακρυσμένο χώρο εργασίας:

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

   

2. Επιλέξτε το στοιχείο Εκδότες. Η έκδοση του απομακρυσμένου χώρου εργασίας ενημερώνεται με τις τοπικές αλλαγές του κώδικα VS.

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

3. Εάν κάποιος άλλος χρήστης έχει το ίδιο σημειωματάριο ανοιχτό στην πύλη Fabric, ειδοποιείται ότι αποδέχεται ή απορρίπτει τις τοπικές αλλαγές vs code, όπως φαίνεται στην παρακάτω εικόνα.

   

   • Αποδοχή: Η αλλαγή σας από κώδικα VS αποθηκεύεται με επιτυχία στον χώρο εργασίας.
   • Απόρριψη: η αλλαγή σας από κώδικα VS παραβλέπεται.

Λήψη αλλαγών από τον απομακρυσμένο χώρο εργασίας

Για να ενημερώσετε την τοπική έκδοση με την πιο πρόσφατη έκδοση του χώρου εργασίας, μεταφέρετε την απομακρυσμένη έκδοση:

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

   

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

   

3. Ενημερώστε το κελί κώδικα/markdown στην αριστερή πλευρά για να αντιμετωπίσετε το πρόβλημα.

4. Όταν αντιμετωπίσετε όλες τις διενέξεις, επιλέξτε Συγχώνευση στην επάνω δεξιά γωνία του προγράμματος επεξεργασίας διαφοράς για να επιβεβαιώσετε ότι η συγχώνευση ολοκληρώθηκε. (Μέχρι να επιλέξετε Συγχώνευση, το σημειωματάριο παραμένει σε λειτουργία διένεξης .)

   

Σημαντικό

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

Εκτέλεση ή εντοπισμός σφαλμάτων σε ένα σημειωματάριο σε απομακρυσμένο υπολογιστικό Spark

Επιλέγοντας τον πυρήνα πυρήνα που συνοδεύει αυτή την επέκταση, μπορείτε να εκτελέσετε το κελί κώδικα πάνω από το απομακρυσμένο υπολογιστικό spark. Αφού επιλέξετε αυτόν τον πυρήνα, κατά τη διάρκεια του χρόνου εκτέλεσης, η επέκταση αναχαιτίζει όλες τις κλήσεις API PySpark και τις μεταφράζει στην αντίστοιχη κλήση http στο απομακρυσμένο spark compute. Για καθαρό κώδικα Python, εξακολουθεί να εκτελείται στο τοπικό περιβάλλον.

Σχετικό περιεχόμενο

• Δημιουργία και διαχείριση ορισμών εργασίας Apache Spark στο Visual Studio Code
• Εξερευνήστε τις λίμνες Microsoft Fabric στο Visual Studio Code