Interfaccia e controlli del notebook di Databricks

Informazioni su come usare la barra degli strumenti e i menu del notebook di Databricks per controllare le impostazioni di visualizzazione del notebook e delle celle.

Celle del notebook

I notebook contengono una raccolta di due tipi di celle: celle di codice e celle Markdown. Le celle di codice contengono codice eseguibile, mentre le celle Markdown contengono codice Markdown che esegue il rendering di testo e grafica. Markdown può essere usato per documentare o illustrare il codice. È possibile aggiungere celle o remove al notebook per strutturare il lavoro.

È possibile eseguire una singola cella, un gruppo di celle o l'intero notebook contemporaneamente. Una cella del notebook può contenere al massimo 10 MB e l'output è limitato a 20 MB.

Icone e pulsanti della barra degli strumenti notebook

La barra degli strumenti include menu e icone che è possibile usare per gestire e modificare il notebook.

Accanto al nome del notebook sono presenti pulsanti che consentono di modificare la lingua predefinita del notebook e, se il notebook è incluso in una cartella Git di Databricks, aprire la finestra di dialogo Git.

Per visualizzare le versioni precedenti del notebook, fare clic su "Ultima modifica..." messaggio a destra dei menu.

Le icone e i pulsanti a destra della barra degli strumenti sono descritti nel seguito table:

Icon	Descrizione
	Eseguire tutte le celle o arrestare l'esecuzione. Il nome di questo pulsante cambia a seconda dello stato del notebook.
	Aprire il selettore di calcolo. Quando il notebook è connesso a un cluster o a un sql warehouse, questo pulsante mostra il nome della risorsa di calcolo.
	Aprire l'utilità di pianificazione del processo.
	Aprire Delta Live Tables. Questo pulsante viene visualizzato solo se il notebook fa parte di una pipeline Tables di Delta Live.
	Aprire la finestra di dialogo delle autorizzazioni.

Azioni della barra laterale destra

Diverse azioni sono disponibili nella barra laterale destra del notebook, come descritto nell'tableseguente:

Icon	Descrizione
	Aprire i commenti del notebook.
	Aprire l'esperimento del notebook MLflow.
	Aprire la cronologia delle versioni del notebook.
	Aprire Esplora variabili. Disponibile per le variabili Python con Databricks Runtime 12.2 LTS e versioni successive.
	Aprire il pannello dell'ambiente Python. Questo pannello mostra tutte le librerie Python disponibili per il notebook, incluse librerie con ambito notebook, librerie cluster e librerie incluse in Databricks Runtime. Disponibile solo quando il notebook è collegato a un cluster.

Creare celle

I notebook hanno due tipi di celle: codice e Markdown. Il rendering del contenuto delle celle Markdown viene eseguito in HTML. Ad esempio, questo frammento di codice contiene markup per un'intestazione di livello uno:

%md ### Libraries
Import the necessary libraries.

Esegue il rendering come illustrato:

Per creare una nuova cella, passare il puntatore del mouse su una cella nella parte superiore o inferiore. Fare clic su Codice o testo per creare rispettivamente un codice o una cella Markdown.

Azioni cella

Il menu azioni cella consente di eseguire, tagliare e copiare celle, spostare le celle nel notebook e nascondere codice o risultati.

Eseguire una cella

Per eseguire le celle di codice, fare clic sulla freccia giù in alto a sinistra della cella di codice.

Dopo l'esecuzione di una cella, viene visualizzato un avviso a destra del menu di esecuzione della cella, che mostra l'ultima volta che la cella è stata eseguita e la relativa durata. Passare il cursore sopra l'avviso per altri dettagli.

Per visualizzare le informazioni dettagliate sull'esecuzione per impostazione predefinita, fare clic sull'immagine del profilo in alto a destra. Fare quindi clic su Impostazioni> Mostra informazioni dettagliate sull'esecuzione del comando.

Se si dispone di un output dei risultati tabulari, è anche possibile accedere a queste informazioni passando il puntatore del mouse sulla sezione "Ultimo aggiornamento" dell'interfaccia utente.

Icone delle celle

Lo screenshot seguente descrive le icone visualizzate in alto a destra di una cella del notebook:

Selettore della lingua:Select seleziona la lingua per la cella.

Assistente Databricks: abilitare o disabilitare Databricks Assistant per i suggerimenti di codice nella cella.

Stato attivo cella: ingrandire la cella per semplificare la modifica.

