Usare il notebook e l'editor di file di Databricks

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

È possibile scegliere tra una selezione di temi dell'editor. Selezionare Visualizza > tema editor ed effettuare una selezione dal menu.

Completamento automatico

Il completamento automatico completa automaticamente i segmenti di codice durante la digitazione. Gli oggetti completabili includono tipi, classi e oggetti, nonché nomi di database SQL e tabelle.

• Per le celle Python, il notebook deve essere collegato a un cluster per il funzionamento del completamento automatico ed è necessario eseguire tutte le celle che definiscono oggetti completi.
• Per le celle SQL, il 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, il 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 sql warehouse per suggerire nomi di tabella o di colonna.

I suggerimenti di completamento automatico vengono visualizzati automaticamente in 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.

Nota

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

Esistono due impostazioni utente da tenere presenti:

• 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 a Invio di inserire suggerimenti di completamento automatico, attivare o disattivare Invio accetta suggerimenti di completamento automatico.

Ispezione variabile

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

Vai alla definizione

In Databricks Runtime 12.2 LTS e versioni successive, quando un notebook Python è collegato a un cluster, è possibile passare automaticamente alla definizione di una variabile o di una funzione definita in tale notebook. A tale scopo, tenere premuto il tasto Cmd in macOS o CTRL in Windows e posizionare il cursore sul nome della variabile o della funzione. Il nome si trasforma in un collegamento ipertestuale e cambia il testo blu sottolineato se viene trovata la definizione. Quando si fa clic sul collegamento, il cursore passa al codice che definisce la variabile o la funzione.

È anche possibile usare i tasti di scelta rapida Cmd+F12 in macOS o CTRL+F12 in Windows.

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 (che punta a destra) per visualizzare il codice.

Per altri dettagli, inclusi i tasti di scelta rapida, vedere 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 Option tasto e fare clic in ogni posizione per aggiungere un cursore.
• In Windows tenere premuto il Alt tasto e fare clic in ogni posizione per aggiungere un cursore.
• È anche possibile modificare il collegamento. Vedere Modifica collegamento 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 colonna (casella)

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.
• È anche possibile modificare il collegamento. Vedere Modifica collegamento per la selezione di piùcursori e colonne.

Modificare il collegamento per la selezione di piùcursori e colonne

È disponibile un collegamento alternativo per la selezione di piùcursori e colonne (casella). Con la selezione alternativa, i collegamenti cambiano nel modo seguente:

• Per creare più cursori in una cella:
  • In macOS tenere premuto il Cmd tasto e fare clic in ogni posizione per aggiungere un cursore.
  • In Windows tenere premuto il Ctrl tasto 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. Poi:
  • 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 alternativi, 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 Sviluppatore.
3. Nella sezione Editor di codice modificare il modificatore di tasti per il clic su più cursori su Cmd per macOS o CTRL per Windows.

Quando si abilitano tasti di scelta rapida 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 side-by-side nella cronologia delle versioni

Quando si visualizzano versioni precedenti del notebook, nell'editor vengono visualizzati i diffi side-by-side con evidenziazione dei colori.

Evidenziazione degli errori di sintassi

Quando un notebook è connesso a un cluster, gli errori di sintassi vengono evidenziati da una linea rossa ondulata. Per Python, il cluster deve eseguire Databricks Runtime 12.2 LTS o versione successiva.

Per abilitare o disabilitare l'evidenziazione degli errori di sintassi, 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 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.

Possibili azioni sugli errori e gli avvisi della sintassi

Quando viene visualizzato un errore di sintassi, è possibile passare il puntatore del mouse su di esso e selezionare Correzione rapida per le possibili azioni.

Nota

Questa funzionalità usa Databricks Assistant. Se non vengono visualizzate azioni, significa che l'amministratore deve prima abilitare Databricks Assistant.