---
title: "Superset"
slug: "dataquery-bi-superset-vpc"
updated: 2026-09-17T09:07:29Z
published: 2026-09-17T09:07:29Z
canonical: "guide.ncloud-docs.com/dataquery-bi-superset-vpc"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Superset

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

## 외부 BI 연결 - Superset

[Superset](https://superset.apache.org/)에서 Data Query 연결 방법은 다음과 같습니다.

1. 설치된 Superset에 로그인 후 화면 우측 상단의 **Settings** > **Data - Database Connection** 메뉴를 차례대로 클릭해 주십시오.
2. **Databases** 메뉴에서 우측 상단의 **+ DATABASE** 버튼을 클릭해 주십시오.
3. 아래 **SUPPORTED DATABASES** 에서 **trino**를 선택합니다.
4. **Enter Primary Credentials** 단계의 **BASIC** tab에서 DISPLAY NAME 입력 후 **SQLALCHEMY URI** 항목에 아래의 URI를 입력합니다.
5. **TEST CONNECTION**으로 연결 상태 확인 후, **FINISH** 버튼을 클릭해 연결할 Database 생성을 완료합니다.
6. 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
```

#### 연결 화면

![image.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/image-DQ90ED41.png?sv=2026-02-06&spr=https&st=2026-11-13T18%3A44%3A17Z&se=2026-11-13T19%3A44%3A17Z&sr=c&sp=r&sig=9O%2FpnrTmMWMkKiZw4szSY7n0p6I10OHq37WkrLV%2FRes%3D)

          주의

          

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

### 문제 해결

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

**1. PyPI installation 환경**

- [Superset > Installation (PyPI)](https://superset.apache.org/docs/installation/installation-methods#pypi-python)
- superset 설치된 환경에서 `sqlalchemy-trino` 패키지 추가 설치

```
pip install sqlalchemy-trino
```

**2. Docker Compose Installation 환경**

- [Superset > Installation (Docker Compose)](https://superset.apache.org/docs/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)](https://superset.apache.org/docs/installation/kubernetes#dependencies)
- helm value 파일의 bootstrapScript 항목에 `sqlalchemy-trino` 항목을 추가

```
bootstrapScript: |
  #!/bin/bash
  pip install sqlalchemy-trino
```