Utilizzare il notebook e l'editor di file di Databricks

Questa pagina descrive alcune funzioni disponibili con il notebook e l'editor di file di Databricks, tra cui i suggerimenti di codice e il completamento automatico, l'ispezione delle variabili, la riduzione del codice e le differenze affiancate. 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, si veda Usare Databricks Assistant.

Si può scegliere tra una selezione di temi dell'editor. Selezionare Visualizza tema> dell’editor ed effettuare una selezione dal menu.

Completamento automatico personalizzato

Con il completamento automatico i segmenti di codice vengono completati automaticamente durante la digitazione. Tra gli oggetti completabili figurano tipi, classi e oggetti, nonché nomi di database SQL e tabelle. Databricks usa i metadati e l'utilizzo del catalogo Unity per personalizzare i suggerimenti.

• Per le celle Python, affinché il completamento automatico funzioni, il notebook deve essere collegato a un cluster e si devono eseguire tutte le celle che definiscono oggetti completabili.
• 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 Il catalogo Unity, la funzione di completamento automatico suggerisce anche i nomi di catalogo, schema, tabella e colonna per le tabelle nel catalogo unity.
  • Se l'area di lavoro non è abilitata per Il catalogo Unity, il notebook deve essere collegato a un cluster o a un warehouse SQL 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 giù o il mouse per selezionare un suggerimento e premere TAB o INVIO per inserire la selezione nella cella.

È necessario prestare attenzione a due impostazioni utente:

• Per disattivare il completamento automatico dei suggerimenti, attivare o disattivare il 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.

Esaminare una 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.

Si veda Esplora variabili

Andare a Definizione

Quando un notebook Python è collegato a un cluster, è possibile andare rapidamente alla definizione di una variabile, di una funzione o del codice sottostante a 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 nei 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. Si veda Modifica collegamento rapido per la selezione di più cursori e colonne.

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

Selezione a colonna (riquadro)

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. Si veda Modifica collegamento rapido per la selezione di più cursori e colonne.

Modifica collegamento rapido per la selezione di più cursori e colonne

È disponibile un collegamento rapido alternativo per la selezione di più cursori e colonne (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 nell'area di lavoro, poi fare clic su Impostazioni nell'elenco a discesa.
2. Nella barra laterale Impostazioni selezionare Sviluppatore.
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.

Corrispondenza tra parentesi graffe

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

Differenze affiancate nella cronologia delle versioni

Quando si visualizzano versioni precedenti del notebook, nell'editor vengono visualizzate le differenze affiancate con evidenziazione dei colori.

Evidenziazione degli errori in Python

Quando un notebook è connesso a un cluster, gli errori di sintassi vengono sottolineati in rosso. Per Python, il cluster deve eseguire Databricks Runtime 12.2 LTS o versione successiva.

Passare il puntatore del mouse sull'avviso di sintassi e selezionare Correzione rapida per le possibili azioni.

Le aree di lavoro con Databricks Assistant abilitato possono anche selezionare Correzione con Assistente per i suggerimenti con intelligenza artificiale.

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

1. Fare clic sul nome utente in alto a destra nell'area di lavoro, poi fare clic su Impostazioni nell'elenco a discesa.
2. Nella barra laterale Impostazioni selezionare Sviluppatore.
3. Nella sezione Editor di codice attivare o disattivare l'impostazione per l'evidenziazione degli errori di sintassi SQL o l'evidenziazione degli errori di sintassi Python.

Evidenziazione della formattazione in Python

Gli errori di formattazione del codice Python e gli avvisi vengono sottolineati in giallo. Passare il puntatore del mouse sugli avvisi di sintassi per visualizzare altre informazioni. Il cluster deve eseguire Databricks Runtime 12.1 LTS o versione successiva.

Per abilitare la formattazione di errori e avvisi:

1. Fare clic sul nome utente in alto a destra nell'area di lavoro, poi fare clic su Impostazioni nell'elenco a discesa.
2. Nella barra laterale Impostazioni selezionare Sviluppatore.
3. Nella sezione Funzionalità sperimentali attivare o disattivare l'impostazione per l'evidenziazione degli errori di formato Python