Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Notebook Utilities (NotebookUtils) is een ingebouwd pakket om u te helpen eenvoudig algemene taken uit te voeren in Fabric Notebook. U kunt NotebookUtils gebruiken om te werken met bestandssystemen, om omgevingsvariabelen op te halen, notebooks aan elkaar te koppelen en met geheimen te werken. Het NotebookUtils-pakket is beschikbaar in PySpark (Python) Scala, SparkR-notebooks en Fabric-pijplijnen.
Note
- MsSparkUtils is officieel hernoemd naar NotebookUtils. De bestaande code blijft compatibel met eerdere versies en veroorzaakt geen wijzigingen die fouten veroorzaken. Het wordt sterk aanbevolen om een upgrade uit te voeren naar notebookutils om te zorgen voor continue ondersteuning en toegang tot nieuwe functies. De mssparkutils-naamruimte wordt in de toekomst buiten gebruik gesteld.
- NotebookUtils is ontworpen voor gebruik met Spark 3.4 (Runtime v1.2) en hoger. Alle nieuwe functies en updates worden voortaan exclusief ondersteund door de naamruimte notebookutils.
NotebookUtils-modules
NotebookUtils biedt de volgende modules. Selecteer een module om gedetailleerde documentatie, codevoorbeelden en aanbevolen procedures te bekijken.
| Module | Namespace | Beschrijving |
|---|---|---|
| Hulpprogramma's voor bestandssysteem | notebookutils.fs |
Werk met bestanden en mappen in ADLS Gen2, Azure Blob Storage en Lakehouse-opslag. Bevat kopieer-, verplaatsings-, lees-, schrijf-, verwijder- en lijstbewerkingen. |
| Bestand koppelen en ontkoppelen | notebookutils.fs |
Koppel externe opslag (ADLS Gen2) aan Spark-knooppunten als lokale koppelpunten voor vereenvoudigde bestandstoegang. |
| Notebook uitvoeren en organiseren | notebookutils.notebook |
Notebooks samen uitvoeren en aan elkaar koppelen, inclusief parallelle uitvoering met DAG-ondersteuning, verwijzingen tussen verschillende werkruimten en uitvoerwaarden. |
| Notebookbeheer | notebookutils.notebook |
Programmatisch notebookartefacten maken, ophalen, bijwerken, verwijderen en vermelden. |
| Hulpprogramma's voor toegangsgegevens | notebookutils.credentials |
Toegangstokens ophalen voor Azure-services en geheimen ophalen uit Azure Key Vault. |
| Lakehouse-hulpprogramma's | notebookutils.lakehouse |
Programmatisch Lakehouse-items en -tabellen maken, ophalen, bijwerken, verwijderen en beheren. |
| Runtimecontext | notebookutils.runtime |
Toegang tot sessiecontextinformatie, waaronder naam van notitieblok, werkruimtedetails en uitvoeringscontext. |
| Sessiebeheer | notebookutils.session |
Stop interactieve sessies en start de Python-interpreter opnieuw op. |
| Hulpprogramma's voor User Data Function (UDF) | notebookutils.udf |
Gebruikersgegevensfuncties ophalen en aanroepen vanuit notebooks. |
| Variabele-bibliotheekvoorzieningen | notebookutils.variableLibrary |
Toegang tot centraal beheerde variabelen en configuratie vanuit items in de variabelebibliotheek. |
Voer de volgende opdracht uit om een overzicht te krijgen van alle beschikbare modules en methoden:
notebookutils.help()
Als u hulp nodig hebt voor een specifieke module, voert u het volgende uit:
notebookutils.fs.help()
notebookutils.notebook.help()
notebookutils.credentials.help()
Bekende problemen
- Wanneer u runtimeversie boven 1.2 gebruikt en
notebookutils.help()uitvoert, worden de genoemde fabricClient en PBIClient-API's nog niet ondersteund, maar zullen beschikbaar zijn in een toekomstige release.