Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Notebook Utilities (NotebookUtils) ist ein integriertes Paket, mit dem Sie allgemeine Aufgaben in Fabric Notebook problemlos ausführen können. Sie können NotebookUtils verwenden, um mit Dateisystemen zu arbeiten, Umgebungsvariablen zu erhalten, Notebooks miteinander zu verketten und mit Geheimnissen zu arbeiten. Das NotebookUtils-Paket ist in PySpark (Python) Scala, SparkR-Notebooks und Fabric-Pipelines verfügbar.
Note
- MsSparkUtils wird offiziell in "NotebookUtils" umbenannt. Der vorhandene Code bleibt abwärtskompatibel und verursacht keine einschneidenden Änderungen. Es wird dringend empfohlen, ein Upgrade auf notebookutils durchzuführen, um den fortlaufenden Support zu gewährleisten und Zugang zu neuen Funktionen zu erhalten. Der Namespace „mssparkutils“ wird in Zukunft ausgemustert.
- NotebookUtils ist für die Arbeit mit Spark 3.4 (Runtime v1.2) und höher konzipiert. Alle neuen Features und Updates werden in Zukunft ausschließlich mit dem Namespace "notebookutils" unterstützt.
NotebookUtils-Module
NotebookUtils stellt die folgenden Module bereit. Wählen Sie ein Modul aus, um detaillierte Dokumentationen, Codebeispiele und bewährte Methoden anzuzeigen.
| Modul | Namespace | Beschreibung |
|---|---|---|
| Dateisystemprogramme | notebookutils.fs |
Arbeiten Sie mit Dateien und Verzeichnissen in ADLS Gen2, Azure Blob Storage und Lakehouse Storage. Umfasst Kopier-, Verschiebungs-, Lese-, Schreib-, Lösch- und Listenvorgänge. |
| Dateien einbinden und auswerfen | notebookutils.fs |
Fügen Sie Remotespeicher (ADLS Gen2) als lokale Bereitstellungspunkte für den vereinfachten Dateizugriff an Spark-Knoten an. |
| Ausführung und Steuerung von Notebooks | notebookutils.notebook |
Führen Sie Notebooks aus und verketten Sie sie, einschließlich paralleler Ausführung mit DAG-Unterstützung, arbeitsbereichsübergreifender Verweise und Exit-Werte. |
| Notizbuchverwaltung | notebookutils.notebook |
Programmgesteuertes Erstellen, Abrufen, Aktualisieren, Löschen und Auflisten von Notizbuchartefakten. |
| Anmeldeinformations-Dienstprogramme | notebookutils.credentials |
Rufen Sie Zugriffstoken für Azure-Dienste ab und rufen Sie geheime Schlüssel aus Azure Key Vault ab. |
| Lakehouse-Versorgungsunternehmen | notebookutils.lakehouse |
Programmgesteuertes Erstellen, Abrufen, Aktualisieren, Löschen und Verwalten von Lakehouse-Elementen und -Tabellen. |
| Laufzeitkontext | notebookutils.runtime |
Zugreifen auf Sitzungskontextinformationen, einschließlich Notizbuchname, Arbeitsbereichsdetails und Ausführungskontext. |
| Sitzungsverwaltung | notebookutils.session |
Beenden Sie interaktive Sitzungen, und starten Sie den Python-Dolmetscher neu. |
| Benutzerdatenfunktion (UDF)-Dienstprogramme | notebookutils.udf |
Abrufen und Ausführen von Benutzerdaten-Funktionen aus Notizbüchern. |
| Hilfsprogramme für variable Bibliotheken | notebookutils.variableLibrary |
Greifen Sie auf zentral verwaltete Variablen und Konfigurationen von Variablenbibliothekselementen zu. |
Um einen Überblick über alle verfügbaren Module und Methoden zu erhalten, führen Sie Folgendes aus:
notebookutils.help()
Um Hilfe zu einem bestimmten Modul zu erhalten, führen Sie Folgendes aus:
notebookutils.fs.help()
notebookutils.notebook.help()
notebookutils.credentials.help()
Bekannte Probleme
- Bei Verwendung der Laufzeitversion über 1.2 und der Ausführung
notebookutils.help()werden die aufgelisteten fabricClient - und PBIClient-APIs noch nicht unterstützt, aber sie werden in einer zukünftigen Version verfügbar sein.