적용 대상:
Databricks SQL Databricks Runtime
이 가이드에서는 플랫폼 가용성 레이블 및 구문 표기법을 포함하여 SQL 언어 참조를 읽고 탐색하는 방법을 설명합니다.
"적용 대상" 레이블
SQL 참조는 Databricks SQL, Databricks 런타임 및 Unity 카탈로그를 다룹니다. 각 문서에는 해당 기능을 지원하는 제품 및 버전을 보여 주는 "적용 대상" 레이블이 맨 위에 포함되어 있습니다.
레이블 읽기
| 라벨 | Meaning |
|---|---|
|
예 Databricks 런타임 Databricks SQL 검사 |
Databricks SQL 및 Databricks 런타임의 모든 버전 |
|
Databricks SQL |
Databricks SQL만(Databricks 런타임에서 지원되지 않음) |
|
Databricks SQL Databricks Runtime 11.3 LTS 이상으로 표시 |
모든 버전의 Databricks SQL 및 Databricks Runtime 11.3 LTS 이상 |
|
Databricks SQL Databricks Runtime 11.3 LTS로 표시되고 위의 Unity 카탈로그만 표시 |
Unity 카탈로그만, 모든 버전의 Databricks SQL 및 Databricks Runtime 11.3 LTS 이상 |
매개 변수 수준 레이블
일부 문서에는 맨 위에 "적용 대상" 레이블이 있고 문서 내의 특정 매개 변수에 대한 추가 레이블이 있습니다. 매개 변수 수준 레이블은 해당 매개 변수에 대해서만 아티클 수준 레이블을 재정의합니다.
예제 1: 매개 변수에 최소 Databricks 런타임 버전이 필요합니다.
아티클 레이블: yes Databricks SQL 표시가 yes Databricks 런타임
매개 변수 레이블: yes Databricks SQL Databricks Runtime 11.3 LTS 이상으로 합니다.
즉, 대부분의 문서는 Databricks SQL 및 Databricks Runtime의 모든 버전에 적용되지만 특정 매개 변수에는 Databricks Runtime 11.3 LTS 이상이 필요합니다.
예제 2: SQL 웨어하우스 워크로드에 매개 변수를 사용할 수 없음
아티클 레이블: yes Databricks SQL 표시가 yes Databricks 런타임
매개 변수 레이블: yes Databricks Runtime 11.3 LTS 이상으로
즉, 대부분의 페이지는 두 제품의 모든 버전에 적용되지만 해당 특정 매개 변수는 Databricks Runtime 11.3 LTS 이상에서만 지원됩니다(Databricks SQL에서는 지원되지 않음).
구문 다이어그램
SQL 문은 유효한 명령을 생성하는 방법을 보여 주는 구문 다이어그램을 사용하여 문서화됩니다.
기본 요소
구문 다이어그램은 이러한 기본 구성 요소를 사용하여 SQL 문을 나타냅니다. 각 구성 요소 뒤에 예제가 잇습니다.
키워드
키워드는 대문자로 표시되지만 대/소문자를 구분하지 않습니다.
SELECT
토큰
표시된 대로 정확하게 입력해야 하는 리터럴 문자: (, , )<, , *>.,
조항
절의 이름은 구문 섹션입니다. 대문자 절(예: LIMIT clause)은 설명서에 연결됩니다. 밑줄(예: named_expression)이 있는 소문자 절은 로컬로 정의됩니다.
LIMIT clause
named_expression
Argument
함수 인수는 camelCase를 사용하며 Databricks SQL 함수 참조의 인수 섹션에 설명되어 있습니다.
mapExpr
구문 표기법
특수 기호는 구성 요소를 결합, 반복 또는 생략하는 방법을 나타냅니다.
필수 시퀀스
공백으로 구분된 구성 요소는 순서대로 표시되어야 합니다.
SELECT expr
필수 선택
구분 기호가 있는 | 중괄호는 { } 정확히 하나의 옵션을 선택해야 하다는 의미입니다.
{ INT | INTEGER }
선택 사항
구분 기호가 있는 | 대괄호는 [ ] 최대 하나의 옵션을 선택할 수 있습니다.
[ ASC | DESC ]
Grouping
의미 없는 | 중괄호는 { } 모든 구성 요소를 포함해야 합니다.
{ SELECT expr }
선택적 요소
대괄호는 [ ] 묶은 구성 요소가 선택 사항임을 의미합니다.
[ NOT NULL ]
반복
줄임표 [...] 는 이전 구성 요소를 반복할 수 있습니다. 앞에 구분 기호(, ...)가 있는 경우 반복 간에 해당 구분 기호를 사용해야 합니다.
col_option [...]
col_alias [, ...]
{ expr [ AS ] col_alias } [, ...]
코멘트
Databricks SQL은 C 스타일 주석(/* ... */) 및 줄 주석(-- ...)을 지원합니다.