Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Notebook Utilities (NotebookUtils) è un pacchetto predefinito che consente di eseguire facilmente attività comuni in un notebook Fabric. È possibile usare NotebookUtils per gestire file system, ottenere variabili di ambiente, concatenare notebook e gestire segreti. Il pacchetto NotebookUtils è disponibile per i notebook PySpark (Python) Scala, SparkR, e le pipeline di Fabric.
Note
- MsSparkUtils è stato rinominato ufficialmente NotebookUtils. Il codice esistente rimane compatibile con le versioni precedenti e non causa modifiche di rilievo. È consigliabile eseguire l'aggiornamento a notebookutils per garantire il supporto continuo e l'accesso alle nuove funzionalità. Il namespace mssparkutils verrà dismesso in futuro.
- NotebookUtils è progettato per funzionare con Spark 3.4 (Runtime v1.2) e versioni successive. Tutte le nuove funzionalità e gli aggiornamenti sono supportati esclusivamente con il namespace notebookutils d'ora in poi.
Moduli NotebookUtils
NotebookUtils fornisce i moduli seguenti. Selezionare un modulo per visualizzare documentazione dettagliata, esempi di codice e procedure consigliate.
| Modulo | Namespace | Descrizione |
|---|---|---|
| Utilità del file system | notebookutils.fs |
Usare file e directory in ADLS Gen2, Archiviazione BLOB di Azure e Archiviazione di tipo Lakehouse. Include operazioni di copia, spostamento, lettura, scrittura, eliminazione ed elenco. |
| Montaggio e smontaggio di file | notebookutils.fs |
Collegare l'archiviazione remota (ADLS Gen2) ai nodi Spark come punti di montaggio locali per semplificare l'accesso ai file. |
| Esecuzione e orchestrazione del notebook | notebookutils.notebook |
Eseguire e collegare i notebook, compresa l'esecuzione parallela con supporto DAG, riferimenti incrociati tra aree di lavoro e valori di uscita. |
| Gestione dei notebook | notebookutils.notebook |
Creare, recuperare, aggiornare, eliminare ed elencare programmaticamente gli artefatti del notebook. |
| Utilità delle credenziali | notebookutils.credentials |
Ottenere i token di accesso per i servizi di Azure e recuperare i segreti da Azure Key Vault. |
| Utilità per Lakehouse | notebookutils.lakehouse |
Creare, ottenere, aggiornare, eliminare e gestire elementi e tabelle Lakehouse a livello di codice. |
| Contesto di runtime | notebookutils.runtime |
Accedere alle informazioni sul contesto della sessione, inclusi il nome del notebook, i dettagli dell'area di lavoro e il contesto di esecuzione. |
| Gestione delle sessioni | notebookutils.session |
Arrestare le sessioni interattive e riavviare l'interprete Python. |
| Utilità UDF (User Data Function) | notebookutils.udf |
Recuperare e richiamare funzioni dei dati utente dai notebook. |
| Utilità delle librerie variabili | notebookutils.variableLibrary |
Accedere alle variabili gestite centralmente e alla configurazione dagli elementi della libreria di variabili. |
Per ottenere una panoramica di tutti i moduli e i metodi disponibili, eseguire:
notebookutils.help()
Per ottenere assistenza per un modulo specifico, eseguire:
notebookutils.fs.help()
notebookutils.notebook.help()
notebookutils.credentials.help()
Problemi noti
- Quando si usa la versione di runtime precedente alla 1.2 e si esegue
notebookutils.help(), le API fabricClient e PBIClient elencate non sono ancora supportate, ma saranno disponibili in una versione futura.