Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Notebook Utilities (NotebookUtils) är ett inbyggt paket som hjälper dig att enkelt utföra vanliga uppgifter i Fabric Notebook. Du kan använda NotebookUtils för att arbeta med filsystem, hämta miljövariabler, länka ihop notebook-filer och arbeta med hemligheter. NotebookUtils-paketet är tillgängligt i PySpark (Python) Scala, SparkR Notebooks och Fabric-pipelines.
Note
- MsSparkUtils har officiellt bytt namn till NotebookUtils. Den befintliga koden förblir bakåtkompatibel och orsakar inga brytande ändringar. Vi rekommenderar starkt att du uppgraderar till notebookutils för att säkerställa fortsatt stöd och tillgång till nya funktioner. Mssparkutils-namnområdet kommer att dras tillbaka i framtiden.
- NotebookUtils är utformat för att fungera med Spark 3.4 (Runtime v1.2) och senare. Alla nya funktioner och uppdateringar stöds exklusivt med notebookutils-namnområdet framöver.
NotebookUtils-moduler
NotebookUtils innehåller följande moduler. Välj en modul för att se detaljerad dokumentation, kodexempel och metodtips.
| Modul | Namespace | Beskrivning |
|---|---|---|
| Filsystemverktyg | notebookutils.fs |
Arbeta med filer och kataloger i ADLS Gen2, Azure Blob Storage och Lakehouse Storage. Innehåller åtgärder för att kopiera, flytta, läsa, skriva, ta bort och lista. |
| Montera och demontera filer | notebookutils.fs |
Koppla fjärrlagring (ADLS Gen2) till Spark-noder som lokala monteringspunkter för förenklad filåtkomst. |
| Körning och orkestrering av notebook-filer | notebookutils.notebook |
Kör och kedja ihop notebook-filer, inklusive parallell körning med DAG-stöd, referenser mellan arbetsytor och slutvärden. |
| Notebook-hantering | notebookutils.notebook |
Skapa, hämta, uppdatera, ta bort och lista notebook-artefakter programmatiskt. |
| Verktyg för autentiseringsuppgifter | notebookutils.credentials |
Hämta åtkomsttoken för Azure-tjänster och hämta hemligheter från Azure Key Vault. |
| Lakehouse-verktygsprogram | notebookutils.lakehouse |
Skapa, hämta, uppdatera, ta bort och hantera Lakehouse-objekt och tabeller programmatiskt. |
| Körningskontext | notebookutils.runtime |
Få åtkomst till sessionskontextinformation, inklusive anteckningsboksnamn, information om arbetsytan och exekveringskontext. |
| Sessionshantering | notebookutils.session |
Stoppa interaktiva sessioner och starta om Python-tolken. |
| UDF-verktyg (User Data Function) | notebookutils.udf |
Hämta och anropa användardatafunktioner från notebook-filer. |
| Variabelbibliotekstjänster | notebookutils.variableLibrary |
Få åtkomst till centralt hanterade variabler och konfiguration från variabelbiblioteksobjekt. |
Om du vill få en översikt över alla tillgängliga moduler och metoder kör du:
notebookutils.help()
Kör för att få hjälp med en specifik modul:
notebookutils.fs.help()
notebookutils.notebook.help()
notebookutils.credentials.help()
Kända problemområden
- När du använder runtime-versionen ovan 1.2 och kör
notebookutils.help()stöds inte de listade API:erna fabricClient och PBIClient ännu, men de kommer att vara tillgängliga i en framtida version.