메인 콘텐츠로 건너뛰기
Apache Superset는 Python으로 작성된 오픈소스 데이터 탐색 및 시각화 플랫폼입니다. Superset은 ClickHouse에서 제공하는 Python 드라이버를 사용해 ClickHouse에 연결합니다. 작동 방식을 살펴보겠습니다…

​
목표

이 가이드에서는 ClickHouse 데이터베이스의 데이터를 사용해 Superset에서 대시보드를 만듭니다. 완성된 대시보드는 다음과 같습니다.
데이터 추가작업할 데이터셋이 없다면 예시 중 하나를 추가할 수 있습니다. 이 가이드에서는 UK Price Paid 데이터셋을 사용하므로, 이를 선택하면 됩니다. 같은 문서 카테고리에서 확인할 수 있는 다른 예시도 여러 개 있습니다.

​
1. 연결 정보 확인하기

HTTP(S)로 ClickHouse에 연결하려면 다음 정보가 필요합니다. ClickHouse Cloud 서비스의 연결 정보는 ClickHouse Cloud 콘솔에서 확인할 수 있습니다. 서비스를 선택한 다음 Connect를 클릭하십시오. HTTPS를 선택하십시오. 연결 정보가 예시 curl 명령으로 표시됩니다. 자가 관리형 ClickHouse를 사용하는 경우 연결 정보는 ClickHouse 관리자가 설정합니다.

​
2. 드라이버 설치

  1. Superset은 ClickHouse에 연결하기 위해 clickhouse-connect 드라이버를 사용합니다. clickhouse-connect에 대한 자세한 내용은 https://pypi.org/project/clickhouse-connect/에서 확인할 수 있으며, 다음 명령으로 설치할 수 있습니다.
Docker Compose 설정Docker 기반 설치에서는 컨테이너에 clickhouse-connect를 추가하는 방법을 Superset 데이터베이스 구성 가이드에서 확인하십시오.
  1. Superset을 시작하거나 다시 시작하십시오.

​
3. Superset를 ClickHouse에 연결하기

  1. Superset에서 상단 메뉴의 Data를 선택한 다음 드롭다운 메뉴에서 Databases를 선택합니다. + Database 버튼을 클릭하여 새 데이터베이스를 추가합니다.

  1. 첫 번째 단계에서 데이터베이스 유형으로 ClickHouse Connect를 선택합니다.

  1. 두 번째 단계에서:
  • SSL 사용 여부를 설정합니다.
  • 앞서 확인한 연결 정보를 입력합니다.
  • DISPLAY NAME을 지정합니다. 원하는 이름을 사용할 수 있습니다. 여러 ClickHouse 데이터베이스에 연결할 예정이라면 더 구체적인 이름을 지정하는 것이 좋습니다.

  1. CONNECT를 클릭한 다음 FINISH를 클릭하여 설정 마법사를 완료합니다. 완료되면 데이터베이스 목록에 추가한 데이터베이스가 표시됩니다.

​
4. 데이터셋 추가

  1. Superset에서 ClickHouse 데이터를 사용하려면 데이터셋을 정의해야 합니다. Superset 상단 메뉴에서 Data를 선택한 다음 드롭다운 메뉴에서 Datasets를 선택하십시오.
  2. 데이터셋 추가 버튼을 클릭하십시오. 새 데이터베이스를 데이터 소스로 선택하면 해당 데이터베이스에 정의된 테이블이 표시됩니다:

  1. 대화 상자 하단의 ADD 버튼을 클릭하면 테이블이 데이터셋 목록에 나타납니다. 이제 대시보드를 만들고 ClickHouse 데이터를 분석할 준비가 되었습니다!

​
5. Superset에서 차트와 대시보드 만들기

Superset에 익숙하다면 다음 섹션도 어렵지 않게 진행할 수 있습니다. Superset이 처음이라면, 음… 다른 훌륭한 시각화 도구들과 비슷하다고 보면 됩니다. 시작은 쉽지만, 세부 기능과 사용상의 차이는 직접 사용하면서 점차 익히게 됩니다.
  1. 먼저 대시보드를 만듭니다. Superset의 상단 메뉴에서 Dashboards를 선택합니다. 오른쪽 상단의 버튼을 클릭해 새 대시보드를 추가합니다. 아래 예시의 대시보드 이름은 UK property prices입니다:

  1. 새 차트를 만들려면 상단 메뉴에서 Charts를 선택한 다음, 버튼을 클릭해 새 차트를 추가합니다. 다양한 옵션이 표시됩니다. 아래 예시에서는 CHOOSE A DATASET 드롭다운에서 uk_price_paid 데이터셋을 선택하고 Pie Chart 차트를 사용하는 모습을 보여줍니다:

  1. Superset의 파이 차트에는 Dimension과 Metric이 필요하며, 나머지 설정은 선택 사항입니다. 차원과 메트릭에는 원하는 필드를 선택할 수 있고, 이 예시에서는 ClickHouse 필드 district를 차원으로, AVG(price)를 메트릭으로 사용합니다.

  1. 파이 차트보다 도넛 차트를 선호한다면 CUSTOMIZE 아래에서 해당 옵션과 기타 옵션을 설정할 수 있습니다:

  1. SAVE 버튼을 클릭해 차트를 저장한 다음, ADD TO DASHBOARD 드롭다운에서 UK property prices를 선택합니다. 이어서 SAVE & GO TO DASHBOARD를 클릭하면 차트가 저장되고 대시보드에 추가됩니다:

  1. 이것으로 끝입니다. ClickHouse의 데이터를 기반으로 Superset에서 대시보드를 만들면 매우 빠른 데이터 분석의 가능성을 폭넓게 활용할 수 있습니다!

마지막 수정일 2026년 7월 2일