Istruzioni SQL in formato personalizzato

Importante

Questa funzionalità è in Anteprima Pubblica.

Questo articolo illustra come personalizzare le opzioni di formattazione automatica di SQL nell'interfaccia utente di Azure Databricks.

Informazioni generali

La formattazione SQL migliora la leggibilità e la gestibilità delle query. Standardizzando il rientro, la combinazione di maiuscole e minuscole di parole chiave e altre preferenze stilistiche, una query ben formattata è più facile da comprendere, eseguire il debug e condividere con il team.

In Azure Databricks è possibile configurare le opzioni di formattazione usando un .dbsql-formatter-config.json file salvato nella home directory dell'area di lavoro. Dopo aver salvato il file, il codice SQL viene formattato automaticamente in base alle preferenze quando si esegue o formatta il codice nell'editor o in un notebook SQL.

Come configurare le impostazioni di formattazione SQL

Per configurare le opzioni di formattazione SQL personali:

1. Fare clic su Area di lavoro nella barra laterale.
2. Fare clic su Crea > file.
3. Denominare il file .dbsql-formatter-config.json.
4. Aggiungere le impostazioni desiderate come coppie chiave-valore in formato JSON. Vedere Opzioni formattatore
5. Per applicare le impostazioni di formattazione più recenti, aggiornare la pagina.

File di configurazione di esempio

Nell'esempio seguente viene illustrata una configurazione valida .dbsql-formatter-config.json .

{
  "printWidth": 80,
  "indentationStyle": "spaces",
  "indentationWidth": 4,
  "keywordCasing": "uppercase",
  "shouldExpandExpressions": true
}

Opzioni del formattatore

Nella tabella seguente sono elencate le opzioni di configurazione supportate.

Opzione	Nome file di configurazione	Valori consentiti	Valore predefinito	Descrizione
Larghezza stampa	printWidth	Qualsiasi numero intero >= 0	100	Imposta la larghezza della riga di destinazione per il codice formattato.
Stile di rientro	indentationStyle	'spaces', 'tabs'	'spaces'	Specifica se utilizzare spazi o tab per il rientro. Se impostato, indentationWidth viene ignorato.
Larghezza rientro	indentationWidth	Intero compreso tra 0 e 99	2	Numero di spazi usati quando indentationStyle è impostato su 'spaces'.
Formattazione delle parole chiave	keywordCasing	'uppercase', 'lowercase', 'none'	'none'	Controlla la formattazione delle parole chiave SQL. 'none' lascia inalterata la formattazione delle lettere.
Casi di maiuscole e minuscole per il nome della funzione	functionNameCasing	'uppercase', 'lowercase', 'none'	'none'	Controlla la formattazione dei nomi delle funzioni SQL. 'none' mantiene inalterata la differenziazione tra maiuscole e minuscole.
Posizionamento di virgole	commaPosition	'beginning', 'end'	'end'	Controlla la posizione delle virgole negli elenchi.
Interruzioni di riga tra istruzioni	numNewLinesBetweenStatements	Intero compreso tra 0 e 99	1	Numero di nuove righe inserite tra istruzioni.
Interruzioni di riga tra clausole	numNewLinesBetweenClauses	Intero compreso tra 0 e 99	0	Numero di righe nuove inserite tra clausole all'interno di un'istruzione.
Espandere espressioni booleane	shouldExpandExpressions	true, false	true	Espande le espressioni booleane in righe separate.
Espandere le istruzioni CASE	shouldExpandCaseStatements	true, false	true	Espande ogni clausola di un'istruzione CASE su una riga propria.
Espandi elenchi IN	shouldExpandInStatements	true, false	false	Espande gli elementi negli elenchi IN in righe separate.
Espandere le condizioni BETWEEN	shouldExpandBetweenConditions	true, false	false	Espande le condizioni BETWEEN in righe separate.
Condizioni di interruzione JOIN	shouldBreakOnJoinSections	true, false	true	Spezza JOIN le condizioni su righe separate.