SQL-uttryck i anpassat format

Viktigt!

Den här funktionen finns som allmänt tillgänglig förhandsversion.

Den här artikeln beskriver hur du anpassar alternativ för automatisk SQL-formatering i Azure Databricks-användargränssnittet.

Översikt

SQL-formatering förbättrar läsbarheten och underhållsbarheten för dina frågor. Genom att standardisera indrag, nyckelordshölje och andra stilistiska inställningar är en välformaterad fråga lättare att förstå, felsöka och dela med ditt team.

I Azure Databricks-miljön kan du konfigurera formateringsalternativ med hjälp av en .dbsql-formatter-config.json-fil som sparats i arbetsytans katalog. När du har sparat filen formateras SQL-koden automatiskt baserat på dina inställningar när du kör eller formaterar kod i redigeraren eller en SQL-notebook-fil.

Så här konfigurerar du SQL-formateringsinställningar

Så här konfigurerar du dina personliga SQL-formateringsalternativ:

1. Klicka på Arbetsyta i sidofältet.
2. Klicka på Skapa > fil.
3. Ge filen namnet .dbsql-formatter-config.json.
4. Lägg till önskade inställningar som nyckel/värde-par i JSON-format. Se Formateringsalternativ
5. Uppdatera sidan om du vill använda de senaste formateringsinställningarna.

Exempel på konfigurationsfil

I följande exempel visas en giltig .dbsql-formatter-config.json konfiguration.

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

Formateringsalternativ

I följande tabell visas de konfigurationsalternativ som stöds.

Alternativ	Namn på konfigurationsfil	Tillåtna värden	Standardinställning	Beskrivning
Utskriftsbredd	printWidth	Alla heltal >= 0	100	Anger målradens bredd för formaterad kod.
Indragsstil	indentationStyle	'spaces', 'tabs'	'spaces'	Anger huruvida blanksteg eller flikar ska användas för att skapa indrag. Om inställningen är inställd indentationWidth ignoreras.
Indragsbredd	indentationWidth	Heltal från 0 till 99	2	Antal blanksteg som används när indentationStyle är inställt på 'spaces'.
Nyckelordshölje	keywordCasing	'uppercase', 'lowercase''none'	'none'	Styr formatering av SQL-nyckelord. 'none' lämnar höljet oförändrat.
Hölje för funktionsnamn	functionNameCasing	'uppercase', 'lowercase''none'	'none'	Styr formatering av SQL-funktionsnamn. 'none' lämnar höljet oförändrat.
Kommaplacering	commaPosition	'beginning', 'end'	'end'	Kontrollerar var kommatecken placeras i listor.
Radbrytningar mellan uttryck	numNewLinesBetweenStatements	Heltal från 0 till 99	1	Antal nya rader som infogats mellan uttryck.
Radbrytningar mellan satser	numNewLinesBetweenClauses	Heltal från 0 till 99	0	Antal nya rader som infogats mellan satser i ett uttryck.
Expandera booleska uttryck	shouldExpandExpressions	true, false	true	Expanderar booleska uttryck till separata rader.
Expandera CASE-instruktioner	shouldExpandCaseStatements	true, false	true	Expanderar varje villkor i en CASE-sats till sin egen rad.
Expandera IN-listor	shouldExpandInStatements	true, false	false	Expanderar objekt i IN-listor till separata rader.
Expandera BETWEEN-villkor	shouldExpandBetweenConditions	true, false	false	Expanderar BETWEEN-villkor till separata linjer.
Avbrottsvillkor JOIN	shouldBreakOnJoinSections	true, false	true	Delar JOIN upp villkor på separata linjer.