Condividi tramite

Gestire il formato del notebook

  • Articolo

Questo articolo descrive il formato predefinito del notebook in Azure Databricks, come modificare il formato del notebook e come gestire i commit se il notebook si trova in una cartella controllata dal codice sorgente.

Per impostazione predefinita, i notebook in Databricks vengono creati in formato .ipynb (IPython o Jupyter). È anche possibile scegliere di usare il formato di origine.

È comunque possibile importare ed esportare notebook in vari formati. Vedere Esportare e importare i notebook di Databricks.

Formati di notebook

Databricks supporta la creazione e la modifica di notebook in due formati: IPYNB (impostazione predefinita) e sorgente.

È possibile gestire i file di origine, inclusi i notebook, usando cartelle Git. Solo alcuni tipi di asset Databricks sono supportati nelle cartelle Git. Il formato del notebook ha implicazioni sugli output che vengono registrati nel repository remoto, come descritto nella tabella seguente.

Formato sorgente notebook Dettagli
fonte Formato di base che acquisisce solo il codice sorgente, con un suffisso che segnala il linguaggio di codice, ad esempio .py, .scala, .r e .sql.
IPYNB (Jupyter) Formato avanzato che acquisisce il codice sorgente, l'ambiente notebook, le definizioni di visualizzazione, i widget del notebook e gli output facoltativi. Un notebook IPYNB può contenere codice in qualsiasi linguaggio supportato dai notebook di Databricks (nonostante la parte py di .ipynb). Il formato IPYNB (Jupyter) consente all'utente di eseguire facoltativamente il commit degli output. IPYNB supporta anche un'esperienza di visualizzazione migliore per i notebook di Databricks nei repository Git remoti.

Per distinguere i notebook di Databricks dai normali file Python, Scala e SQL, Azure Databricks aggiunge il commento "Databricks notebook source" all'inizio dei notebook Python, Scala e SQL. Questo commento garantisce che Azure Databricks analizzi correttamente il file come notebook anziché come file di script.

Nota

Che cosa sono gli "output"?

Gli output sono i risultati dell'esecuzione di un notebook sulla piattaforma Databricks, inclusi i display delle tabelle e le visualizzazioni.

Modificare l'impostazione predefinita del formato del notebook

I notebook IPYNB sono il formato predefinito durante la creazione di un nuovo notebook in Azure Databricks.

Per modificare il formato sorgente predefinito di Azure Databricks, accedere all'area di lavoro di Azure Databricks, fare clic sul profilo nell'angolo in alto a destra della pagina, quindi fare clic su Impostazioni e navigare fino a Sviluppatore. Modificare il formato predefinito del notebook sotto il titolo delle impostazioni dell'Editor .

Modificare il formato predefinito del notebook nelle impostazioni di sviluppo del proprio profilo

Convertire il formato del notebook

È possibile convertire un notebook esistente in un altro formato tramite l'interfaccia utente di Azure Databricks.

Per convertire un notebook esistente in un altro formato:

  1. Aprire il notebook nell'area di lavoro.

  2. Selezionare File dal menu dell'area di lavoro, quindi selezionare Formato notebooke quindi scegliere il formato desiderato. È possibile scegliere Jupyter (.ipynb) (scelta consigliata) oppure Codice sorgente (.scala, .py, .sql, .r). Il formato attuale del notebook è visualizzato in grigio e ha un segno di spunta accanto.

    Il menu file dell'area di lavoro, quando espanso, mostra l'opzione di formato notebook.

Per ulteriori informazioni sui tipi di notebook supportati in Azure Databricks, leggere "Esportare e importare notebook di Databricks".

Gestire i commit dell'output del notebook IPYNB

Per i notebook IPYNB nelle cartelle controllate dall'origine, è possibile gestire il commit degli output dei notebook nel repository remoto.

Consenti il commit degli output del notebook di .ipynb

È possibile eseguire il commit degli output solo se un amministratore dell'area di lavoro ha abilitato questa funzionalità. Per impostazione predefinita, l'impostazione amministrativa per le cartelle Git non consente il commit dell'output del notebook .ipynb. Se si dispone dei privilegi di amministratore per l'area di lavoro, è possibile modificare questa impostazione:

  1. Passare a Impostazioni amministratore,,>,, Impostazioni area di lavoro nella console di amministrazione di Azure Databricks.

  2. In cartelle Gitscegliere Consenti alle cartelle Git di esportare gli output IPYNB e quindi selezionare Consenti: gli output IPYNB possono essere attivati o disattivati in.

    Console di amministrazione: consente alle cartelle Git di esportare gli output IPYNB.

Importante

Quando sono inclusi gli output, le configurazioni di visualizzazione e dei dashboard vengono inserite nei notebook.ipynb che crei.

Controllo dei commit degli artefatti di output del notebook IPYNB

Quando si esegue il commit di un file di .ipynb, Databricks crea un file di configurazione che consente di controllare la modalità di commit degli output: .databricks/commit_outputs.

  1. Se si dispone di un file di notebook .ipynb ma non è presente alcun file di configurazione nel repository remoto, passa alla finestra di dialogo Git Status.

  2. Nella finestra di notifica, seleziona Crea file commit_outputs.

    interfaccia utente per il commit del notebook: pulsante Crea file commit_outputs.

È anche possibile generare file di configurazione dal menu file. Il menu File dispone di un controllo per aggiornare automaticamente il file di configurazione dove puoi specificare l'inclusione o l'esclusione degli output per un notebook IPYNB specifico.

  1. Nel menu File selezionare Commit output dei notebook.

    Editor di notebook: Effettua il commit degli stati e dei controlli degli output dei notebook.

  2. Nella finestra di dialogo confermare la scelta di eseguire il commit degli output del notebook.

    finestra di dialogo Commit degli output dei notebook.