Sql-utasítások egyéni formázása

Fontos

Ez a funkció nyilvános előzetes verzióban van.

Ez a cikk bemutatja, hogyan szabhatja testre az SQL automatikus formázási beállításait az Azure Databricks felhasználói felületén.

Áttekintés

Az SQL-formázás javítja a lekérdezések olvashatóságát és karbantarthatóságát. A behúzás, a kulcsszavak nagybetűs használata és más stílusbeállítások szabványosításával a jól formázott lekérdezés könnyebben érthető, hibakereséséhez és a csapattal való megosztáshoz.

Az Azure Databricksben a formázási beállításokat a .dbsql-formatter-config.json munkaterület kezdőkönyvtárában mentett fájl használatával konfigurálhatja. A fájl mentése után a rendszer automatikusan formázza az SQL-kódot a beállítások alapján, amikor a szerkesztőben vagy egy SQL-jegyzetfüzetben futtat vagy formáz kódot.

SQL-formázási beállítások konfigurálása

A személyes SQL-formázási beállítások konfigurálása:

1. Kattintson az oldalsávon a Munkaterület gombra.
2. Kattintson a Fájl létrehozása > gombra.
3. A fájl neve legyen .dbsql-formatter-config.json.
4. Adja hozzá a kívánt beállításokat kulcs-érték párként JSON formátumban. A Formátumter beállításainak megtekintése
5. A legújabb formázási beállítások alkalmazásához frissítse a lapot.

Példa konfigurációs fájl

Az alábbi példa egy érvényes .dbsql-formatter-config.json konfigurációt mutat be.

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

Formázási beállítások

Az alábbi táblázat a támogatott konfigurációs beállításokat sorolja fel.

Lehetőség	Konfigurációs fájlnév	Engedélyezett értékek	Alapértelmezett	Leírás
Nyomtatási szélesség	printWidth	Bármely egész szám >= 0	100	A formázott kód célvonalszélességének beállítása.
Behúzási stílus	indentationStyle	'spaces', 'tabs'	'spaces'	Meghatározza, hogy szóközöket vagy tabulátorokat használjon-e behúzáshoz. Ha be van állítva, indentationWidth a rendszer figyelmen kívül hagyja.
Behúzás szélessége	indentationWidth	Egész szám 0 és 99 között	2	A indentationStyle beállításakor használt 'spaces' szóközök száma.
Kulcsszavak írásmódja	keywordCasing	\, \, \	'none'	Sql-kulcsszavak formázását szabályozza. 'none' változatlanul hagyja a burkolatot.
Függvénynév írásmód	functionNameCasing	\, \, \	'none'	Az SQL-függvénynevek formázását szabályozza. 'none' változatlanul hagyja a burkolatot.
Vessző elhelyezése	commaPosition	'beginning', 'end'	'end'	Azt szabályozza, hogy a vesszők a listákban hol vannak elhelyezve.
Sortörések az utasítások között	numNewLinesBetweenStatements	Egész szám 0 és 99 között	1	Az utasítások között beszúrt új sorok száma.
Sortörések a mondatok között	numNewLinesBetweenClauses	Egész szám 0 és 99 között	0	Az utasításban lévő záradékok között beszúrt új sorok száma.
Logikai kifejezések kibontása	shouldExpandExpressions	true, false	true	A logikai kifejezéseket külön sorokra bontja ki.
CASE utasítások kibontása	shouldExpandCaseStatements	true, false	true	Kibontja a CASE utasítás egyes záradékait a saját sorába.
Az IN felsorolás kibővítése	shouldExpandInStatements	true, false	false	Az IN listák elemeit külön sorokra bontja.
Közötti feltételek kiterjesztése	shouldExpandBetweenConditions	true, false	false	A BETWEEN feltételeket külön sorokra bontja.
Megszakítási JOIN feltételek	shouldBreakOnJoinSections	true, false	true	A feltételeket külön vonalakra bontja JOIN .