Del via

NotebookUtils (tidligere MSSparkUtils) for Fabric

Notebook Utilities (NotebookUtils) er en innebygd pakke som gjør det enkelt å utføre vanlige oppgaver i Fabric Notebook. Du kan bruke NotebookUtils til å arbeide med filsystemer, få miljøvariabler, kjede notatblokker sammen og til å arbeide med hemmeligheter. NotebookUtils-pakken er tilgjengelig i PySpark (Python) Scala, SparkR-notatblokker og Fabric-rørledninger.

Note

  • MsSparkUtils er offisielt omdøpt til NotebookUtils. Den eksisterende koden forblir bakoverkompatibel og forårsaker ingen brytende endringer. Det anbefales sterkt å oppgradere til notebookutils for å sikre fortsatt støtte og tilgang til nye funksjoner. Mssparkutils-navneområdet vil bli trukket tilbake i fremtiden.
  • NotebookUtils er designet for å fungere med Spark 3.4 (Runtime v1.2) og nyere. Alle nye funksjoner og oppdateringer støttes eksklusivt i notebookutils-navnerommet fremover.

NotebookUtils-moduler

NotebookUtils tilbyr følgende moduler. Velg en modul for å se detaljert dokumentasjon, kodeeksempler og beste praksis.

Modul Navneområde Beskrivelse
Filsystemverktøy notebookutils.fs Arbeid med filer og kataloger på tvers av ADLS Gen2, Azure Blob Storage og Lakehouse Storage. Inkluderer kopiering, flytting, lesing, skriving, sletting og listeoperasjoner.
Filmontering og avmontering notebookutils.fs Fest fjernlagring (ADLS Gen2) til Spark-noder som lokale monteringspunkter for enklere filtilgang.
Notebook-kjøring og orkestrering notebookutils.notebook Kjør og lenk notatbøker sammen, inkludert parallell kjøring med DAG-støtte, kryss-arbeidsområde-referanser og exit-verdier.
Notatbokadministrasjon notebookutils.notebook Opprette, hent, oppdater, slette og liste notatbokartefakter programmatisk.
Verktøy for legitimasjoner notebookutils.credentials Få tilgang til tokens for Azure-tjenester og hent hemmeligheter fra Azure Key Vault.
Innsjøhusets forsyninger notebookutils.lakehouse Opprette, hent, oppdater, slett og administrer Lakehouse-elementer og tabeller programmatisk.
Kjøretidskontekst notebookutils.runtime Få tilgang til sesjonskontekstinformasjon, inkludert notatbokens navn, arbeidsområdedetaljer og utførelseskontekst.
Sesjonsledelse notebookutils.session Stopp interaktive økter og start Python-tolken på nytt.
User Data Function (UDF)-verktøy notebookutils.udf Hent og kall User Data Functions fra notatbøker.
Variable biblioteksverktøy notebookutils.variableLibrary Få tilgang til sentralt administrerte variabler og konfigurasjon fra Variable Library-elementer.

For å få en oversikt over alle tilgjengelige moduler og metoder, kjør:

notebookutils.help()

For å få hjelp til en spesifikk modul, kjør:

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

Kjente problemer

  • Når man bruker runtime-versjon over 1.2 og kjører notebookutils.help(), støttes ikke de oppførte fabricClient - og PBIClient-API-ene ennå, men de vil være tilgjengelige i en fremtidig utgivelse.

Relatert innhold

  • Last updated on