Freigeben über

SQL-Anweisungen im benutzerdefinierten Format

Wichtig

Dieses Feature befindet sich in der Public Preview.

In diesem Artikel wird erläutert, wie Sie die Optionen für die automatische SQL-Formatierung in der Azure Databricks-Benutzeroberfläche anpassen.

Überblick

Die SQL-Formatierung verbessert die Lesbarkeit und Wartung Ihrer Abfragen. Durch die Standardisierung des Einzugs, der Groß-/Kleinschreibung von Schlüsselwörtern und anderer stilistischer Präferenzen ist eine gut formatierte Abfrage einfacher zu verstehen, zu debuggen und für Ihr Team freizugeben.

In Azure Databricks können Sie Formatierungsoptionen mithilfe einer .dbsql-formatter-config.json Datei konfigurieren, die in Ihrem Arbeitsbereichs-Startverzeichnis gespeichert ist. Nach dem Speichern der Datei wird Ihr SQL-Code automatisch basierend auf Ihren Einstellungen formatiert, wenn Sie Code im Editor oder einem SQL-Notizbuch ausführen oder formatieren.

Konfigurieren von SQL-Formatierungseinstellungen

So konfigurieren Sie Ihre persönlichen SQL-Formatierungsoptionen:

  1. Klicken Sie in der Randleiste auf Symbol „Arbeitsbereich“Arbeitsbereich.
  2. Klicken Sie auf "Datei erstellen>".
  3. Nennen Sie die Datei .dbsql-formatter-config.json.
  4. Fügen Sie Ihre gewünschten Einstellungen als Schlüsselwertpaare im JSON-Format hinzu. Weitere Informationen finden Sie unter "Formatieroptionen"
  5. Aktualisieren Sie die Seite, um die neuesten Formatierungseinstellungen anzuwenden.

Beispielkonfigurationsdatei

Das folgende Beispiel zeigt eine gültige .dbsql-formatter-config.json Konfiguration.

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

Formatieroptionen

In der folgenden Tabelle sind die unterstützten Konfigurationsoptionen aufgeführt.

Option Konfigurationsdateiname Zulässige Werte Standard BESCHREIBUNG
Druckbreite printWidth Eine ganze Zahl >= 0 100 Legt die Breite der Zielzeile für formatierten Code fest.
Einzugsstil indentationStyle 'spaces', 'tabs' 'spaces' Gibt an, ob Leerzeichen oder Tabulatorzeichen für den Einzug verwendet werden sollen. Wenn festgelegt, indentationWidth wird ignoriert.
Einzugsbreite indentationWidth Ganze Zahl von 0 bis 99 2 Anzahl der Leerzeichen, die verwendet werden, wenn indentationStyle auf 'spaces' gesetzt ist.
Groß-/Kleinschreibung von Schlüsselwörtern keywordCasing 'uppercase', 'lowercase''none' 'none' Steuert die Formatierung von SQL-Schlüsselwörtern. 'none' lässt die Groß-/Kleinschreibung unverändert.
Groß-/Kleinschreibung von Funktionsnamen functionNameCasing 'uppercase', 'lowercase''none' 'none' Steuert die Formatierung von SQL-Funktionsnamen. 'none' lässt die Groß-/Kleinschreibung unverändert.
Kommasetzung commaPosition 'beginning', 'end' 'end' Steuerelemente, in denen Kommas in Listen platziert werden.
Zeilenumbrüche zwischen Anweisungen numNewLinesBetweenStatements Ganze Zahl von 0 bis 99 1 Anzahl der neuen Zeilen, die zwischen Anweisungen eingefügt wurden.
Zeilenumbrüche zwischen Klauseln numNewLinesBetweenClauses Ganze Zahl von 0 bis 99 0 Anzahl der neuen Zeilen, die zwischen Klauseln innerhalb einer Anweisung eingefügt wurden.
Erweitern boolescher Ausdrücke shouldExpandExpressions true, false true Erweitert boolesche Ausdrücke auf separate Zeilen.
CASE-Anweisungen erweitern shouldExpandCaseStatements true, false true Erweitert jede Klausel in einer CASE-Anweisung auf eine eigene Zeile.
Erweitern von IN-Listen shouldExpandInStatements true, false false Erweitert Elemente in IN-Listen auf separate Zeilen.
Erweitern von BETWEEN-Bedingungen shouldExpandBetweenConditions true, false false Erweitert BETWEEN-Bedingungen auf separate Zeilen.
Unterbrechungsbedingungen JOIN shouldBreakOnJoinSections true, false true Teilt JOIN-Bedingungen auf separate Zeilen auf.
  • Last updated on