Esplorare il notebook e l'editor di file di Databricks

Questo articolo descrive le funzioni disponibili per esplorare il notebook e l'editor di file di Databricks, inclusi i tasti di scelta rapida, i suggerimenti di codice e il completamento automatico, l'ispezione delle variabili e la riduzione del codice. Quando si usa il notebook o l'editor di file, Databricks Assistant è disponibile per facilitare la generazione, la spiegazione e il debug del codice. Per informazioni dettagliate, vedere Ottenere assistenza per la codifica da Databricks Assistant.

Si può scegliere tra una selezione di temi dell'editor. Selezionare Visualizza > tema editor e scegliere un'opzione dal menu.

palette dei comandi

È possibile eseguire rapidamente azioni nel notebook usando il riquadro comandi. Per aprire un pannello di azioni del notebook, fare clic Nell'angolo in basso a destra dell'area di lavoro oppure usare il collegamento Cmd + MAIUSC + P in MacOS o CTRL + MAIUSC + P in Windows.

Minimappa esecuzione delle celle

Per ottenere una panoramica visiva dello stato di esecuzione del notebook, usare la minimap di esecuzione della cella. Il minimop viene visualizzato nel margine destro e mostra una barra di stato per ogni cella eseguibile.

Le barre di stato indicano gli stati di esecuzione seguenti:

• Grigio chiaro: la cella è statica.
• Grigio scuro: la cella viene ignorata o accodata per l'esecuzione.
• Grigio chiaro con barra mobile: la cella è attualmente in esecuzione.
• Verde: la cella è stata eseguita correttamente senza errori.
• Rosso: la cella non è riuscita con un errore.

Per interagire con la minimap:

• Passare il puntatore del mouse sul minimop per visualizzare un elenco di celle eseguibili, i relativi titoli e i relativi stati di esecuzione.
• Fare clic su una voce per passare direttamente a tale cella nel notebook.
• Fare clic su Vai all'ultima cella di esecuzione o Vai alla prima cella non riuscita per passare all'ultima esecuzione o alla prima cella non riuscita.

La minimap consente di tenere traccia dello stato di avanzamento dell'esecuzione a colpo d'occhio e di spostarsi rapidamente durante il debug o lo sviluppo.

Trovare e sostituire il testo

Per trovare e sostituire il testo all'interno di un notebook, usare la scelta rapida da tastiera, Cmd + F (Mac) o Ctrl + F(Windows), oppure fare clic su Modifica > Trova... per aprire la finestra di dialogo Trova. Immettere il testo che si desidera trovare. Il risultato corrente è evidenziato in arancione mentre tutti gli altri risultati sono evidenziati in giallo. Per accedere alla ricerca del browser nativo, premere Cmd + F di nuovo (Mac) o Ctrl + F(Windows).

Fare clic per aprire l'opzione Sostituisci. Immettere invece il testo da usare. Per sostituire la corrispondenza attuale, clicca su Sostituisci. Per sostituire tutte le corrispondenze nel notebook, fare clic su Sostituisci tutto.

Per spostarsi tra corrispondenze, fare clic (corrispondenza precedente) o (corrispondenza successiva). È anche possibile premere Shift + Enter e Enter per passare rispettivamente alle corrispondenze precedenti e successive.

Per chiudere lo strumento trova e sostituisci, fare clic oppure premere ESC.

Ispezione variabile

Per visualizzare informazioni su una variabile definita in un notebook SQL o Python, passare il cursore sul nome della variabile. Per eseguire l'ispezione delle variabili Python è necessario Databricks Runtime 12.2 LTS o versione successiva.

Vedi Esplora variabili.

Andare a Definizione

Quando un notebook Python è collegato a una risorsa di calcolo, è possibile passare rapidamente alla definizione di una variabile, di una funzione o al codice dietro un'istruzione %run. A tale scopo, fare clic con il pulsante destro del mouse sulla variabile o sul nome della funzione e poi scegliere Vai alla definizione o Visualizza definizione.

