Modifica di base nei notebook di Databricks

Un notebook di Databricks è un editor di codice basato sul Web che consente di scrivere codice e visualizzare i risultati per l'analisi interattiva dei dati. Questa pagina illustra le nozioni di base sull'uso dei notebook in Databricks, tra cui come esplorare la barra degli strumenti ed eseguire varie azioni di cella.

Creare un notebook

Per creare un nuovo notebook, fare clic sul pulsante Nuovo nella barra laterale dell'area di lavoro o Creare un notebook in qualsiasi cartella.

Aprire un notebook

Per aprire un notebook, usare l'area di lavoro funzione di ricerca o usare il browser dell'area di lavoro per passare al notebook e fare clic sul nome o sull'icona del notebook.

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 viene reso come testo e immagini. Usare Markdown per documentare o illustrare il codice. È possibile aggiungere o rimuovere celle di entrambi i tipi al notebook per strutturare il lavoro.

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

pulsanti e icone della barra degli strumenti del 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 per 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 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 nella tabella seguente:

Icona	Descrizione
	Esegui tutte le celle o ferma l'esecuzione. Il nome di questo pulsante cambia a seconda dello stato del notebook.
	Apri 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.
	Apri utilità di pianificazione dei lavori.
	Aprire DLT . Questo pulsante viene visualizzato solo se il notebook fa parte di una pipeline DLT.
	Aprire 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:

Icona	Descrizione
	Aprire i commenti del notebook .
	Apri l'esperimento del notebook MLflow .
icona	Apri la cronologia delle versioni del notebook .
	Apri 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 Code o Text per creare rispettivamente un codice o una cella Markdown.

Azioni della 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 >Developer>Mostra informazioni dettagliate sull'esecuzione dei comandi.

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.

Eseguire le celle selezionate

È possibile eseguire una singola cella o una raccolta di celle. Per selezionare una singola cella, fare clic in un punto qualsiasi della cella. Per selezionare più celle, tenere premuto il tasto Command in MacOS o la chiave Ctrl in Windows e fare clic sulla cella esterna all'area di testo, come illustrato nello screenshot.

Per eseguire le celle selezionate, fare clic su Esegui>Esegui ed esegui>Esegui celle selezionate o usa il Command + Enter di scelta rapida da tastiera in MacOS o Crtl + Enter in Windows. Il comportamento di questo comando dipende dalla risorsa di calcolo a cui è collegato il notebook.

• In una risorsa di calcolo che esegue Databricks Runtime 13.3 LTS o versione successiva, le celle selezionate vengono eseguite singolarmente. Se si verifica un errore in una cella, l'esecuzione continua con le celle successive.
• In una risorsa di calcolo che esegue Databricks Runtime 14.0 o versione successiva o in un'istanza di SQL Warehouse, le celle selezionate vengono eseguite come batch. Qualsiasi errore interrompe l'esecuzione e non è possibile annullare l'esecuzione di singole celle. È possibile usare il pulsante Interrupt per arrestare l'esecuzione di tutte le celle.

Esegui testo selezionato

È possibile evidenziare codice o istruzioni SQL in una cella del notebook ed eseguire solo il codice evidenziato. Ciò è utile quando si vuole scorrere rapidamente il codice e le query.

1. Evidenzia le righe che vuoi eseguire.

2. Selezionare Esegui > Esegui testo selezionato oppure usare il tasto di scelta rapida Ctrl+Shift+Enter. Se non è evidenziato alcun testo, Esegui testo selezionato esegue la riga corrente.

   

Se si usano lingue miste in una cella, è necessario includere la riga %<language> nella selezione.

Esegui testo selezionato esegue anche codice compresso, se presente nella selezione evidenziata.

Sono supportati comandi speciali di cella, ad esempio %run, %pipe %sh.

Non è possibile usare Esegui testo selezionato su celle che hanno più schede di output, ossia celle in cui è stato definito un profilo dati o una visualizzazione.

Icone delle celle

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

selettore lingua: Selezionare la lingua per la cella.

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

Selezione cella: Ingrandire la cella per semplificare la modifica.

Menu Visualizza Azioni Cella: Apri 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.

icona

Spostare una cella

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

È anche possibile selezionare Sposta su o Sposta verso il basso dal menu delle 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 selezionare Taglia cella o Copia cella.
• Usare i tasti di scelta rapida: Command-X o Ctrl-X per tagliare e Command-C o Ctrl-C da copiare.
• Usare il menu Modifica nella parte superiore del notebook. Selezionare il Taglia o il 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 il tasto di scelta rapida Command-V o Ctrl-V. Le celle vengono incollate sotto la cella corrente.

Per annullare le azioni taglia o incolla, è possibile utilizzare la Command-Z di scelta rapida da tastiera o Ctrl-Z o le opzioni di menu Modifica > Annulla celle tagliate o Modifica > Annulla incolla celle.

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 > Selezionare tutte le celle oppure usare il collegamento in modalità comando Cmd+A.

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 al cruscotto.

Per aggiungere una cella Markdown o una cella con risultati tabulari a un dashboard, selezionare Aggiungi al dashboard dal menu Azioni cella. Per ulteriori informazioni, vedere i cruscotti nei notebook.

Collegamento a una cella

Per ottenere un collegamento URL a un comando specifico nel notebook, fare clic per l'apertura della modalità di messa a fuoco e copiare l'URL dalla barra degli indirizzi del browser. Per uscire dalla modalità messa a fuoco, fare clic sull'icona di uscita dalla messa a fuoco della cella .

Aprire Databricks Assistant

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

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