> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Apache Superset은 오픈소스 데이터 탐색 및 시각화 플랫폼입니다.
# Superset을 ClickHouse에 연결하기
export const ClickHouseSupportedBadge = () => {
return ;
};
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return ;
};
Apache Superset는 Python으로 작성된 오픈소스 데이터 탐색 및 시각화 플랫폼입니다. Superset은 ClickHouse에서 제공하는 Python 드라이버를 사용해 ClickHouse에 연결합니다. 작동 방식을 살펴보겠습니다...
## 목표
이 가이드에서는 ClickHouse 데이터베이스의 데이터를 사용해 Superset에서 대시보드를 만듭니다. 완성된 대시보드는 다음과 같습니다.
**데이터 추가**
작업할 데이터셋이 없다면 예시 중 하나를 추가할 수 있습니다. 이 가이드에서는 [UK Price Paid](/ko/get-started/sample-datasets/uk-price-paid) 데이터셋을 사용하므로, 이를 선택하면 됩니다. 같은 문서 카테고리에서 확인할 수 있는 다른 예시도 여러 개 있습니다.
## 1. 연결 정보 확인하기
HTTP(S)로 ClickHouse에 연결하려면 다음 정보가 필요합니다.
| 매개변수 | 설명 |
| ------------------------- | ---------------------------------------------------------- |
| `HOST` and `PORT` | 일반적으로 TLS를 사용하는 경우 포트는 8443, TLS를 사용하지 않는 경우 8123입니다. |
| `DATABASE NAME` | 기본적으로 `default`라는 이름의 데이터베이스가 제공되며, 연결할 데이터베이스 이름을 사용하십시오. |
| `USERNAME` and `PASSWORD` | 기본 사용자 이름은 `default`입니다. 사용 사례에 맞는 사용자 이름을 사용하십시오. |
ClickHouse Cloud 서비스의 연결 정보는 ClickHouse Cloud 콘솔에서 확인할 수 있습니다.
서비스를 선택한 다음 **Connect**를 클릭하십시오.
**HTTPS**를 선택하십시오. 연결 정보가 예시 `curl` 명령으로 표시됩니다.
자가 관리형 ClickHouse를 사용하는 경우 연결 정보는 ClickHouse 관리자가 설정합니다.
## 2. 드라이버 설치
1. Superset은 ClickHouse에 연결하기 위해 `clickhouse-connect` 드라이버를 사용합니다. `clickhouse-connect`에 대한 자세한 내용은 [https://pypi.org/project/clickhouse-connect/](https://pypi.org/project/clickhouse-connect/)에서 확인할 수 있으며, 다음 명령으로 설치할 수 있습니다.
```console theme={null}
pip install clickhouse-connect
```
**Docker Compose 설정**
Docker 기반 설치에서는 컨테이너에 `clickhouse-connect`를 추가하는 방법을 [Superset 데이터베이스 구성 가이드](https://superset.apache.org/docs/configuration/databases/#clickhouse)에서 확인하십시오.
2. Superset을 시작하거나 다시 시작하십시오.
## 3. Superset를 ClickHouse에 연결하기
1. Superset에서 상단 메뉴의 **Data**를 선택한 다음 드롭다운 메뉴에서 **Databases**를 선택합니다. **+ Database** 버튼을 클릭하여 새 데이터베이스를 추가합니다.
2. 첫 번째 단계에서 데이터베이스 유형으로 **ClickHouse Connect**를 선택합니다.
3. 두 번째 단계에서:
* SSL 사용 여부를 설정합니다.
* 앞서 확인한 연결 정보를 입력합니다.
* **DISPLAY NAME**을 지정합니다. 원하는 이름을 사용할 수 있습니다. 여러 ClickHouse 데이터베이스에 연결할 예정이라면 더 구체적인 이름을 지정하는 것이 좋습니다.
4. **CONNECT**를 클릭한 다음 **FINISH**를 클릭하여 설정 마법사를 완료합니다. 완료되면 데이터베이스 목록에 추가한 데이터베이스가 표시됩니다.
## 4. 데이터셋 추가
1. Superset에서 ClickHouse 데이터를 사용하려면 ***데이터셋***을 정의해야 합니다. Superset 상단 메뉴에서 **Data**를 선택한 다음 드롭다운 메뉴에서 **Datasets**를 선택하십시오.
2. 데이터셋 추가 버튼을 클릭하십시오. 새 데이터베이스를 데이터 소스로 선택하면 해당 데이터베이스에 정의된 테이블이 표시됩니다:
3. 대화 상자 하단의 **ADD** 버튼을 클릭하면 테이블이 데이터셋 목록에 나타납니다. 이제 대시보드를 만들고 ClickHouse 데이터를 분석할 준비가 되었습니다!
## 5. Superset에서 차트와 대시보드 만들기
Superset에 익숙하다면 다음 섹션도 어렵지 않게 진행할 수 있습니다. Superset이 처음이라면, 음... 다른 훌륭한 시각화 도구들과 비슷하다고 보면 됩니다. 시작은 쉽지만, 세부 기능과 사용상의 차이는 직접 사용하면서 점차 익히게 됩니다.
1. 먼저 대시보드를 만듭니다. Superset의 상단 메뉴에서 **Dashboards**를 선택합니다. 오른쪽 상단의 버튼을 클릭해 새 대시보드를 추가합니다. 아래 예시의 대시보드 이름은 **UK property prices**입니다:
2. 새 차트를 만들려면 상단 메뉴에서 **Charts**를 선택한 다음, 버튼을 클릭해 새 차트를 추가합니다. 다양한 옵션이 표시됩니다. 아래 예시에서는 **CHOOSE A DATASET** 드롭다운에서 **uk\_price\_paid** 데이터셋을 선택하고 **Pie Chart** 차트를 사용하는 모습을 보여줍니다:
3. Superset의 파이 차트에는 **Dimension**과 **Metric**이 필요하며, 나머지 설정은 선택 사항입니다. 차원과 메트릭에는 원하는 필드를 선택할 수 있고, 이 예시에서는 ClickHouse 필드 `district`를 차원으로, `AVG(price)`를 메트릭으로 사용합니다.
5. 파이 차트보다 도넛 차트를 선호한다면 **CUSTOMIZE** 아래에서 해당 옵션과 기타 옵션을 설정할 수 있습니다:
6. **SAVE** 버튼을 클릭해 차트를 저장한 다음, **ADD TO DASHBOARD** 드롭다운에서 **UK property prices**를 선택합니다. 이어서 **SAVE & GO TO DASHBOARD**를 클릭하면 차트가 저장되고 대시보드에 추가됩니다:
7. 이것으로 끝입니다. ClickHouse의 데이터를 기반으로 Superset에서 대시보드를 만들면 매우 빠른 데이터 분석의 가능성을 폭넓게 활용할 수 있습니다!