Tenere premuto il tasto cmd in macOS o il tasto CTRL in Windows e passare il puntatore del mouse sulla variabile o sul nome della funzione. Se viene trovata una definizione, il nome diventa un collegamento ipertestuale.

La funzionalità "Vai alla definizione" è disponibile in Databricks Runtime 12.2 LTS e versioni successive.

Riduzione del codice

La riduzione del codice consente di nascondere temporaneamente sezioni di codice. Ciò può essere utile quando si lavora con blocchi di codice lunghi, perché consente di concentrarsi su sezioni specifiche del codice su cui si sta lavorando.

Per nascondere il codice, posizionare il cursore all'estrema sinistra di una cella. Le frecce verso il basso vengono visualizzate in punti logici in cui è possibile nascondere una sezione di codice. Fare clic sulla freccia per nascondere una sezione di codice. Fare di nuovo clic sulla freccia (ora rivolta a destra) per visualizzare il codice.

Per altri dettagli, inclusi i tasti di scelta rapida, si veda la documentazione di VS Code.

Supporto multicursor

È possibile creare più cursori per semplificare le modifiche simultanee, come illustrato nel video:

Per creare più cursori in una cella:

• In macOS tenere premuto il tasto Option e fare clic in ogni posizione per aggiungere un cursore.
• In Windows tenere premuto il tasto Alt e fare clic in ogni posizione per aggiungere un cursore.
• C'è anche la possibilità di modificare il collegamento rapido. Consultare Cambia scorciatoia per la selezione di multicursore e colonne.

In macOS è possibile creare più cursori allineati verticalmente usando i tasti di scelta rapida Option+Command+ freccia su o giù.

Selezione colonna/riga

Per selezionare più elementi in una colonna, fare clic in alto a sinistra nell'area da acquisire. Then:

• In macOS premere Shift + Option e trascinare in basso a destra per acquisire una o più colonne.
• In Windows premere Shift + Alt e trascinare in basso a destra per acquisire una o più colonne.
• C'è anche la possibilità di modificare il collegamento rapido. Consultare Cambia scorciatoia per la selezione di multicursore e colonne.

Modifica la scorciatoia da tastiera per la selezione multi-cursore e di colonna

È disponibile un collegamento alternativo per la selezione multicursore e colonna (casella). Con la selezione alternativa, i collegamenti rapidi cambiano nel modo seguente:

• Per creare più cursori in una cella:
  • In macOS tenere premuto il tasto Cmd e fare clic in ogni posizione per aggiungere un cursore.
  • In Windows tenere premuto il tasto Ctrl e fare clic in ogni posizione per aggiungere un cursore.
• Per selezionare più elementi in una colonna, fare clic in alto a sinistra nell'area da acquisire. Then:
  • In macOS premere Option e trascinare in basso a destra per acquisire una o più colonne.
  • In Windows premere Alt e trascinare in basso a destra per acquisire una o più colonne.

Per abilitare i collegamenti rapidi alternativi, eseguire le seguenti operazioni:

1. Fare clic sul nome utente in alto a destra dell'area di lavoro, quindi fare clic su Impostazioni nell'elenco a discesa.
2. Nella barra laterale Impostazioni selezionare Developer.
3. Nella sezione Editor di codice modificare l’impostazione modificatore di tasti per il clic con più cursori in Cmd per macOS o CTRL per Windows.

Quando si abilitano i collegamenti rapidi alternativi, la scelta rapida da tastiera per la creazione di più cursori allineati verticalmente non cambia.

Esplorare i dati

Usare il browser dello schema per esplorare gli oggetti del Catalogo Unity disponibili per il notebook. Fare clic Sul lato sinistro del notebook per aprire il browser dello schema.

Il pulsante Per l'utente visualizza solo gli oggetti usati nella sessione corrente o contrassegnati in precedenza come Preferiti.

Quando si digita testo nella casella filtro , la visualizzazione cambia per visualizzare solo gli oggetti che contengono il testo digitato. Vengono visualizzati solo gli oggetti attualmente aperti o aperti nella sessione corrente. La casella Filtro non esegue una ricerca completa dei cataloghi, degli schemi, delle tabelle e dei volumi disponibili per il notebook.

