Del via


NotebookUtils (tidligere MSSparkUtils) til Fabric

Notebook Utilities (NotebookUtils) er en indbygget pakke, der hjælper dig med nemt at udføre almindelige opgaver i Fabric Notebook. Du kan bruge NotebookUtils til at arbejde med filsystemer, til at hente miljøvariabler, til at sammenkæde notesbøger og til at arbejde med hemmeligheder. NotebookUtils-pakken er tilgængelig i PySpark (Python) Scala, SparkR-notesbøger og Fabric-pipelines.

Note

  • MsSparkUtils er officielt omdøbt til NotebookUtils. Den eksisterende kode forbliver bagudkompatibel og forårsager ingen breaking changes. Det anbefales kraftigt at opgradere til notebookutils for at sikre fortsat support og adgang til nye funktioner. Navneområdet mssparkutils udgår i fremtiden.
  • NotebookUtils er designet til at fungere med Spark 3.4 (Runtime v1.2) og nyere. Alle nye funktioner og opdateringer understøttes eksklusivt i notebookutils-navnerummet fremover.

NotebookUtils-moduler

NotebookUtils tilbyder følgende moduler. Vælg et modul for at se detaljeret dokumentation, kodeeksempler og bedste praksis.

Modul Navneområde Beskrivelse
Filsystemværktøjer notebookutils.fs Arbejd med filer og mapper på tværs af ADLS Gen2, Azure Blob Storage og Lakehouse storage. Inkluderer kopiering, flytning, læsning, skrivning, sletning og listeoperationer.
Filmontering og afmontering notebookutils.fs Tilslut fjernlagring (ADLS Gen2) til Spark-noder som lokale mount-punkter for forenklet filadgang.
Notebook-kørsel og orkestrering notebookutils.notebook Kør og kæde notebooks sammen, inklusive parallel eksekvering med DAG-understøttelse, kryds-arbejdsområde-referencer og exit-værdier.
Notebook-administration notebookutils.notebook Opret programmæssigt, hent, opdatere, slet og liste notesbogsartefakter på programmet.
Adgangskodeværktøjer notebookutils.credentials Få adgangstokene til Azure-tjenester og hent hemmeligheder fra Azure Key Vault.
Lakehouse-forsyninger notebookutils.lakehouse Opret, hent, opdater, slet og administrer Lakehouse-elementer og tabeller programmatisk.
Kørselskontekst notebookutils.runtime Få adgang til sessionskontekstinformation, herunder notesbogens navn, arbejdsområdedetaljer og eksekveringskontekst.
Sessionstyring notebookutils.session Stop interaktive sessioner og genstart Python-tolken.
User Data Function (UDF) værktøjer notebookutils.udf Hent og kald User Data Functions fra notesbøger.
Variable biblioteksværktøjer notebookutils.variableLibrary Få adgang til centralt administrerede variable og konfiguration fra variable library-elementer.

For at få et overblik over alle tilgængelige moduler og metoder, kør:

notebookutils.help()

For at få hjælp til et specifikt modul, kør:

notebookutils.fs.help()
notebookutils.notebook.help()
notebookutils.credentials.help()

Kendte problemer

  • Når man bruger runtime-version over 1.2 og kører notebookutils.help(), understøttes de nævnte fabricClient - og PBIClient-API'er endnu ikke, men de vil være tilgængelige i en fremtidig udgivelse.