SQL 언어 참조

Databricks SQL 및 Databricks Runtime에 대한 SQL 명령 참조입니다.

이 참조의 구문 표기법 및 기호를 이해하고 사용하는 방법에 대한 자세한 내용은 SQL 참조를 사용하는 방법을 참조하세요.

Lakeflow Spark 선언적 파이프라인에서 SQL을 사용하는 방법에 대한 자세한 내용은 파이프라인 SQL 언어 참조를 참조하세요.

Note

Azure 중국 지역에서는 Databricks SQL Serverless를 사용할 수 없습니다. Azure Government 지역에서는 Databricks SQL을 사용할 수 없습니다.

일반 참조

이 일반 참조는 데이터 형식, 함수, 식별자, 리터럴 및 의미 체계를 설명합니다.

언어 기본 사항

Reference	Description
SQL 문에 주석 추가	SQL 코드에 주석 추가
예약어 및 스키마	SQL 파서에서 예약된 키워드
Identifiers	데이터베이스 개체 이름 지정 규칙
Names	개체 명명 규칙
IDENTIFIER 절	동적 식별자 확인
SQL 식	SQL 식 구문 및 평가
NULL 의미 체계	NULL 값 처리 방법
매개 변수 표식	매개 변수가 있는 쿼리 자리 표시자
Variables	세션 및 임시 변수
이름 확인	개체 이름을 확인하는 방법
JSON 경로 식	JSON 데이터 구조 탐색
Collation	문자열 비교 및 정렬 규칙
Partitions	테이블 분할 개념

데이터 형식

Reference	Description
데이터 형식	지원되는 모든 데이터 형식 개요
SQL 데이터 형식 규칙	형식 강제 변환 및 변환 규칙
날짜/시간 패턴	날짜 및 시간에 대한 서식 패턴

구성 매개 변수

Reference	Description
구성 매개 변수	SQL 구성 개요
ANSI_MODE	ANSI SQL 준수 모드
LEGACY_TIME_PARSER_POLICY	시간 구문 분석 동작
MAX_FILE_PARTITION_BYTES	파일 파티션 크기 제한
READ_ONLY_EXTERNAL_METASTORE	외부 메타스토어 액세스 모드
STATEMENT_TIMEOUT	쿼리 시간 제한 설정
TIMEZONE	세션 표준 시간대
USE_CACHED_RESULT	쿼리 결과 캐싱

Functions

Reference	Description
Functions	SQL 함수 개요
기본 제공 함수	모든 기본 제공 함수
기본 제공 함수의 사전순 목록	전체 A-Z 함수 참조
창 함수	분석 및 순위 함수
람다 함수	익명 함수 식
H3 지리 공간적 함수	육각형 계층적 공간 인덱스
ST 지리 공간적 함수	표준 지리 공간적 함수
UDF(사용자 정의 집계 함수)	사용자 지정 집계 함수
외부 UDF(사용자 정의 스칼라 함수)	사용자 지정 스칼라 함수
Hive UDF, UDAF 및 UDTF와 통합	Hive 함수 호환성
함수 호출	함수를 호출하는 방법

Unity 카탈로그 개념

Reference	Description
주 서버	사용자, 그룹 및 서비스 주체
Unity 카탈로그의 권한 및 보안이 가능한 개체	Unity 카탈로그의 액세스 제어
Hive 메타스토어의 권한 및 보안 개체	레거시 메타스토어 액세스 제어
외부 위치	클라우드 스토리지 위치
외부 테이블	외부 데이터를 통해 백업되는 테이블
Credentials	스토리지 액세스 자격 증명
Volumes	관리되는 파일 및 외부 파일 스토리지

특별 항목

Reference	Description
Databricks 런타임의 ANSI 규정 준수	ANSI SQL 표준 호환성
Apache Hive 호환성	Hive SQL 호환성
SQL 스크립팅	절차적 SQL 논리
델타 공유	조직 간 데이터 공유
페더레이션 쿼리(레이크하우스 페더레이션)	외부 데이터베이스 쿼리
정보 스키마	메타데이터 시스템 테이블

DDL 문장

데이터 정의 문은 데이터베이스 개체의 구조를 만들거나 수정합니다.

ALTER 문

Statement	Description
ALTER CATALOG	카탈로그 속성 수정
ALTER CONNECTION	연결 설정 수정
ALTER CREDENTIAL	자격 증명 속성 수정
ALTER DATABASE	데이터베이스 속성 수정
ALTER EXTERNAL LOCATION	외부 위치 수정
ALTER MATERIALIZED VIEW	구체화된 뷰 수정
ALTER PROVIDER	데이터 공급자 수정
ALTER RECIPIENT	공유 받는 사람 수정
ALTER SCHEMA	스키마 속성 수정
ALTER SHARE	공유 구성 수정
ALTER STREAMING TABLE	스트리밍 테이블 수정
ALTER TABLE	테이블 구조 수정
ALTER VIEW	뷰 정의 수정
ALTER VOLUME	볼륨 속성 수정