Menu Visualizza azioni cella: aprire il menu Azioni cella. Le opzioni in questo menu sono leggermente diverse per il codice e le celle Markdown.

Eliminare una cella

Per eliminare una cella, fare clic sull'icona del cestino a destra della cella. Questa icona viene visualizzata solo quando si passa il cursore sulla cella.

Spostare una cella

Per spostare una cella verso l'alto o verso il basso, fare clic e tenere premuta l'icona del quadratino di trascinamento a sinistra della cella.

È anche possibile selectSpostare su o Spostare verso il basso dal menu azioni della cella.

Tagliare, copiare e incollare celle

Sono disponibili diverse opzioni per tagliare e copiare celle. Tuttavia, se si usa il browser Safari, sono disponibili solo i tasti di scelta rapida.

• Dal menu azioni cella selectTaglia cella o Copia cella.
• Usare i tasti di scelta rapida: Command-X o Ctrl-X per tagliare e Command-C o Ctrl-C copiare.
• Usare il menu Modifica nella parte superiore del notebook. Select Taglia o copia .

Dopo aver tagliato o copiato le celle, è possibile incollare tali celle altrove nel notebook, in un notebook diverso o in un notebook in un'altra scheda del browser o window. Per incollare le celle, usare i tasti di scelta rapida Command-V o Ctrl-V. Le celle vengono incollate sotto la cella corrente.

Per annullare le azioni tagliate o incollate, è possibile utilizzare la scelta rapida da tastiera Command-Z o le opzioni > tagliate o >.

Per select celle adiacenti, fare clic in una cella Markdown e quindi utilizzare Maiusc + su o Giù per select le celle sopra o sotto di essa. Usare il menu di modifica per copiare, tagliare, incollare o eliminare le celle selezionate come gruppo. Per select tutte le celle, selectModifica >Select tutte le celle o utilizza il collegamento in modalità comando Cmd+A.

Aprire Databricks Assistant

Per aprire una casella di testo Databricks Assistant in una cella, fare clic sull'icona Assistente Databricks nell'angolo superiore destro della cella.

È possibile usarlo in una cella di codice per get guida o suggerimenti per il codice. Databricks Assistant deve essere abilitato nell'area di lavoro.

Aggiungere commenti di codice

Per aggiungere un commento al codice in una cella, evidenziare il codice. A destra della cella viene visualizzata un'icona di commento. Fare clic sull'icona per aprire la casella di commento.

Aggiungere una cella a un dashboard

Per aggiungere una cella Markdown o una cella con risultati tabulari a un dashboard, selectAggiungi al dashboard dal menu azioni cella. Per altre informazioni, vedere Dashboard nei notebook.

Collegamento a una cella

Per get un collegamento URL a un comando specifico nel notebook, fare clic per aprire la modalità messa a fuoco e copiare l'URL dalla barra degli indirizzi del browser. Per uscire dalla modalità messa a fuoco, fare clic su .

table del contenuto del notebook

Per visualizzare un table di contenuto generato automaticamente, fare clic sull'icona in alto a sinistra del notebook (tra la barra laterale sinistra e la cella superiore). Il table di contenuto viene generato dalle intestazioni Markdown usate nel notebook. Le celle con titoli vengono visualizzate anche nella table del contenuto.

Aggiungere un titolo di cella

Per aggiungere un titolo a una cella, eseguire una delle operazioni seguenti:

• Fare clic sul numero di cella al centro della cella e digitare il titolo.
• Select Aggiungi il titolo dal menu azioni della cella .

Le celle con titoli vengono visualizzate nel table del contenuto del notebook di .

Titoli di cella alzati di livello

Per rendere più visibili i titoli delle celle nell'interfaccia utente, gli utenti possono abilitare Mostra titoli di cella alzati di livello.

1. Nell'angolo in alto a destra di qualsiasi pagina fare clic sulla foto del profilo, quindi su Impostazioni.
2. Fare clic su Abilita sviluppatore> Mostra titoli di cella alzati di livello.

Nascondere e visualizzare il contenuto della cella

Il contenuto della cella è costituito da codice di cella e dai risultati dell'esecuzione della cella. Per nascondere il codice o i risultati della cella, fare clic sul menu kebab in alto a destra della cella e selectNascondi codice o Nascondi risultato.

È anche possibile selectComprimi cella per visualizzare solo la prima riga di una cella. Per espandere una cella compressa, selectEspandere la cella.

Per visualizzare le celle nascoste, fare clic sull'icona mostra: .

