Delen via


SQL-verklaringen voor aangepaste opmaak

Belangrijk

Deze functie bevindt zich in openbare preview-versie.

In dit artikel wordt uitgelegd hoe u automatische opmaakopties voor SQL kunt aanpassen in de gebruikersinterface van Azure Databricks.

Overzicht

SQL-opmaak verbetert de leesbaarheid en onderhoudbaarheid van uw query's. Door het standaardiseren van inspringing, hoofdlettergebruik van trefwoorden en andere stijlvoorkeuren is een goed opgemaakte query gemakkelijker te begrijpen, te debuggen en te delen met uw team.

In Azure Databricks kunt u opmaakopties configureren met behulp van een .dbsql-formatter-config.json bestand dat is opgeslagen in de basismap van uw werkruimte. Nadat u het bestand hebt opgeslagen, wordt uw SQL-code automatisch opgemaakt op basis van uw voorkeuren wanneer u code uitvoert of formatteert in de editor of een SQL-notebook.

SQL-opmaakinstellingen configureren

Uw persoonlijke SQL-opmaakopties configureren:

  1. Klik op WerkruimtepictogramWerkruimte in de zijbalk.
  2. Klik op Bestand aanmaken>.
  3. Geef het bestand de naam .dbsql-formatter-config.json.
  4. Voeg de gewenste instellingen toe als sleutel-waardeparen in JSON-indeling. Opties voor opmaken weergeven
  5. Als u de meest recente opmaakinstellingen wilt toepassen, vernieuwt u de pagina.

Voorbeeldconfiguratiebestand

In het volgende voorbeeld ziet u een geldige .dbsql-formatter-config.json configuratie.

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

Opties voor opmaken

De volgende tabel bevat de ondersteunde configuratieopties.

Optie Configuratiebestandsnaam Toegestane waarden Verstek Beschrijving
Afdrukbreedte printWidth Een geheel getal >= 0 100 Hiermee stelt u de doellijnbreedte in voor opgemaakte code.
Inspringingsstijl indentationStyle 'spaces', 'tabs' 'spaces' Hiermee specificeert u of er spaties of tabs moeten worden gebruikt voor inspringingen. Als deze optie is ingesteld, indentationWidth wordt deze genegeerd.
Breedte van inspringing indentationWidth Geheel getal van 0 tot 99 2 Het aantal spaties dat wordt gebruikt wanneer indentationStyle is ingesteld op 'spaces'.
Trefwoordbehuizing keywordCasing 'uppercase', 'lowercase', 'none' 'none' Hiermee bepaalt u de opmaak van SQL-trefwoorden. 'none' laat de behuizing in ongewijzigde staat.
Naamgeving van functies op basis van hoofdletters en kleine letters functionNameCasing 'uppercase', 'lowercase', 'none' 'none' Hiermee bepaalt u de opmaak van sql-functienamen. 'none' laat de behuizing ongewijzigd.
Kommaplaatsing commaPosition 'beginning', 'end' 'end' Hiermee bepaalt u waar komma's in lijsten worden geplaatst.
Regeleinden tussen instructies numNewLinesBetweenStatements Geheel getal van 0 tot 99 1 Aantal nieuwe regels ingevoegd tussen instructies.
Regeleinden tussen zinnen numNewLinesBetweenClauses Geheel getal van 0 tot 99 0 Aantal nieuwe regels ingevoegd tussen clausules binnen een verklaring.
Booleaanse expressies uitvouwen shouldExpandExpressions true, false true Breidt Booleaanse expressies uit op afzonderlijke regels.
CASE-instructies uitvouwen shouldExpandCaseStatements true, false true Breidt elke voorwaarde in een CASE-instructie uit op een eigen regel.
IN-lijsten uitvouwen shouldExpandInStatements true, false false Uitbreiden van items in IN-lijsten naar aparte regels.
TUSSEN-voorwaarden uitvouwen shouldExpandBetweenConditions true, false false Hiermee vouwt u TUSSEN-voorwaarden uit op afzonderlijke lijnen.
Onderbrekingsvoorwaarden JOIN shouldBreakOnJoinSections true, false true Breekt de voorwaarden JOIN op in afzonderlijke regels.