Özel biçimli SQL ifadeleri

Önemli

Bu özellik Genel Önizlemededir. Önizlemeler sayfasında önizleme kaydını onaylayabilirsiniz. Bkz. Azure Databricks önizlemelerini yönetme.

Bu makalede, Azure Databricks kullanıcı arabiriminde SQL otomatik biçimlendirme seçeneklerini özelleştirme açıklanmaktadır.

Genel Bakış

SQL biçimlendirmesi, sorgularınızın okunabilirliğini ve sürdürülebilirliğini artırır. Girintiyi, anahtar sözcük büyük/küçük harflerini ve diğer stil tercihlerini standartlaştırarak, iyi biçimlendirilmiş bir sorguyu anlamak, hatalarını ayıklamak ve ekibinizle paylaşmak daha kolaydır.

Azure Databricks'te, çalışma alanı giriş dizininize kaydedilmiş bir .dbsql-formatter-config.json dosyayı kullanarak biçimlendirme seçeneklerini yapılandırabilirsiniz. Dosyayı kaydettikten sonra, düzenleyicide veya SQL not defterinde kod çalıştırdığınızda veya biçimlendirdiğinizde SQL kodunuz tercihlerinize göre otomatik olarak biçimlendirilir.

SQL biçimlendirme ayarlarını yapılandırma

Kişisel SQL biçimlendirme seçeneklerinizi yapılandırmak için:

1. Kenar çubuğunda 'ne Çalışma Alanı tıklayın.
2. Dosya Oluştur'a >tıklayın.
3. dosyayı .dbsql-formatter-config.jsonolarak adlandırın.
4. İstediğiniz ayarları JSON biçiminde anahtar-değer çiftleri olarak ekleyin. Bkz . Biçimlendirici seçenekleri
5. En son biçimlendirme ayarlarını uygulamak için sayfayı yenileyin.

Örnek yapılandırma dosyası

Aşağıdaki örnekte geçerli .dbsql-formatter-config.json bir yapılandırma gösterilmektedir.

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

Biçimlendirici seçenekleri

Aşağıdaki tabloda desteklenen yapılandırma seçenekleri listelenmektedir.

Seçenek	Yapılandırma dosyası adı	İzin verilen değerler	Varsayılan	Açıklama
Yazdırma genişliği	printWidth	Herhangi bir tamsayı >= 0	100	Biçimlendirilmiş kod için hedef satır genişliğini ayarlar.
Girinti stili	indentationStyle	'spaces', 'tabs'	'spaces'	Girintileme için boşlukların mı yoksa sekmelerin mi kullanılacağını belirtir. Ayarlandıysa indentationWidth yoksayılır.
Girinti genişliği	indentationWidth	0 ile 99 tamsayısı	2	indentationStyle olarak ayarlandığında kullanılan 'spaces' boşluk sayısı.
Anahtar kelime harf durumu	keywordCasing	'uppercase', 'lowercase', 'none'	'none'	SQL anahtar sözcüklerinin biçimlendirmesini denetler. 'none' kasayı değişmeden bırakır.
İşlev adı harf biçimi	functionNameCasing	'uppercase', 'lowercase', 'none'	'none'	SQL işlev adlarının biçimlendirmesini denetler. 'none' kasayı değişmeden bırakır.
Virgülle yerleştirme	commaPosition	'beginning', 'end'	'end'	Virgüllerin listelere yerleştirildiği yerleri denetler.
İfadeler arasındaki satır sonları	numNewLinesBetweenStatements	0 ile 99 tamsayısı	1	Deyimler arasına eklenen yeni satır sayısı.
Cümleler arasına satır araları	numNewLinesBetweenClauses	0 ile 99 tamsayısı	0	Deyim içindeki yan tümceler arasına eklenen yeni satır sayısı.
Boole ifadelerini genişletme	shouldExpandExpressions	true, false	true	Boole ifadelerini ayrı satırlara genişletir.
CASE deyimlerini genişlet	shouldExpandCaseStatements	true, false	true	CASE deyimindeki her koşulu ayrı bir satıra taşır.
IN listelerini genişletme	shouldExpandInStatements	true, false	false	IN listelerindeki öğeleri ayrı satırlara genişletir.
BETWEEN koşulları genişlet	shouldExpandBetweenConditions	true, false	false	BETWEEN koşullarını ayrı satırlara genişletir.
Koşulları bozma JOIN	shouldBreakOnJoinSections	true, false	true	Koşulları JOIN ayrı satırlara ayırır.