Interfaccia e controlli del notebook di Databricks
La barra degli strumenti del notebook 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.
Progettazione delle celle aggiornata
Importante
Questa funzionalità è disponibile in anteprima pubblica.
È disponibile una progettazione aggiornata delle celle. Questa pagina include informazioni su come usare entrambe le versioni della progettazione delle celle. Per un orientamento alla nuova interfaccia utente e risposte alle domande comuni, vedi Orientamento alla nuova interfaccia utente della cella.
Per abilitare o disabilitare la nuova progettazione di celle, aprire la pagina delle impostazioni dell'editor nell'area di lavoro. Nella barra laterale fare clic su Sviluppatore. In Funzionalità sperimentali attivare o disattivare Nuova interfaccia utente della cella.
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. Le celle Markdown contengono codice Markdown che esegue il rendering in testo e grafica quando la cella viene eseguita e può essere usata per documentare o illustrare il codice. È possibile aggiungere o rimuovere celle al notebook per strutturare il lavoro.
È possibile eseguire una singola cella, un gruppo di celle o eseguire l'intero notebook contemporaneamente. Una cella del notebook può contenere al massimo 10 MB. L'output della cella del notebook è limitato a 20 MB.
Icone e pulsanti della barra degli strumenti notebook
Le icone e i pulsanti a destra della barra degli strumenti sono descritti nella tabella seguente:
| 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 tabelle aperte Delta Live. Questo pulsante viene visualizzato solo se il notebook fa parte di una pipeline di tabelle live Delta. |
 |
