Příkazy SQL vlastního formátu

Důležité

Tato funkce je ve verzi Public Preview.

Tento článek vysvětluje, jak přizpůsobit možnosti automatického formátování SQL v uživatelském rozhraní Azure Databricks.

Přehled

Formátování SQL zlepšuje čitelnost a udržovatelnost vašich dotazů. Díky standardizaci odsazení, velikosti písmen klíčových slov a dalších stylistických předvoleb je dobře formátovaný dotaz snazší na porozumění, ladění a sdílení s vaším týmem.

V Azure Databricks můžete nakonfigurovat možnosti formátování pomocí souboru uloženého v domovském .dbsql-formatter-config.json adresáři pracovního prostoru. Po uložení souboru se kód SQL automaticky naformátuje na základě vašich předvoleb při spuštění nebo formátování kódu v editoru nebo poznámkovém bloku SQL.

Konfigurace nastavení formátování SQL

Konfigurace osobních možností formátování SQL:

1. Na bočním panelu klikněte na Pracovní prostor.
2. Klikněte na Vytvořit > soubor.
3. Pojmenujte soubor .dbsql-formatter-config.json.
4. Přidejte požadovaná nastavení jako páry klíč-hodnota ve formátu JSON. Viz Možnosti formátovače
5. Pokud chcete použít nejnovější nastavení formátování, aktualizujte stránku.

Příklad konfiguračního souboru

Následující příklad ukazuje platnou .dbsql-formatter-config.json konfiguraci.

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

Možnosti formátovače

Následující tabulka uvádí podporované možnosti konfigurace.

Možnost	Název konfiguračního souboru	Povolené hodnoty	Výchozí	Popis
Šířka tisku	printWidth	Libovolné celé číslo >= 0	100	Nastaví šířku cílové čáry pro formátovaný kód.
Styl odsazení	indentationStyle	'spaces', 'tabs'	'spaces'	Určuje, jestli se mají pro odsazení používat mezery nebo tabulátory. Pokud je nastavená, indentationWidth bude ignorována.
Šířka odsazení	indentationWidth	Celé číslo od 0 do 99	2	Počet mezer použitých, když je indentationStyle nastaveno na 'spaces'.
Použití velkých písmen v klíčových slovech	keywordCasing	'uppercase', 'lowercase''none'	'none'	Řídí formátování klíčových slov SQL. 'none' ponechá pouzdro beze změny.
Velikost písmen v názvu funkce	functionNameCasing	'uppercase', 'lowercase''none'	'none'	Určuje formátování názvů funkcí SQL. 'none' ponechá pouzdro beze změny.
Umístění čárky	commaPosition	'beginning', 'end'	'end'	Řídí, kde jsou v seznamech umístěny čárky.
Zalomení řádků mezi výroky	numNewLinesBetweenStatements	Celé číslo od 0 do 99	1	Počet nových řádků vložených mezi příkazy
Řádkové zlomy mezi klauzulemi	numNewLinesBetweenClauses	Celé číslo od 0 do 99	0	Počet nových řádků vložených mezi klauzule v rámci příkazu
Rozšíření logických výrazů	shouldExpandExpressions	true, false	true	Rozšíří logické výrazy na samostatné řádky.
Rozbalit příkazy CASE	shouldExpandCaseStatements	true, false	true	Umístí každou klauzuli v příkazu CASE na vlastní řádek.
Rozbalit seznamy typu IN	shouldExpandInStatements	true, false	false	Rozbalí položky v seznamech IN na samostatné řádky.
Rozbalení podmínek BETWEEN	shouldExpandBetweenConditions	true, false	false	Rozbalí podmínky BETWEEN na samostatné řádky.
Podmínky přerušení JOIN	shouldBreakOnJoinSections	true, false	true	Rozdělí JOIN podmínky na samostatné řádky.