Chartbrew은 대시보드를 만들고 데이터를 실시간으로 모니터링할 수 있는 데이터 시각화 플랫폼입니다. ClickHouse를 포함한 여러 데이터 소스를 지원하며, 차트와 보고서를 코드 없이 만들 수 있는 노코드 인터페이스를 제공합니다.
목표
이 가이드에서는 Chartbrew를 ClickHouse에 연결하고, SQL 쿼리를 실행한 뒤 시각화를 만듭니다. 완료되면 대시보드는 다음과 비슷한 모습이 됩니다:

연결 정보 수집하기
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 관리자가 설정합니다.
Chartbrew를 ClickHouse에 연결하기
-
Chartbrew에 로그인한 다음 Connections 탭으로 이동합니다.
-
Create connection을 클릭하고 사용 가능한 데이터베이스 옵션에서 ClickHouse를 선택합니다.

-
ClickHouse 데이터베이스의 연결 정보를 입력합니다:
- Display Name: Chartbrew에서 연결을 식별할 이름입니다.
- Host: ClickHouse 서버의 호스트명 또는 IP 주소입니다.
- Port: HTTPS 연결에는 일반적으로
8443을 사용합니다. - Database Name: 연결할 데이터베이스입니다.
- Username: ClickHouse 사용자 이름입니다.
- Password: ClickHouse 비밀번호입니다.

-
Test connection을 클릭하여 Chartbrew가 ClickHouse에 연결할 수 있는지 확인합니다.
-
테스트에 성공하면 Save connection을 클릭합니다. Chartbrew가 ClickHouse에서 스키마를 자동으로 가져옵니다.

데이터셋을 만들고 SQL 쿼리 실행하기
- Create dataset 버튼을 클릭하거나 Datasets 탭으로 이동해 데이터셋을 생성합니다.
- 앞에서 생성한 ClickHouse 연결을 선택합니다.

시각화할 데이터를 가져오는 SQL 쿼리를 작성합니다. 예를 들어, 다음 쿼리는 uk_price_paid 데이터셋에서 연도별 평균 거래 가격을 계산합니다:
SELECT toYear(date) AS year, avg(price) AS avg_price
FROM uk_price_paid
GROUP BY year
ORDER BY year;
Run query를 클릭하여 데이터를 가져옵니다.
쿼리 작성이 어렵다면 Chartbrew의 AI 어시스턴트를 사용해 데이터베이스 스키마를 기반으로 SQL 쿼리를 생성할 수 있습니다.

데이터를 가져온 후 Configure dataset을 클릭하여 시각화 매개변수를 설정합니다.
시각화 만들기
- 시각화를 위한 메트릭(수치 값)과 차원(범주형 값)을 정의합니다.
- 쿼리 결과가 올바르게 구조화되었는지 확인하기 위해 데이터셋을 미리 봅니다.
- 차트 유형(예: 라인 차트, 막대 차트, 파이 차트)을 선택하고 대시보드에 추가합니다.
- Complete dataset을 클릭하여 설정을 완료합니다.

데이터의 다양한 측면을 시각화할 수 있도록 원하는 만큼 데이터셋을 만들 수 있습니다. 이러한 데이터셋을 사용해 여러 대시보드를 만들어 서로 다른 메트릭을 추적할 수 있습니다.

데이터 업데이트 자동화하기
대시보드를 최신 상태로 유지하려면 자동 데이터 업데이트를 예약할 수 있습니다:
- 데이터셋 갱신 버튼 옆의 Calendar 아이콘을 클릭합니다.
- 업데이트 간격(예: 매시간, 매일)을 설정합니다.
- 설정을 저장하여 자동 갱신을 활성화합니다.

더 알아보기
자세한 내용은 Chartbrew와 ClickHouse 관련 블로그 게시물을 참조하세요.