Aprire la finestra di dialogo delle autorizzazioni. |
Azioni della barra laterale destra
Diverse azioni sono disponibili nella barra laterale destra del notebook, come descritto nella tabella seguente:
| 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. |
Esplorare i dati
Importante
Questa funzionalità è disponibile in anteprima pubblica.
Per esplorare tabelle e volumi disponibili per l'uso nel notebook, fare clic 
sul lato sinistro del notebook per aprire il browser dello schema. Per altri dettagli, vedere Esplorare i dati .
Menu Azioni cella
Il menu azioni cella consente di tagliare e copiare celle, spostare le celle nel notebook e nascondere il codice o i risultati. Il menu ha un aspetto diverso nell'interfaccia utente originale e nella nuova interfaccia utente. Questa sezione include istruzioni per entrambe le versioni.
Se l'Assistente Databricks è abilitato nell'area di lavoro, è possibile usarlo in una cella di codice per ottenere assistenza o suggerimenti per il codice. Per aprire una casella di testo Databricks Assistant in una cella, fare clic sull'icona 
Assistente Databricks nell'angolo superiore destro della cella.
È possibile modificare facilmente una cella tra codice e markdown o modificare la lingua di una cella di codice, usando il pulsante della lingua delle celle nell'angolo superiore destro della cella.
Menu Azioni cella (interfaccia utente originale)
Da questo menu è anche possibile eseguire celle di codice:
Il menu azione cella include anche pulsanti che consentono di nascondere una cella o eliminare una cella 
.
Per le celle Markdown è disponibile anche un'opzione per aggiungere la cella a un dashboard. Per altre informazioni, vedere Dashboard nei notebook.
Usare le celle nella nuova interfaccia utente
Lo screenshot seguente descrive le icone visualizzate in alto a destra di una cella del notebook:
Selettore lingua: selezionare 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.
Per eseguire celle di codice nella nuova interfaccia utente, 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 durata dell'esecuzione. Passare il cursore sopra l'avviso per altri dettagli.
Per aggiungere una cella Markdown o una cella con risultati tabulari a un dashboard, selezionare Aggiungi al dashboard dal menu azioni cella. Per altre informazioni, vedere Dashboard nei notebook.
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.
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.
Per spostare una cella verso l'alto o verso il basso, fare clic e tenere premuto 
all'esterno dell'angolo superiore sinistro della cella e trascinare la cella nella nuova posizione. È anche possibile selezionare Sposta su o Sposta giù dal menu azioni cella.
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:
Creare una cella (interfaccia utente originale)
Per creare una nuova cella nell'interfaccia utente originale, passare il puntatore del mouse su una cella nella parte superiore o inferiore e fare clic sull'icona 
. È anche possibile usare il menu della cella del notebook: fare clic 
su e selezionare Aggiungi cella sopra o Aggiungi cella sottostante.
Per una cella di codice, è sufficiente digitare il codice nella cella. Per creare una cella Markdown, selezionare Markdown dal pulsante della lingua della cella o digitare %md nella parte superiore della cella.
Creare una cella (nuova interfaccia utente)
Per creare una nuova cella nella nuova interfaccia utente, 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.
Tagliare, copiare e incollare celle
Sono disponibili diverse opzioni per tagliare e copiare le celle. Se si usa il browser Safari, sono disponibili solo i tasti di scelta rapida.
- Dal menu azioni cella nell'interfaccia utente originale o nella nuova interfaccia utente selezionare Taglia cella o Copia cella.
- Usare i tasti di scelta rapida:
Command-XoCtrl-Xper tagliare eCommand-CoCtrl-Ccopiare. - Usare il menu Modifica nella parte superiore del notebook. Selezionare 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 o finestra del browser. 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 di menu Modifica > le celle tagliate o Modifica > Annulla incolla celleCtrl-Z.
Per selezionare le celle adiacenti, fare clic in una cella Markdown e quindi usare Maiusc + su o Giù per selezionare le celle sopra o sotto di essa. Usare il menu di modifica per copiare, tagliare, incollare o eliminare le celle selezionate come gruppo. Per selezionare tutte le celle, selezionare Modifica > Seleziona tutte le celle o usare il collegamento in modalità comando Cmd+A.
Sommario del notebook
Per visualizzare un sommario generato automaticamente, fare clic sull'icona in alto a sinistra del notebook (tra la barra laterale sinistra e la cella superiore). Il sommario viene generato dalle intestazioni Markdown usate nel notebook. Se si usa la nuova interfaccia utente, le celle con titoli vengono visualizzate anche nel sommario.
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.
Nella nuova interfaccia utente, le azioni sono disponibili dalle icone nella barra delle celle (l'area a destra e sinistra della cella). Ad esempio, per spostare una cella verso l'alto o verso il basso, usare i punti di presa 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 il layout centrato.>
Per formattare automaticamente tutte le celle del notebook in base alle lunghezze e alla spaziatura standard del settore, selezionare Modifica > formato notebook.
Numeri di riga e di comando
Per visualizzare o nascondere numeri di riga o numeri di comando, selezionare Numeri di riga o Numeri di comando dal menu Visualizza. Per i numeri di riga, è anche possibile usare i tasti di scelta rapida Ctrl+L.
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.
Numeri di riga e di comando (interfaccia utente originale)
I numeri di comando sopra le celle si collegano a quel comando specifico. Se si fa clic sul numero di comando per una cella, aggiorna l'URL da ancorare a tale comando. Per ottenere un collegamento URL a un comando specifico nel notebook, fare clic con il pulsante destro del mouse sul numero di comando e scegliere Copia indirizzo collegamento.
Numeri di riga e comando (nuova interfaccia utente)
I numeri di riga sono disattivati per impostazione predefinita nella nuova interfaccia utente. Per attivarli, selezionare Visualizza > numeri di riga. Quando una cella si trova in uno stato di errore, i numeri di riga vengono visualizzati indipendentemente dalla selezione.
Per attivare o disattivare i numeri di comando, selezionare Visualizza > numeri di comando.
La nuova interfaccia utente non include collegamenti al numero di comando della cella. Per ottenere 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 .
Aggiungere un titolo di cella
Per aggiungere un titolo a una cella usando l'interfaccia utente originale, selezionare Mostra titolo dal menu azioni cella.
Per aggiungere un titolo a una cella usando la nuova interfaccia utente, eseguire una delle operazioni seguenti:
- Fare clic sul numero di cella visualizzato al centro della cella e digitare il titolo.
- Selezionare Aggiungi titolo dal menu Azioni cella.
Con la nuova interfaccia utente, le celle con titoli vengono visualizzate nel sommario del notebook.
Visualizzare i notebook in modalità scura
È possibile scegliere di visualizzare i notebook in modalità scura. Per attivare o disattivare la modalità scura, selezionare Visualizza > tema e selezionare Tema chiaro o Tema scuro.
Nascondere e visualizzare il contenuto della cella
Il contenuto della cella è costituito da codice di cella e dai risultati generati eseguendo la cella. È possibile nascondere e visualizzare il codice della cella e il risultato usando il menu azioni cella in alto a destra della cella.
Per le funzionalità correlate, vedere Intestazioni collapible.
Nascondere e visualizzare il contenuto della cella (interfaccia utente originale)
Per nascondere il codice o i risultati della cella, fare clic su e selezionare Nascondi codice o Nascondi risultato. È anche possibile selezionare questa opzione per visualizzare solo la prima riga di una cella.
Per visualizzare il codice o i risultati della cella nascosti, fare clic su Mostra collegamenti:
Nascondere e visualizzare il contenuto della cella (nuova interfaccia utente)
Per nascondere il codice o i risultati della cella, fare clic sul menu 
kebab in alto a destra della cella e selezionare Nascondi codice o Nascondi risultato. È anche possibile selezionare Comprimi cella per visualizzare solo la prima riga di una cella. Per espandere una cella compressa, selezionare Espandi cella.
Per visualizzare il codice o i risultati della cella nascosti, 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, selezionare Comprimi tutte le intestazioni dal menu Visualizza . Nella parte restante di questa sezione viene descritto come espandere o comprimere un subset di celle.
Per le funzionalità correlate, vedere Nascondere e visualizzare il contenuto delle celle.
Espandere e comprimere le intestazioni (interfaccia utente originale)
L'immagine mostra una configurazione MLflow di livello due con le due celle seguenti compresse.
Per espandere e comprimere le intestazioni, fare clic su + e -.
Espandere e comprimere le intestazioni (nuova interfaccia utente)
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.
Risorse di calcolo per notebook
Questa sezione illustra le opzioni per le risorse di calcolo dei notebook. È possibile eseguire un notebook in un cluster Databricks o, per i comandi SQL, è anche possibile usare un'istanza di SQL Warehouse, un tipo di calcolo ottimizzato per l'analisi SQL.
Collegare un notebook a un cluster
Per collegare un notebook a un cluster, è necessaria l'autorizzazione CAN ATTACH TO a livello di cluster.
Importante
Se un notebook è collegato a un cluster, qualsiasi utente con l'autorizzazione CAN RUN per il notebook dispone dell'autorizzazione implicita per accedere al cluster.
Per collegare un notebook a un cluster, fare clic sul selettore di calcolo nella barra degli strumenti del notebook e selezionare un cluster dal menu a discesa.
Il menu mostra una selezione di cluster usati di recente o attualmente in esecuzione.
Per selezionare tutti i cluster disponibili, fare clic su Altro. Fare clic sul nome del cluster per visualizzare un menu a discesa e selezionare un cluster esistente.
È anche possibile creare un nuovo cluster selezionando Crea nuova risorsa dal menu a discesa.
Importante
Per un notebook collegato sono definite le variabili Apache Spark seguenti.
| Classe | Nome variabile |
|---|---|
SparkContext |
sc |
SQLContext/HiveContext |
sqlContext |
SparkSession (Spark 2.x) |
spark |
Non creare un SparkSessionoggetto , SparkContexto SQLContext. In questo modo si verifica un comportamento incoerente.
Usare un notebook con un'istanza di SQL Warehouse
Quando un notebook è collegato a un'istanza di SQL Warehouse, è possibile eseguire celle SQL e Markdown. L'esecuzione di una cella in qualsiasi altro linguaggio, ad esempio Python o R, genera un errore. Le celle SQL eseguite in un'istanza di SQL Warehouse vengono visualizzate nella cronologia delle query di SQL Warehouse. L'utente che ha eseguito una query può visualizzare il profilo di query dal notebook facendo clic sul tempo trascorso nella parte inferiore dell'output.
L'esecuzione di un notebook richiede un'istanza di SQL Warehouse Pro o Serverless. È necessario avere accesso all'area di lavoro e al warehouse SQL.
I widget funzionano in modo diverso quando un notebook è collegato a un'istanza di SQL Warehouse. Per informazioni dettagliate, vedere Usare i widget di Databricks in un'istanza di SQL Warehouse.
Per collegare un notebook a un'istanza di SQL Warehouse , eseguire le operazioni seguenti:
Fare clic sul selettore di calcolo nella barra degli strumenti del notebook. Il menu a discesa mostra le risorse di calcolo attualmente in esecuzione o usate di recente. I warehouse SQL sono contrassegnati con
.Dal menu selezionare un'istanza di SQL Warehouse.
Per visualizzare tutti i warehouse SQL disponibili, selezionare Altro... dal menu a discesa. Viene visualizzata una finestra di dialogo che mostra le risorse di calcolo disponibili per il notebook. Selezionare SQL Warehouse, scegliere il warehouse da usare e fare clic su Connetti.
È anche possibile selezionare un'istanza di SQL Warehouse come risorsa di calcolo per un notebook SQL quando si crea un flusso di lavoro o un processo pianificato.
Le limitazioni di SQL Warehouse includono:
- Quando si è collegati a un data warehouse SQL, i contesti di esecuzione hanno un timeout di inattività di 8 ore.
- Le dimensioni massime per i risultati restituiti sono pari a 10.000 righe o 2 MB, a seconda del valore minore.
Scollegare un notebook
Per scollegare un notebook da una risorsa di calcolo, fare clic sul selettore di calcolo nella barra degli strumenti del notebook e passare il puntatore del mouse sul cluster collegato o sql warehouse nell'elenco per visualizzare un menu laterale. Scegliere Scollega dal menu laterale.
È anche possibile scollegare i notebook da un cluster usando la scheda Notebooks nella pagina dei dettagli del cluster.
Quando si scollega un notebook, il contesto di esecuzione viene rimosso e tutti i valori delle variabili calcolate vengono cancellati dal notebook.
Suggerimento
Azure Databricks consiglia di scollegare i notebook inutilizzati dai cluster. In questo modo si libera spazio di memoria sul driver.
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. I comandi come %sh databricks ... in un notebook non funzionano con Databricks Runtime 15.0 o versione successiva.