Per aprire , posiziona il cursore sul nome dell'oggetto, come mostrato:

Se l'oggetto è una tabella, è possibile eseguire le operazioni seguenti:

• Creare ed eseguire automaticamente una cella per visualizzare un'anteprima dei dati nella tabella. Selezionare Anteprima in una nuova cella dal menu kebab per la tabella.
• Visualizzare un catalogo, uno schema o una tabella in Esplora cataloghi. Seleziona Apri in Catalogo Explorer dal menu kebab. Verrà visualizzata una nuova scheda che mostra l'oggetto selezionato.
• Ottenere il percorso di un catalogo, uno schema o una tabella. Selezionare Copia ... percorso dal menu kebab per l'oggetto.
• Aggiungere una tabella ai Preferiti. Selezionare Aggiungi ai preferiti dal menu kebab per la tabella.

Se l'oggetto è un catalogo, uno schema o un volume, è possibile copiare il percorso dell'oggetto o aprirlo in Esplora cataloghi.

Per inserire direttamente un nome di tabella o di colonna in una cella:

1. Fare clic sul cursore nella cella nella posizione in cui si vuole immettere il nome.
2. Spostare il cursore sul nome della tabella o sulla colonna nel browser dello schema.
3. Fare clic sull'icona a forma di doppia freccia a V che appare a destra del nome dell'oggetto.

Usare il terminale Web e il CLI di Databricks

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

In Databricks Runtime 15.0 e versioni successive è possibile usare l'interfaccia della riga di comando di Databricks dal terminale Web in un notebook. Per informazioni sui requisiti e sull'utilizzo, vedere Eseguire i comandi della shell nel terminale Web di Azure Databricks .

