Format khusus pernyataan SQL

Penting

Fitur ini ada di Pratinjau Publik.

Artikel ini menjelaskan cara mengkustomisasi opsi pemformatan otomatis SQL di antarmuka pengguna Azure Databricks.

Gambaran Umum

Pemformatan SQL meningkatkan keterbacaan dan pemeliharaan kueri Anda. Dengan menstandarkan indentasi, casing kata kunci, dan preferensi gaya lainnya, kueri yang diformat dengan baik lebih mudah dipahami, di-debug, dan dibagikan dengan tim Anda.

Di Azure Databricks, Anda dapat mengonfigurasi opsi pemformatan menggunakan file yang .dbsql-formatter-config.json disimpan di direktori beranda ruang kerja Anda. Setelah menyimpan file, kode SQL Anda secara otomatis diformat berdasarkan preferensi Anda saat Anda menjalankan atau memformat kode di editor atau buku catatan SQL.

Cara mengonfigurasi pengaturan pemformatan SQL

Untuk mengonfigurasi opsi pemformatan SQL pribadi Anda:

1. Klik Ruang Kerja di bilah samping.
2. Klik Buat > File.
3. Beri nama file .dbsql-formatter-config.json.
4. Tambahkan pengaturan yang Anda inginkan sebagai pasangan kunci-nilai dalam format JSON. Lihat Opsi pemformat
5. Untuk menerapkan pengaturan pemformatan terbaru, refresh halaman.

Contoh file konfigurasi

Contoh berikut menunjukkan konfigurasi yang valid .dbsql-formatter-config.json .

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

Opsi pemformat

Tabel berikut mencantumkan opsi konfigurasi yang didukung.

Opsi	Nama file konfigurasi	Nilai yang diizinkan	Bawaan	Deskripsi
Lebar cetak	printWidth	Bilangan bulat >apa pun = 0	100	Mengatur lebar garis target untuk kode yang diformat.
Gaya indentasi	indentationStyle	'spaces', 'tabs'	'spaces'	Menentukan apakah akan menggunakan spasi atau tab untuk indentasi. Jika diatur, indentationWidth diabaikan.
Lebar indentasi	indentationWidth	Bilangan bulat dari 0 hingga 99	2	Jumlah spasi yang digunakan saat indentationStyle diatur ke 'spaces'.
Casing kata kunci	keywordCasing	'uppercase' 'lowercase' 'none'	'none'	Mengontrol pemformatan kata kunci SQL. 'none' membiarkan casing tidak berubah.
Casing nama fungsi	functionNameCasing	'uppercase' 'lowercase' 'none'	'none'	Mengontrol pemformatan nama fungsi SQL. 'none' membiarkan casing tidak berubah.
Penempatan koma	commaPosition	'beginning', 'end'	'end'	Mengatur penempatan koma dalam daftar.
Pemisah baris antar pernyataan	numNewLinesBetweenStatements	Bilangan bulat dari 0 hingga 99	1	Jumlah baris baru yang disisipkan di antara pernyataan.
Pemisah baris di antara klausa	numNewLinesBetweenClauses	Bilangan bulat dari 0 hingga 99	0	Jumlah baris baru yang disisipkan di antara klausa dalam pernyataan.
Mengembangkan ekspresi boolean	shouldExpandExpressions	true, false	true	Memperluas ekspresi boolean ke baris terpisah.
Memperluas pernyataan CASE	shouldExpandCaseStatements	true, false	true	Memperluas setiap klausa dalam pernyataan CASE ke baris tersendiri.
Perluas daftar IN	shouldExpandInStatements	true, false	false	Memperluas item dalam daftar IN ke baris terpisah.
Perluas kondisi BETWEEN	shouldExpandBetweenConditions	true, false	false	Memperluas kondisi BETWEEN ke baris terpisah.
Kondisi istirahat JOIN	shouldBreakOnJoinSections	true, false	true	JOIN Memecah kondisi ke baris terpisah.