Poznámka
Na prístup k tejto stránke sa vyžaduje oprávnenie. Môžete sa skúsiť prihlásiť alebo zmeniť adresáre.
Na prístup k tejto stránke sa vyžaduje oprávnenie. Môžete skúsiť zmeniť adresáre.
Notebook Utilities (NotebookUtils) je zabudovaný balík, ktorý vám pomôže jednoducho vykonávať bežné úlohy v notebookoch v Microsoft Fabric. NotebookUtils môžete používať na prácu so súborovými systémami, získavanie premenných prostredia, reťazové poznámkové bloky a prácu s tajomstvámi. Balík NotebookUtils je k dispozícii v nástrojoch Scala (Python) v PySparku, poznámkových blokoch SparkR a kanáloch služby Fabric.
Note
- MsSparkUtils je oficiálne premenovaný na NotebookUtils. Existujúci kód zostáva spätne kompatibilný a nespôsobuje žiadne zásadné zmeny. Dôrazne sa odporúča prejsť na notebookutils, aby ste zabezpečili pokračujúcu podporu a prístup k novým funkciám. Priestor názvov mssparkutils sa v budúcnosti vyradí.
- NotebookUtils je navrhnutý tak, aby pracoval so Spark 3.4 (Runtime v1.2) a vyšším. Všetky nové funkcie a aktualizácie sú výhradne podporované v mennom priestore notebookutils od budúcnosti.
Moduly NotebookUtils
NotebookUtils poskytuje nasledujúce moduly. Vyberte modul a pozrite si podrobnú dokumentáciu, príklady kódu a osvedčené postupy.
| Modul | Priestor názvov | Description |
|---|---|---|
| Nástroje súborového systému | notebookutils.fs |
Pracujte so súbormi a adresármi naprieč ADLS Gen2, Azure Blob Storage a Lakehouse storage. Zahŕňa kopírovanie, presúvanie, čítanie, zápis, mazanie a zoznamovanie. |
| Montáž a odmontovanie súboru | notebookutils.fs |
Pripojiť vzdialené úložisko (ADLS Gen2) k uzlom Spark ako lokálne montážne body pre zjednodušený prístup k súborom. |
| Zápisník a orchestrácia | notebookutils.notebook |
Spúšťajte a reťazte notebooky dokopy, vrátane paralelného vykonávania s podporou DAG, referencií medzi pracovnými priestormi a výstupných hodnôt. |
| Správa zápisníka | notebookutils.notebook |
Programovo vytvárajte, získavajte, aktualizujte, mažte a zoznamujte artefakty v zápisníku. |
| Nástroje na prihlasovacie údaje | notebookutils.credentials |
Získajte prístupové tokeny pre Azure služby a získajte tajomstvá z Azure Key Vault. |
| Inžinierske siete pri jazerných domoch | notebookutils.lakehouse |
Vytvárajte, získavajte, aktualizujte, mažte a spravujte položky a tabuľky Lakehouse programovane. |
| Kontext behu | notebookutils.runtime |
Získajte informácie o kontexte relácie vrátane názvu zápisníka, detailov pracovného priestoru a kontextu vykonávania. |
| Riadenie relácií | notebookutils.session |
Zastavte interaktívne relácie a reštartujte Python interpreter. |
| Nástroje User Data Function (UDF) | notebookutils.udf |
Načítajte a vyvolajte funkcie používateľských dát z notebookov. |
| Knižničné nástroje pre premenné | notebookutils.variableLibrary |
Prístup k centrálne spravovaným premenným a konfigurácii z položiek knižnice premenných. |
Pre prehľad všetkých dostupných modulov a metód použite nasledovné:
notebookutils.help()
Ak chcete získať pomoc s konkrétnym modulom, skúsťte:
notebookutils.fs.help()
notebookutils.notebook.help()
notebookutils.credentials.help()
Známe problémy
- Pri používaní runtime verzie nad 1.2 a spustenom
notebookutils.help(), uvedené fabricClient a PBIClient API zatiaľ nie sú podporované, ale budú dostupné v budúcej verzii.