Intestazioni comprimibili

Le celle visualizzate dopo le celle contenenti intestazioni Markdown possono essere compresse nella cella di intestazione. Per espandere o comprimere le celle dopo le celle contenenti intestazioni Markdown in tutto il notebook, selectComprimi tutte le intestazioni dal Menu Visualizza. Nella parte restante di questa sezione viene descritto come espandere o comprimere un subset di celle.

Espandere e comprimere le intestazioni

L'immagine mostra una configurazione MLflow di livello due con le due celle seguenti compresse.

Per espandere e comprimere le intestazioni, passare il cursore sulla cella Markdown. Fare clic sulla freccia visualizzata a sinistra della cella.

Opzioni di visualizzazione cella

Sono disponibili tre opzioni di visualizzazione per i notebook. Usare il menu Visualizza per modificare l'opzione di visualizzazione.

• Visualizzazione standard: i risultati vengono visualizzati immediatamente dopo le celle di codice.
• Solo risultati: vengono visualizzati solo i risultati.
• Side-by-side: il codice e le celle dei risultati vengono visualizzate affiancate.

Le azioni sono disponibili dalle icone nella barra delle celle (l'area a destra e sinistra della cella). Ad esempio, usare i punti di presa per spostare una cella verso l'alto o verso il basso nella barra sinistra. Per eliminare una cella, usare l'icona del cestino nella barra destra.

Per semplificare la modifica, fare clic sull'icona della modalità messa a fuoco per visualizzare la cella a larghezza intera. Per uscire dalla modalità messa a fuoco, fare clic su . È anche possibile ingrandire la larghezza visualizzata di una cella disattivando > centrato.

Per formattare automaticamente tutte le celle del notebook in base alle lunghezze e alla spaziatura standard del settore, selectModifica blocco appunti > formato.

Remove i margini della cella

È possibile espandere o ridurre al minimo i margini facendo clic su Visualizza > layout notebook nel menu notebook.

Numeri di riga e di comando

Per visualizzare o nascondere numeri di riga o numeri di comando, selectnumeri di riga o numeri di comando dal menu Visualizza. Per i numeri di riga, è anche possibile usare i tasti di scelta rapida Ctrl+L. Quando una cella si trova in uno stato di errore, i numeri di riga vengono visualizzati indipendentemente dalla selezione.

Se si abilitano i numeri di riga o di comando, Databricks salva le preferenze e le mostra in tutti gli altri notebook per tale browser.

Ritorno a capo linea

È possibile abilitare o disabilitare il wrapping delle righe nelle celle del notebook, consentendo al testo di eseguire il wrapping su più righe o rimanere su una singola riga con scorrimento orizzontale.

1. Nell'angolo in alto a destra di qualsiasi pagina fare clic sulla foto del profilo, quindi su Impostazioni.
2. Fare clic su Impostazioni>sviluppatore Eseguire il wrapping delle righe.

Visualizzare i notebook in modalità scura

È possibile scegliere di visualizzare i notebook in modalità scura. Per attivare o disattivare la modalità scura, selectVisualizza > tema e selecttema chiaro o tema scuro.

i numeri di riga o di comando ble, Databricks salva le preferenze e le mostra negli altri notebook per tale browser.

Esplorare i dati

Per esplorare tables e volumes disponibili per l'uso nel notebook, fare clic sull'icona dei dati del notebook sul lato sinistro del notebook per aprire il browser schema. Per altri dettagli, vedere Esplorare i dati .

Usare il terminale Web e l'interfaccia della riga di comando di Databricks

Per aprire il terminale Web in un notebook, fare clic nella parte inferiore della barra laterale destra.

Usare l'interfaccia della riga di comando di Databricks in un terminale Web

A partire da Databricks Runtime 15.0, è possibile usare l'interfaccia della riga di comando di Databricks dal terminale Web nel notebook.

Requisiti

• Il notebook deve essere collegato a un cluster in modalità Accesso condiviso con accesso condiviso in modalità Utente singolo o Nessun isolamento.
• L'interfaccia della riga di comando non è disponibile nelle aree di lavoro abilitate per collegamento privato.

L'interfaccia della riga di comando installata è sempre la versione più recente. L'autenticazione si basa sull'utente corrente.

Non è possibile usare l'interfaccia della riga di comando da una cella del notebook. In un notebook, i comandi come %sh databricks ... non funzionano con Databricks Runtime 15.0 o versione successiva.