NotebookUtils (korábbi MSSparkUtils) Fabric számára

A Notebook Utilities (NotebookUtils) egy beépített csomag, amely segít a Fabric Notebook gyakori feladatainak egyszerű végrehajtásában. A NotebookUtils használatával fájlrendszerekkel dolgozhat, környezeti változókat kérhet le, a jegyzetfüzeteket összeláncosíthatja, és titkos kódokkal dolgozhat. A NotebookUtils csomag a PySpark (Python) Scala, SparkR-jegyzetfüzetek és Fabric-folyamatokban érhető el.

Note

  • Az MsSparkUtils hivatalosan notebookUtils névre van átnevezve. A meglévő kód visszamenőlegesen kompatibilis marad, és nem okoz kompatibilitástörő változásokat. Erősen ajánlott frissíteni a notebookutilsra, hogy biztosítsa a folyamatos támogatást és az új funkciókhoz való hozzáférést. Az mssparkutils névtér a jövőben megszűnik.
  • A NotebookUtils a Spark 3.4 -hez (futtatókörnyezet 1.2-s verzió) és újabb verziókhoz készült. Az összes új funkció és frissítés kizárólag a notebookutils névtér előrehaladtával támogatott.

NotebookUtils-modulok

A NotebookUtils a következő modulokat biztosítja. Válasszon ki egy modult a részletes dokumentáció, a kód példák és az ajánlott eljárások megtekintéséhez.

Modul Namespace Leírás
Fájlrendszer-segédprogramok notebookutils.fs Fájlok és könyvtárak használata az ADLS Gen2, az Azure Blob Storage és a Lakehouse Storage között. Ide tartoznak a másolási, áthelyezési, olvasási, írási, törlési és listaműveletek.
Fájl csatlakoztatása és leválasztása notebookutils.fs Csatolja a távoli tárolást (ADLS Gen2) a Spark-csomópontokhoz helyi csatlakoztatási pontként az egyszerűsített fájlhozzáférés érdekében.
Jegyzetfüzet futtatása és vezénylése notebookutils.notebook Futtassa és kapcsolja össze a jegyzetfüzeteket, beleértve a párhuzamos végrehajtást DAG támogatással, a munkaterületek közötti hivatkozásokat és a visszatérési értékeket.
Jegyzetfüzet-kezelés notebookutils.notebook Programozott módon hozhat létre, kérhet le, frissíthet, törölhet és listázhat jegyzetfüzet-összetevőket.
Hitelesítő adatkezelő eszközök notebookutils.credentials Szerezze be az Azure-szolgáltatások hozzáférési jogkivonatait, és kérje le a titkos kulcsokat az Azure Key Vaultból.
Lakehouse segédprogramok notebookutils.lakehouse Lakehouse-elemek és -táblák programozott létrehozása, lekérése, frissítése, törlése és kezelése.
Futtatókörnyezet notebookutils.runtime Hozzáférés a munkamenet-környezet adataihoz, beleértve a jegyzetfüzet nevét, a munkaterület adatait és a végrehajtási környezetet.
Munkamenet-kezelés notebookutils.session Állítsa le az interaktív munkameneteket, és indítsa újra a Python-értelmezőt.
Felhasználói adatfüggvény (UDF) segédprogramok notebookutils.udf Felhasználói adattípusú függvények meghívása és lekérése jegyzetfüzetekből.
Változó kódtár segédprogramok notebookutils.variableLibrary Hozzáférés a központilag felügyelt változókhoz és konfigurációhoz a változótár elemeiből.

Az összes elérhető modul és metódus áttekintéséhez futtassa a következőt:

notebookutils.help()

Ha segítségre van szüksége egy adott modulhoz, futtassa a következőt:

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

Ismert problémák

  • Ha az 1.2-es verzió feletti futtatókörnyezetet használja, és fut notebookutils.help(), a felsorolt fabricClient és PBIClient API-k még nem támogatottak, de egy későbbi kiadásban lesznek elérhetők.