5 - Apache Superset SQL Lab 사용법

SQL Lab은 Apache Superset의 강력한 SQL 편집기로, 데이터 탐색, 쿼리 작성 및 데이터 준비를 위한 도구입니다.

SQL Lab의 주요 기능

SQL Lab은 다음과 같은 두 가지 주요 인터페이스를 제공합니다:

• SQL 편집기: 쿼리 작성 및 실행
• 결과 뷰: 쿼리 결과 확인 및 시각화

Superset 소개

SQL Lab 사용 방법

1. 기본 쿼리 실행하기

1. 왼쪽 패널에서 데이터베이스와 스키마를 선택합니다
2. 테이블을 선택하면 해당 테이블의 컬럼 정보가 표시됩니다
3. SQL 편집기에 쿼리를 작성합니다
4. "Run" 버튼을 클릭하여 쿼리를 실행합니다
5. 결과는 하단 패널에 표시됩니다

2. 고급 기능

SQL 포맷팅

• Ctrl+Shift+F 단축키를 사용하거나 SQL 구성 패널의 "Format SQL" 메뉴 옵션을 통해 SQL 쿼리를 자동으로 포맷팅할 수 있습니다
• SQL 패널 구성에서 "키보드 단축키" 메뉴 옵션을 통해 사용 가능한 단축키를 확인할 수 있습니다

Release Notes 3.1

비동기 쿼리 실행

• 장시간 실행되는 쿼리의 경우 "Run Async" 옵션을 선택하여 백그라운드에서 실행할 수 있습니다
• 기본적으로 Superset은 쿼리가 최대 6시간 동안 실행되도록 허용합니다
• 시간 제한을 변경하려면 구성 파일에서 SQLLAB_ASYNC_TIME_LIMIT_SEC 값을 조정할 수 있습니다

FAQ

Jinja 템플릿 사용

SQL Lab은 쿼리에서 Jinja 템플릿을 지원합니다. 이를 활성화하려면 ENABLE_TEMPLATE_PROCESSING 기능 플래그를 활성화해야 합니다:

SELECT *  
FROM tbl  
WHERE dttm_col > '{{ from_dttm }}' and dttm_col < '{{ to_dttm }}'  

SQL Templating

쿼리 결과 저장 및 시각화

1. 쿼리 결과를 데이터셋으로 저장할 수 있습니다
2. "Explore" 버튼을 클릭하여 결과를 시각화할 수 있습니다
3. 시각화를 대시보드에 추가할 수 있습니다

쿼리 히스토리

• SQL Lab은 이전에 실행한 쿼리의 히스토리를 제공합니다
• 쿼리 히스토리에서 이전 쿼리를 검색하고 재사용할 수 있습니다
• SQL 미리보기 모달을 통해 이전 쿼리를 확인할 수 있습니다

Release Notes 1.0

주의사항

1. 타임아웃: 쿼리가 너무 오래 실행되면 타임아웃될 수 있습니다. 이 경우 비동기 실행을 사용하세요.
2. 언어 설정: 일부 버전에서는 언어 설정을 변경할 때 SQL Lab에서 쿼리 실행 문제가 발생할 수 있습니다.
3. 오류 메시지: SQL Lab은 초기 사용자 정의 오류 메시지를 제공하여 문제 해결에 도움을 줍니다.

SQL Lab은 Superset의 강력한 기능 중 하나로, 데이터 탐색부터 시각화까지 원활한 워크플로우를 제공합니다.