Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Notebook Utilities (NotebookUtils) je integrovaný balíček, který vám pomůže snadno provádět běžné úlohy v poznámkovém bloku Fabric. NotebookUtils můžete použít k práci se systémy souborů, k získání proměnných prostředí, ke zřetězení poznámkových bloků a práci s tajnými kódy. Balíček NotebookUtils je k dispozici v noteboocích PySpark (Python), Scala, SparkR a ve Fabric pipelines.
Note
- MsSparkUtils se oficiálně přejmenuje na NotebookUtils. Stávající kód zůstane zpětně kompatibilní a nezpůsobí žádné zásadní změny. Důrazně doporučujeme upgradovat nástroje poznámkových bloků, abyste zajistili pokračující podporu a přístup k novým funkcím. Obor názvů mssparkutils bude v budoucnu vyřazen.
- NotebookUtils je navržený tak, aby fungoval se Sparkem 3.4 (Runtime v1.2) a novějším. Všechny nové funkce a aktualizace budou nadále výhradně podporovány v rámci oboru názvů notebookutils.
Moduly utils pro notebook
NotebookUtils poskytuje následující moduly. Výběrem modulu zobrazíte podrobnou dokumentaci, příklady kódu a osvědčené postupy.
| Modul | Namespace | Description |
|---|---|---|
| Nástroje systému souborů | notebookutils.fs |
Práce se soubory a adresáři v ADLS Gen2, Azure Blob Storage a Lakehouse Storage Zahrnuje operace kopírování, přesouvání, čtení, zápisu, odstranění a výpisu. |
| Připojení a odpojení souboru | notebookutils.fs |
Připojte vzdálené úložiště (ADLS Gen2) k uzlům Sparku jako místní přípojné body pro zjednodušený přístup k souborům. |
| Spuštění a orchestrace notebooku | notebookutils.notebook |
Spouštět a zřetězovat poznámkové bloky, včetně paralelního spouštění s podporou DAG, odkazů mezi pracovními prostory a výstupních hodnot |
| Správa poznámkových bloků | notebookutils.notebook |
Vytváření, získávání, aktualizace, odstraňování a výpis artefaktů poznámkového bloku prostřednictvím kódu programu |
| Nástroje pro přihlašovací údaje | notebookutils.credentials |
Získejte přístupové tokeny pro služby Azure a načtěte tajné kódy ze služby Azure Key Vault. |
| Nástroje pro Lakehouse | notebookutils.lakehouse |
Vytváření, získávání, aktualizace, odstraňování a správa položek a tabulek Lakehouse prostřednictvím kódu programu |
| Kontext modulu runtime | notebookutils.runtime |
Přístup k informacím o kontextu relace, včetně názvu poznámkového bloku, podrobností pracovního prostoru a kontextu spuštění |
| Správa relací | notebookutils.session |
Zastavte interaktivní relace a restartujte interpret Pythonu. |
| Nástroje funkce uživatelských dat (UDF) | notebookutils.udf |
Načtěte a volejte funkce User Data Functions z poznámkových bloků. |
| Nástroje knihovny proměnných | notebookutils.variableLibrary |
Přístup k centrálně spravovaným proměnným a konfiguraci z položek knihovny proměnných |
Pokud chcete získat přehled o všech dostupných modulech a metodách, spusťte:
notebookutils.help()
Pokud chcete získat nápovědu pro konkrétní modul, spusťte:
notebookutils.fs.help()
notebookutils.notebook.help()
notebookutils.credentials.help()
Známé problémy
- Pokud používáte verzi modulu runtime vyšší než 1.2 a spustíte
notebookutils.help(), uvedená rozhraní API fabricClient a PBIClient se zatím nepodporují, ale budou k dispozici v budoucí verzi.