다음을 통해 공유

사용자 지정 형식 SQL 문

중요합니다

이 기능은 공개 미리보기 단계에 있습니다.

이 문서에서는 Azure Databricks UI에서 SQL 자동 서식 옵션을 사용자 지정하는 방법을 설명합니다.

개요

SQL 서식을 지정하면 쿼리의 가독성 및 유지 관리 효율성이 향상됩니다. 들여쓰기, 키워드 대/소문자 및 기타 스타일 기본 설정을 표준화하면 잘 서식이 지정된 쿼리를 더 쉽게 이해하고, 디버그하고, 팀과 공유할 수 있습니다.

Azure Databricks에서 작업 영역 홈 디렉터리에 저장된 파일을 사용하여 .dbsql-formatter-config.json 서식 옵션을 구성할 수 있습니다. 파일을 저장한 후 편집기 또는 SQL Notebook에서 코드를 실행하거나 서식을 지정할 때 기본 설정에 따라 SQL 코드의 서식이 자동으로 지정됩니다.

SQL 서식 설정을 구성하는 방법

개인 SQL 서식 옵션을 구성하려면 다음을 수행합니다.

  1. 사이드바에서 작업 영역 아이콘작업 영역을 클릭합니다.
  2. 파일 만들기>를 클릭합니다.
  3. 파일 이름을 .dbsql-formatter-config.json로 지정합니다.
  4. 원하는 설정을 JSON 형식의 키-값 쌍으로 추가합니다. 포맷터 옵션 참조
  5. 최신 서식 설정을 적용하려면 페이지를 새로 고칩니다.

예제 구성 파일

다음 예제에서는 유효한 .dbsql-formatter-config.json 구성을 보여줍니다.

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

포맷터 옵션

다음 표에서는 지원되는 구성 옵션을 나열합니다.

옵션 구성 파일 이름 허용되는 값 기본값 설명
인쇄 너비 printWidth 정수 >= 0 100 서식이 지정된 코드의 대상 선 너비를 설정합니다.
들여쓰기 스타일 indentationStyle 'spaces', 'tabs' 'spaces' 들여쓰기를 위해 공백 또는 탭을 사용할지 여부를 지정합니다. 설정된 indentationWidth 경우 무시됩니다.
들여쓰기 너비 indentationWidth 0에서 99까지의 정수 2 indentationStyle가 'spaces'에 설정될 때 사용되는 공백 수입니다.
키워드 대소문자 keywordCasing 'uppercase', 'lowercase', 'none' 'none' SQL 키워드의 서식을 제어합니다. 'none'는 대소문자를 변경하지 않습니다.
함수 이름의 대소문자 구분 functionNameCasing 'uppercase', 'lowercase', 'none' 'none' SQL 함수 이름의 서식을 제어합니다. 'none'는 대소문자를 그대로 유지합니다.
쉼표 배치 commaPosition 'beginning', 'end' 'end' 목록에 쉼표가 배치되는 컨트롤입니다.
문장 사이 줄 바꿈 numNewLinesBetweenStatements 0에서 99까지의 정수 1 문장 사이에 삽입된 새 줄 수입니다.
절 간의 줄 바꿈 numNewLinesBetweenClauses 0에서 99까지의 정수 0 문장 내의 절 사이에 삽입된 새 줄 수입니다.
부울 식 확장 shouldExpandExpressions true, false true 논리식을 별도의 줄로 확장합니다.
CASE 문 확장 shouldExpandCaseStatements true, false true CASE 문의 각 절을 자체 줄로 확장합니다.
IN 목록 확장 shouldExpandInStatements true, false false IN 목록의 항목을 별도의 줄로 확장합니다.
BETWEEN 조건을 확장 shouldExpandBetweenConditions true, false false BETWEEN 조건을 별도의 줄로 확장합니다.
중단 JOIN 조건 shouldBreakOnJoinSections true, false true 조건을 별도의 선으로 분리 JOIN 합니다.