CREATE 문

Statement	Description
CREATE BLOOM FILTER INDEX	블룸 필터 인덱스 만들기
CREATE CATALOG	새 카탈로그 만들기
CREATE CONNECTION	외부 연결 만들기
CREATE DATABASE	새 데이터베이스 만들기
CREATE FUNCTION(SQL 및 Python)	SQL 함수 만들기
CREATE FUNCTION(외부)	외부 함수 만들기
CREATE EXTERNAL LOCATION	외부 위치 만들기
CREATE MATERIALIZED VIEW	구체화된 뷰 만들기
프로시저 작성	저장 프로시저 만들기
CREATE RECIPIENT	공유 받는 사람 만들기
CREATE SCHEMA	새 스키마 만들기
CREATE SERVER	외신 서버 만들기
CREATE SHARE	데이터 공유 만들기
CREATE STREAMING TABLE	스트리밍 테이블 만들기
CREATE TABLE	새 테이블 만들기
CREATE VIEW	보기 생성하기
CREATE VOLUME	볼륨 만들기

분석 문

기타 DDL 문

Statement	Description
COMMENT ON	개체에 주석 추가
DECLARE VARIABLE	세션 변수 선언
REPAIR TABLE	테이블 파티션 복구
REFRESH FOREIGN (CATALOG, SCHEMA및 TABLE)	외세의 메타데이터 새로 고침
REFRESH(MATERIALIZED VIEW 또는 STREAMING TABLE)	구체화된 데이터 새로 고침
SET 태그	개체에 태그 추가
`SYNC`	메타데이터 동기화
TRUNCATE TABLE	모든 테이블 데이터 제거
UNDROP	삭제된 테이블 복원
미설정 태그	개체에서 태그 제거

DML 문

데이터 조작 문은 Delta Lake 테이블에서 데이터를 추가, 변경 또는 삭제합니다.

Statement	Description
`COPY INTO`	파일에서 테이블로 데이터 로드
DELETE FROM	테이블에서 행 삭제
INSERT	표에 행 삽입
INSERT OVERWRITE DIRECTORY	디렉터리에 쿼리 결과 쓰기
INSERT OVERWRITE DIRECTORY Hive 형식 사용하여	Hive 형식으로 결과 작성
LOAD DATA	파일에서 데이터 로드
MERGE INTO	테이블에 데이터 Upsert
UPDATE	테이블의 행 업데이트

데이터 검색 및 실행 문장

지정된 절에 따라 테이블에서 행을 검색합니다. Azure Databricks는 표준 SELECT 구문과 SQL 파이프라인 구문을 모두 지원합니다.

쿼리 문

Statement	Description
Query	전체 쿼리 구문 참조
SELECT(하위 선택)	테이블에서 데이터 선택
VALUES 절	인라인 테이블 생성
SQL 파이프라인 문법	파이프 기반 쿼리 컴퍼지션
EXPLAIN	쿼리 실행 계획 표시

쿼리 절

조항	Description
SELECT 절	열 선택
* (star) 조항	모든 열 선택
테이블 참조	테이블 및 하위 쿼리 원본
JOIN	테이블의 행 결합
WHERE 절	행 필터링
GROUP BY 절	집계를 위한 행 그룹화
HAVING 절	그룹화된 행 필터링
QUALIFY 절	필터 창 함수 결과
ORDER BY 절	결과 행 정렬
SORT BY 절	파티션 내에서 정렬
CLUSTER BY 절(SELECT)	데이터 배포 및 정렬
DISTRIBUTE BY 절	파티션 간에 데이터 배포
LIMIT 절	결과 행 제한
OFFSET 절	결과 행 건너뛰기
PIVOT 절	행을 열로 회전
UNPIVOT 절	열을 행으로 회전
LATERAL VIEW 절	테이블 생성 함수 적용
TABLESAMPLE 절	샘플 테이블 행
TVF(테이블 반환 함수) 호출	테이블을 반환하는 함수
CTE(공통 테이블 식)	명명된 하위 쿼리
연산자 설정	UNION, INTERSECT, 제외
WINDOW 절	명명된 창 정의
힌트	쿼리 최적화 프로그램 힌트

Delta Lake 문

Delta Lake 형식으로 저장된 테이블을 관리합니다. 자세한 내용은 Azure Databricks의 Delta Lake란?을 참조하세요.