Non è possibile usare la CLI (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.

Completamento automatico personalizzato

Con il completamento automatico i segmenti di codice vengono completati automaticamente durante la digitazione. Gli oggetti completabili includono tipi, classi e oggetti, nonché database SQL, nomi di tabella, struct, mappe, matrici e frammenti di query. Quando si fa riferimento a espressioni di tabella comuni che usano SELECT *, il completamento automatico fornisce raccomandazioni sulle colonne in base alla struttura della tabella sottostante. Databricks usa i metadati e l'utilizzo del catalogo Unity per personalizzare i suggerimenti.

• Per le celle Python, il notebook deve essere collegato a una risorsa di calcolo per il funzionamento del completamento automatico ed è necessario eseguire tutte le celle che definiscono oggetti completi.
• Per le celle SQL, la funzione di completamento automatico suggerisce parole chiave e sintassi di base anche se il notebook non è collegato ad alcuna risorsa di calcolo.
  • Se l'area di lavoro è abilitata per Unity Catalog, il completamento automatico suggerisce anche i nomi di catalogo, schema, tabella e colonna per le tabelle in Unity Catalog.
  • Se l'area di lavoro non è abilitata per Unity Catalog, il notebook deve essere collegato a una risorsa di calcolo di uso generale o a una SQL Warehouse per suggerire nomi di tabella o di colonna.

I suggerimenti di completamento automatico vengono visualizzati automaticamente quando si digita all’interno di una cella. Usare i tasti freccia su e freccia giù o il mouse per selezionare un suggerimento e premere Tab o Invio per inserire la selezione nella cella.

Note

Il completamento automatico del server nei notebook R viene bloccato durante l'esecuzione del comando.

Il completamento automatico è abilitato per impostazione predefinita, ma può essere disabilitato nelle impostazioni utente:

• Per disattivare i suggerimenti di completamento automatico, disattivare Completamento automatico durante la digitazione. Quando il completamento automatico è disattivato, è possibile visualizzare i suggerimenti di completamento automatico premendo CTRL+SPAZIO.
• Per impedire di inserire suggerimenti di completamento automatico con INVIO, attivare o disattivare Invio accetta suggerimenti di completamento automatico.

Corrispondenza parentesi quadre

Quando si fa clic vicino a parentesi quadre o parentesi graffe, l'editor evidenzia il carattere e la parentesi quadra corrispondente.

Evidenziazione degli errori in Python

Le aree di lavoro con funzionalità di intelligenza artificiale basate su partner abilitate possono anche selezionare Correzione con Assistente per i suggerimenti con intelligenza artificiale.

I notebook di Databricks supportano l'evidenziazione degli errori seguente:

• Evidenziazione degli errori di sintassi python: eventuali errori di sintassi nelle celle del codice Python sono evidenziati in rosso. Se possibile, l'Assistente suggerisce una correzione rapida. Questa funzionalità è supportata per infrastrutture di calcolo che eseguono Databricks Runtime 12.1 e versioni successive o per infrastrutture di calcolo serverless. È possibile configurare l'evidenziazione degli errori di sintassi con pyproject.toml i file. Vedere Configurare l'evidenziazione della sintassi Python.
• Evidenziazione degli errori di formato Python: gli errori di formattazione del codice Python e gli avvisi sono sottolineati in giallo o rosso, a seconda della gravità. Ciò consente di identificare i problemi di formattazione, ad esempio il rientro imprevisto, la lunghezza eccessiva della riga e altro ancora. Passare il puntatore del mouse sugli avvisi di sintassi per visualizzare altre informazioni. Questa funzionalità è supportata per infrastrutture di calcolo che eseguono Databricks Runtime 12.1 e versioni successive o per infrastrutture di calcolo serverless.
• Evidenziazione degli errori di tipo Python: il controllo dei tipi può migliorare la qualità del codice, la leggibilità e la gestibilità nei progetti Python e PySpark. I controlli dei tipi possono contrassegnare gli errori correlati a attributi inesistenti, argomenti mancanti e argomenti non corrispondenti nelle chiamate di funzione prima dell'esecuzione del codice. Passare il puntatore del mouse sugli avvisi evidenziati per visualizzare altre informazioni. Questa funzionalità è supportata per il calcolo che esegue Databricks Runtime 16.0 e versioni successive o per l'ambiente serverless 2.

Abilitare l'evidenziazione degli errori Python

Per abilitare o disabilitare l'evidenziazione degli errori, eseguire le operazioni seguenti:

1. Fare clic sul nome utente in alto a destra dell'area di lavoro, quindi fare clic su Impostazioni nell'elenco a discesa.
2. Nella barra laterale Impostazioni selezionare Developer.
3. Attivare o disattivare l'impostazione per l'evidenziazione degli errori di sintassi Python (in Editor del codice), evidenziazione degli errori di formato Python (in Funzionalità sperimentali) e/o evidenziazione degli errori di tipo Python (in Funzionalità sperimentali).

Configurare l'evidenziazione della sintassi Python

Quando un notebook è connesso al calcolo che esegue Databricks Runtime 16.4 o versione successiva o un ambiente serverless versione 3 o successiva, è possibile personalizzare il comportamento dell'evidenziazione della sintassi creando un file pyproject.toml. Per un determinato notebook, verrà usato il file più pyproject.toml vicino nel percorso predecessore diretto nel file system dell'area di lavoro. Se non è possibile trovarne uno nel percorso predecessore, verrà usato un pyproject.toml file nella home folder dell'utente corrente.

Ad esempio, se si dispone di un notebook con il percorso a/b/c/d/notebook.py e sono presenti file in pyproject.toml e a/b/pyproject.toml, verrà usato il secondo perché è più vicino. Un pyproject.toml file in /a/b/c/e/pyproject.toml non verrebbe considerato perché non si trova nel percorso predecessore diretto .

Azure Databricks usa la sintassi standard per i pyproject.toml file. Ad esempio, è possibile fare riferimento alla documentazione di Ruff per vedere come configurare l'linter di Ruff con un pyproject.toml file.

Attualmente, Azure Databricks supporta solo la configurazione di ruff, pylint, pyright e flake8 per linting tramite pyproject.toml.

Per abilitare un linter, il pyproject.toml file deve avere un [tool.<name-of-linter>] blocco.

Per disabilitare in modo esplicito un linter, aggiungere il blocco seguente:

[tool.<name-of-linter>]
disabled=true

È anche possibile disabilitare le regole di evidenziazione della sintassi scritte in Azure Databricks con un blocco, ad esempio:

[tool.databricks]
disabled_rules = ['DB01', 'DB03']

Poiché Flake8 prevede una configurazione in un formato diverso, è necessario passare la configurazione per Flake8 come stringa:

[tool.flake8]
config = """ \
[flake8] \
extend_ignore = E303 \
"""

Personalizzare la formattazione SQL

È possibile personalizzare le impostazioni per la formattazione SQL in un nuovo editor SQL e nell'editor di notebook. Fare clic su Visualizza > impostazioni sviluppatore. Scorrere verso il basso fino a Formato SQL e specificare le impostazioni.

Usare i tasti di scelta rapida

Per visualizzare i tasti di scelta rapida, selezionare Guida > tasti di scelta rapida. I tasti di scelta rapida disponibili dipendono dal fatto che il cursore si trova in una cella di codice (modalità di modifica) o meno (modalità di comando).

Le tabelle seguenti mostrano i tasti di scelta rapida disponibili.

Tasti di scelta rapida per la modalità di modifica

Funzione	Collegamento macOS	Collegamento a Windows
Passare alla modalità di comando	Esc	Esc
Eseguire il comando e inserire una nuova cella di seguito	Option + Enter	Alt + Enter
Inserire una cella sopra	Ctrl + Option + P	Ctrl + Alt + P
Inserire una cella seguente	Ctrl + Option + N	Ctrl + Alt + N
Passare alla cella precedente/successiva	Option + Up/Down	Alt + Up/Down
Dividere una cella in corrispondenza del cursore	Ctrl + Option + -	Ctrl + Alt + -
Elimina riga corrente	⌘ + Shift + K	Ctrl + Shift + K
Elimina cella corrente	Ctrl + Option + D	Ctrl + Alt + D
Spostarsi verso l'alto o verso la cella precedente	Up	Up
Spostarsi verso il basso o verso la cella successiva	Down	Down
Completamento automatico	Ctrl + Space	Ctrl + Space
Completamento automatico assistente automatico	Ctrl + Shift + Space	Ctrl + Shift + Space
Assistente inline	⌘ + I	Ctrl + I
Hint per i parametri	⌘ + Shift + Space	Ctrl + Shift + Space
Docstring	⌘ + (K, I)	Ctrl + (K, I)
Cursori multipli	Option + Click	Alt + Click
Selezionare colonna (casella)	Option + Shift + Drag	Alt + Shift + Drag
Rientro/Annullamento rientro selezione	⌘ + ]/[	Ctrl + ]/[
Annulla digitazione	⌘ + Z	Ctrl + Z
Ripetere la digitazione	⌘ + Shift + Z	Ctrl + Shift + Z
Attiva/disattiva commento riga	⌘ + /	Ctrl + /
Aggiungi commento riga	⌘ + (K, C)	Ctrl + (K, C)
Rimuovi commento riga	⌘ + (K, U)	Ctrl + (K, U)
Modifica a più cursori	⌘ + Option + Up/Down	Ctrl + Option + Up/Down
Aumentare le dimensioni del carattere	Option + +	Alt + +
Ridurre le dimensioni del carattere	Option + -	Alt + -

Tasti di scelta rapida in modalità comando

Funzione	Collegamento a Mac OS	Collegamento a Windows
Passare alla modalità di modifica	Enter	Enter
Annullare l'esecuzione per le celle selezionate	I, I	I, I
Annullare l'esecuzione (ignora richiesta)	Shift + (I, I)	Shift + (I, I)
Elimina cella corrente	D, D	D, D
Elimina cella corrente (ignora richiesta)	Shift + (D, D)	Shift + (D, D)
Vai alla prima cella	G, G	G, G
Vai all'ultima cella	Shift + G	Shift + G
Annullare il taglio/eliminazione di celle	⌘ + Z/Z	Ctrl + Z/Z
Copiare la cella corrente	⌘ + C	Ctrl + C
Taglia cella corrente	⌘ + X	Ctrl + X
Incolla cella	⌘ + V	Ctrl + V
Inserire una cella sopra	A	A
Inserire una cella seguente	B	B
Attivare o disattivare l'output della cella	O	O
Attiva/disattiva titolo cella	T	T
Scorri verso il basso	Space	Space
Scorri verso l'alto	Shift + Space	Shift + Space
Attiva/disattiva menu scelte rapide da tastiera	H	H
Unisci con la cella seguente	Shift + M	Shift + M
Passare alla cella precedente	Up/P/K	Up/P/K
Passare alla cella successiva	Down/N/J	Down/N/J
Aggiungere una cella adiacente alla selezione	Shift + Up/Down	Shift + Up/Down
Selezionare tutte le celle	⌘ + A	Ctrl + A
Selezionare più celle	⌘ + Click	Ctrl + Click
Attiva/disattiva i numeri di riga	L	L
Espandere/Comprimere le intestazioni di cella	Right/Left	Right/Left

Collegamenti condivisi

Funzione	Collegamento macOS	Collegamento a Windows
Attiva/disattiva riquadro comandi	⌘ + Shift + P	Ctrl + Shift + P
Trova	⌘ + F	Ctrl + F
Sostituire	Ctrl + Option + F	Ctrl + Alt + F
Formattare il codice	⌘ + Shift + F	Ctrl + Shift + F
Eseguire il comando e passare alla cella successiva	Shift + Enter	Shift + Enter
Eseguire i comandi selezionati	⌘ + Enter	Ctrl + Enter
Cella di debug	Option + Shift + D	Alt + Shift + D
Debugger: Continua	F7	F7
Debugger: Riga successiva	F8	F8
Debugger: Eseguire l'istruzione in	F9	F9
Debugger: Esci da un'istruzione all'esterno	Shift + F9	Shift + F9
Eseguire tutti i comandi	Option + Shift + Enter	Alt + Shift + Enter
Eseguire tutti i comandi precedenti (esclusivi)	Option + Shift + Up	Alt + Shift + Up
Eseguire tutti i comandi seguenti (inclusi)	Option + Shift + Down	Alt + Shift + Down
Cancellare lo stato e gli output	0, 0	0, 0
Eseguire il testo selezionato o l'istruzione attiva	Ctrl + Shift + Enter	Ctrl + Shift + Enter
Eseguire un'istruzione SQL attiva	⌘ + Shift + Enter	Ctrl + Shift + Enter
Spostare una cella verso l'alto	Ctrl + Option + Up	Ctrl + Alt + Up
Spostare una cella verso il basso	Ctrl + Option + Down	Ctrl + Alt + Down
Attiva/aggiungi commento nel pannello dei commenti	Ctrl + Option + M	Ctrl + Alt + M
Attiva/Disattiva pannello dell'area di lavoro	Ctrl + Option + E	Ctrl + Alt + E
Attiva/disattiva pannello catalogo	Ctrl + Option + C	Ctrl + Alt + C
Attiva/Disattiva pannello assistente	Ctrl + Option + A	Ctrl + Alt + A
Attiva/disattiva la modalità dello stato attivo	Ctrl + Option + O	Ctrl + Alt + O
Chiudere la scheda corrente.	Ctrl + Option + W	Ctrl + Alt + W
Crea nuova scheda	Ctrl + Option + T	Ctrl + Alt + T
Passare alla scheda a sinistra	Ctrl + Option + Left	Ctrl + Alt + Left
Passare alla scheda a destra	Ctrl + Option + Right	Ctrl + Alt + Right
Chiudere tutte le schede	Ctrl + Option + Shift + A	Ctrl + Alt + Shift + A