Σημείωμα
Η πρόσβαση σε αυτήν τη σελίδα απαιτεί εξουσιοδότηση. Μπορείτε να δοκιμάσετε να εισέλθετε ή να αλλάξετε καταλόγους.
Η πρόσβαση σε αυτήν τη σελίδα απαιτεί εξουσιοδότηση. Μπορείτε να δοκιμάσετε να αλλάξετε καταλόγους.
Το Notebook Utilities (NotebookUtils) είναι ένα ενσωματωμένο πακέτο που σας βοηθά να εκτελείτε εύκολα κοινές εργασίες σε σημειωματάρια στο Microsoft Fabric. Μπορείτε να χρησιμοποιήσετε το NotebookUtils για να εργαστείτε με συστήματα αρχείων, για να λάβετε μεταβλητές περιβάλλοντος, να αλληλουχήσετε σημειωματάρια και να εργαστείτε με μυστικά. Το πακέτο NotebookUtils είναι διαθέσιμο στη Scala PySpark (Python), στα σημειωματάρια SparkR και στις διοχετεύσεις Fabric.
Note
- Το MsSparkUtils μετονομάζεται επίσημα σε NotebookUtils. Ο υπάρχων κώδικας παραμένει συμβατός με προηγούμενες εκδόσεις και δεν προκαλεί αλλαγές. Συνιστάται ανεπιφύλακτα η αναβάθμιση σε notebookutils για να διασφαλιστεί η συνεχής υποστήριξη και η πρόσβαση σε νέες δυνατότητες. Ο χώρος ονομάτων mssparkutils θα αποσυρθεί στο μέλλον.
- Το NotebookUtils έχει σχεδιαστεί για να λειτουργεί με το Spark 3.4 (Runtime v1.2) και νεότερη έκδοση. Όλες οι νέες δυνατότητες και ενημερώσεις υποστηρίζονται αποκλειστικά με τον χώρο ονομάτων notebookutils στο μέλλον.
Λειτουργικές μονάδες NotebookUtils
Το NotebookUtils παρέχει τις ακόλουθες ενότητες. Επιλέξτε μια λειτουργική μονάδα για να δείτε λεπτομερή τεκμηρίωση, παραδείγματα κώδικα και βέλτιστες πρακτικές.
| Μονάδα | Namespace | Περιγραφή |
|---|---|---|
| Βοηθητικά προγράμματα συστήματος αρχείων | notebookutils.fs |
Εργαστείτε με αρχεία και καταλόγους στο ADLS Gen2, τον χώρο αποθήκευσης αντικειμένων blob Azure και τον χώρο αποθήκευσης Lakehouse. Περιλαμβάνει λειτουργίες αντιγραφής, μετακίνησης, ανάγνωσης, εγγραφής, διαγραφής και λίστας. |
| Προσάρτηση και αποπροσάρτηση αρχείου | notebookutils.fs |
Συνδέστε απομακρυσμένο χώρο αποθήκευσης (ADLS Gen2) σε κόμβους Spark ως τοπικά σημεία προσάρτησης για απλοποιημένη πρόσβαση σε αρχεία. |
| Εκτέλεση και ενορχήστρωση σημειωματαρίου | notebookutils.notebook |
Εκτελέστε και αλυσιδώστε σημειωματάρια μαζί, συμπεριλαμβανομένης της παράλληλης εκτέλεσης με υποστήριξη DAG, αναφορών μεταξύ χώρων εργασίας και τιμών εξόδου. |
| Διαχείριση φορητού υπολογιστή | notebookutils.notebook |
Δημιουργήστε, λάβετε, ενημερώστε, διαγράψτε και παραθέστε αντικείμενα σημειωματαρίου μέσω προγραμματισμού. |
| Βοηθητικά προγράμματα διαπιστευτηρίων | notebookutils.credentials |
Αποκτήστε διακριτικά πρόσβασης για υπηρεσίες Azure και ανακτήστε μυστικά από το Azure Key Vault. |
| Βοηθητικά προγράμματα Lakehouse | notebookutils.lakehouse |
Δημιουργήστε, αποκτήστε, ενημερώστε, διαγράψτε και διαχειριστείτε στοιχεία και πίνακες Lakehouse μέσω προγραμματισμού. |
| Περιβάλλον χρόνου εκτέλεσης | notebookutils.runtime |
Αποκτήστε πρόσβαση σε πληροφορίες περιβάλλοντος περιόδου λειτουργίας, συμπεριλαμβανομένου του ονόματος σημειωματαρίου, των λεπτομερειών του χώρου εργασίας και του περιβάλλοντος εκτέλεσης. |
| Διαχείριση συνεδρίας | notebookutils.session |
Διακόψτε τις αλληλεπιδραστικές συνεδρίες και επανεκκινήστε τον διερμηνέα Python. |
| Βοηθητικά προγράμματα λειτουργίας δεδομένων χρήστη (UDF). | notebookutils.udf |
Ανάκτηση και κλήση συναρτήσεων δεδομένων χρήστη από σημειωματάρια. |
| Μεταβλητά βοηθητικά προγράμματα βιβλιοθήκης | notebookutils.variableLibrary |
Πρόσβαση σε κεντρικά διαχειριζόμενες μεταβλητές και ρυθμίσεις από στοιχεία Βιβλιοθήκης Μεταβλητών. |
Για να λάβετε μια επισκόπηση όλων των διαθέσιμων ενοτήτων και μεθόδων, εκτελέστε:
notebookutils.help()
Για να λάβετε βοήθεια για μια συγκεκριμένη λειτουργική μονάδα, εκτελέστε:
notebookutils.fs.help()
notebookutils.notebook.help()
notebookutils.credentials.help()
Γνωστά προβλήματα
- Όταν χρησιμοποιείτε την έκδοση χρόνου εκτέλεσης πάνω από την 1.2 και εκτελείτε
notebookutils.help(), τα αναφερόμενα API fabricClient και PBIClient δεν υποστηρίζονται ακόμα, αλλά θα είναι διαθέσιμα σε μελλοντική έκδοση.