Superset

VPC 환경에서 이용 가능합니다.

외부 BI 연결 - Superset

Superset에서 Data Query 연결 방법은 다음과 같습니다.

설치된 Superset에 로그인 후 화면 우측 상단의 Settings > Data - Database Connection 메뉴를 차례대로 클릭해 주십시오.
Databases 메뉴에서 우측 상단의 + DATABASE 버튼을 클릭해 주십시오.
아래 SUPPORTED DATABASES 에서 trino를 선택합니다.
Enter Primary Credentials 단계의 BASIC tab에서 DISPLAY NAME 입력 후 SQLALCHEMY URI 항목에 아래의 URI를 입력합니다.
TEST CONNECTION으로 연결 상태 확인 후, FINISH 버튼을 클릭해 연결할 Database 생성을 완료합니다.
Superset 상단 SQL > SQL Lab 메뉴를 차례대로 클릭하여, 생성한 Database의 SCHEMA, TABLE 목록이 정상적으로 조회되는지 확인합니다.

참고

Data Query 연결 SQLALCHEMY URI

trino://{SubAccount ACCESS_KEY}:{SubAccount SECRET_KEY}@{Data Query DOMAIN}:443/{사용자의 Data Source 이름}
- URI example
```
trino://A6____F8:1B____F3@kr.dataquery.naverncp.com:443/data_catalog
```

연결 화면

주의

외부 BI 도구에서의 스키마 관리 방식에 따라 주기적 또는 빈번한 쿼리 호출이 발생할 수 있습니다.

문제 해결

Superset 빌드 유형(예: production 용도의 빌드)에 따라 Data Query 연결에 필요한 trino 드라이버가 기본적으로 포함되어 있지 않을 수 있습니다.
해당 원인으로 Database Connection 생성이 실패하는 경우, 사용자의 Superset 설치 유형에 따라 아래 방법을 참고하여 드라이버를 추가해 주십시오.

1. PyPI installation 환경

Superset > Installation (PyPI)
superset 설치된 환경에서 sqlalchemy-trino 패키지 추가 설치
```
pip install sqlalchemy-trino
```

2. Docker Compose Installation 환경

Superset > Installation (Docker Compose)
docker compose 형태로 Superset을 배포하는 과정에서
requirements-local.txt 내에 sqlalchemy-trino 내용을 추가 후 docker compose up 명령 수행
```
echo "sqlalchemy-trino" >> ./docker/requirements-local.txt
```

3. Kubernetes 환경

Superset > Installation (Kubernetes)
helm value 파일의 bootstrapScript 항목에 sqlalchemy-trino 항목을 추가
```
bootstrapScript: |
  #!/bin/bash
  pip install sqlalchemy-trino
```