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.

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).

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.

Trovare e sostituire il testo

Per trovare e sostituire il testo all'interno di un notebook, selezionare Modifica > Trova e sostituisci. Il risultato corrente è evidenziato in arancione mentre tutti gli altri risultati sono evidenziati in giallo.

Per sostituire la corrispondenza attuale, clicca su Sostituisci. Per sostituire tutte le corrispondenze nel notebook, fare clic su Sostituisci tutto.

Per spostarsi tra le corrispondenze, fare clic sui pulsanti Precedente e Avanti. È anche possibile premere MAIUSC+INVIO e INVIO per passare rispettivamente alle corrispondenze precedenti e successive.

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

Ispezione della 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 multicursore

È 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. Quindi:

• 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. Successivamente:
  • 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.

Sfoglia 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 e frammenti di query. 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.

Nota

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

È necessario prestare attenzione a due 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 di parentesi

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 Assistente Databricks abilitato possono anche selezionare Correzione con Assistente per suggerimenti assistiti dall'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.