Statement	Description
CACHE SELECT	쿼리 결과 캐시
CONVERT TO DELTA	Parquet을 델타로 변환
DESCRIBE HISTORY	테이블 기록 표시
FSCK REPAIR TABLE	테이블 메타데이터 복구
GENERATE	테이블 매니페스트 생성
OPTIMIZE	압축 테이블 파일
REORG TABLE	테이블 데이터 재구성
RESTORE	테이블을 이전 버전으로 복원
VACUUM	이전 테이블 파일 제거

SQL 스크립팅 문

SQL에서 절차 논리를 실행합니다. 개요 는 SQL 스크립팅 을 참조하세요.

Statement	Description
BEGIN END 복합문	문을 블록으로 그룹화
CASE 문	조건부 분기
FOR 문	범위 또는 커서를 반복합니다.
GET 진단 문	실행 정보 검색
IF THEN ELSE 문장	조건부 실행
ITERATE 문	다음 루프 반복 계속
LEAVE 문	루프 또는 블록 종료
LOOP 문	무조건 루프
REPEAT 문	조건이 true가 될 때까지 반복
RESIGNAL 문	예외 다시 발생
SIGNAL 문	예외 발생
WHILE 문	조건이 true인 동안 루프

보조 명령문

통계를 수집하고, 캐싱을 관리하고, 메타데이터를 탐색하고, 구성을 설정하고, 리소스를 관리합니다.

ANALYZE 문

Statement	Description
ANALYZE TABLE ... 컴퓨팅 통계	계산 테이블 열 통계
ANALYZE TABLE ... 컴퓨팅 스토리지 메트릭	컴퓨팅 테이블 스토리지 메트릭

캐시 문

적용 대상: Databricks 런타임

Statement	Description
CACHE TABLE	메모리의 캐시 테이블
CLEAR CACHE	캐시된 모든 데이터 제거
REFRESH CACHE	캐시된 데이터 새로 고침
REFRESH FUNCTION	함수 메타데이터 새로 고침
REFRESH TABLE	테이블 메타데이터 새로 고침
UNCACHE TABLE	캐시에서 테이블 제거

DESCRIBE 문

Statement	Description
DESCRIBE CATALOG	카탈로그 세부 정보 표시
DESCRIBE CONNECTION	연결 세부 정보 표시
DESCRIBE CREDENTIAL	자격 증명 세부 정보 표시
DESCRIBE DATABASE	데이터베이스 세부 정보 표시
DESCRIBE FUNCTION	함수 세부 정보 표시
DESCRIBE EXTERNAL LOCATION	위치 세부 정보 표시
절차 설명	프로시저 세부 정보 표시
DESCRIBE PROVIDER	공급자 세부 정보 표시
DESCRIBE QUERY	쿼리 출력 스키마 표시
DESCRIBE RECIPIENT	받는 사람 세부 정보 표시
DESCRIBE SCHEMA	스키마 세부 정보 표시
DESCRIBE SHARE	공유 세부 정보 표시
DESCRIBE TABLE	테이블 세부 정보 표시
DESCRIBE VOLUME	볼륨 세부 정보 표시

SHOW 문

Statement	Description
LIST	경로의 파일 나열
SHOW ALL IN SHARE	공유에 있는 모든 개체 표시
SHOW CATALOGS	카탈로그 나열
SHOW COLUMNS	테이블 열 나열
SHOW CONNECTIONS	연결 목록
SHOW CREATE TABLE	테이블 DDL 표시
SHOW CREDENTIALS	자격 증명 나열
SHOW DATABASES	데이터베이스 목록 표시
SHOW FUNCTIONS	목록 함수
SHOW GROUPS	그룹 나열
SHOW EXTERNAL LOCATIONS	외부 위치 나열
SHOW PARTITIONS	테이블 파티션 나열
프로시저 표시	프로시저 나열
SHOW PROVIDERS	공급자 나열
SHOW RECIPIENTS	받는 사람 나열
SHOW SCHEMAS	스키마 나열
SHOW SHARES	공유 나열
SHOW SHARES IN PROVIDER	공급자의 공유 나열
SHOW TABLE EXTENDED	테이블 정보 표시
SHOW TABLES	테이블 목록
SHOW TABLES DROPPED	삭제된 테이블 나열
SHOW TBLPROPERTIES	테이블 속성 표시
SHOW USERS	사용자 목록
SHOW VIEWS	목록 보기
SHOW VOLUMES	볼륨 나열

구성 및 변수 관리

Statement	Description
CALL	저장 프로시저 호출
EXECUTE IMMEDIATE	동적 SQL 실행
RESET	구성을 기본값으로 다시 설정
SET	구성 매개 변수 설정
SET RECIPIENT	공유 받는 사람 컨텍스트 설정
SET TIME ZONE	세션 표준 시간대 설정
SET 변수	변수 값 설정
USE CATALOG	현재 카탈로그 설정
USE DATABASE	현재 데이터베이스 설정
USE SCHEMA	현재 스키마 설정

리소스 관리