Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

Chartbrew를 ClickHouse에 연결하기

커뮤니티 유지 관리

Chartbrew은 대시보드를 만들고 데이터를 실시간으로 모니터링할 수 있는 데이터 시각화 플랫폼입니다. ClickHouse를 포함한 여러 데이터 소스를 지원하며, 차트와 보고서를 코드 없이 만들 수 있는 노코드 인터페이스를 제공합니다.

목표

이 가이드에서는 Chartbrew를 ClickHouse에 연결하고, SQL 쿼리를 실행한 뒤 시각화를 만듭니다. 완료되면 대시보드는 다음과 비슷한 모습이 됩니다:

Chartbrew 대시보드

연결 정보 수집하기

HTTP(S)로 ClickHouse에 연결하려면 다음 정보가 필요합니다.

매개변수 설명
HOST and PORT 일반적으로 TLS를 사용하는 경우 포트는 8443, TLS를 사용하지 않는 경우 8123입니다.
DATABASE NAME 기본적으로 default라는 이름의 데이터베이스가 제공되며, 연결할 데이터베이스 이름을 사용하십시오.
USERNAME and PASSWORD 기본 사용자 이름은 default입니다. 사용 사례에 맞는 사용자 이름을 사용하십시오.

ClickHouse Cloud 서비스의 연결 정보는 ClickHouse Cloud 콘솔에서 확인할 수 있습니다. 서비스를 선택한 다음 Connect를 클릭하십시오.

ClickHouse Cloud 서비스 연결 버튼

HTTPS를 선택하십시오. 연결 정보가 예시 curl 명령으로 표시됩니다.

ClickHouse Cloud HTTPS 연결 정보

자가 관리형 ClickHouse를 사용하는 경우 연결 정보는 ClickHouse 관리자가 설정합니다.

Chartbrew를 ClickHouse에 연결하기

  1. Chartbrew에 로그인한 다음 Connections 탭으로 이동합니다.

  2. Create connection을 클릭하고 사용 가능한 데이터베이스 옵션에서 ClickHouse를 선택합니다.

    Chartbrew에서 ClickHouse 연결 선택
  3. ClickHouse 데이터베이스의 연결 정보를 입력합니다:

    • Display Name: Chartbrew에서 연결을 식별할 이름입니다.
    • Host: ClickHouse 서버의 호스트명 또는 IP 주소입니다.
    • Port: HTTPS 연결에는 일반적으로 8443을 사용합니다.
    • Database Name: 연결할 데이터베이스입니다.
    • Username: ClickHouse 사용자 이름입니다.
    • Password: ClickHouse 비밀번호입니다.
    Chartbrew의 ClickHouse 연결 설정
  4. Test connection을 클릭하여 Chartbrew가 ClickHouse에 연결할 수 있는지 확인합니다.

  5. 테스트에 성공하면 Save connection을 클릭합니다. Chartbrew가 ClickHouse에서 스키마를 자동으로 가져옵니다.

    Chartbrew의 ClickHouse JSON 스키마

데이터셋을 만들고 SQL 쿼리 실행하기

  1. Create dataset 버튼을 클릭하거나 Datasets 탭으로 이동해 데이터셋을 생성합니다.
  2. 앞에서 생성한 ClickHouse 연결을 선택합니다.
데이터셋용 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;
Chartbrew의 ClickHouse SQL 쿼리

Run query를 클릭하여 데이터를 가져옵니다.

쿼리 작성이 어렵다면 Chartbrew의 AI 어시스턴트를 사용해 데이터베이스 스키마를 기반으로 SQL 쿼리를 생성할 수 있습니다.

Chartbrew의 ClickHouse AI SQL 어시스턴트

데이터를 가져온 후 Configure dataset을 클릭하여 시각화 매개변수를 설정합니다.

시각화 만들기

  1. 시각화를 위한 메트릭(수치 값)과 차원(범주형 값)을 정의합니다.
  2. 쿼리 결과가 올바르게 구조화되었는지 확인하기 위해 데이터셋을 미리 봅니다.
  3. 차트 유형(예: 라인 차트, 막대 차트, 파이 차트)을 선택하고 대시보드에 추가합니다.
  4. Complete dataset을 클릭하여 설정을 완료합니다.
ClickHouse 데이터가 포함된 Chartbrew 대시보드

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

ClickHouse 데이터가 포함된 Chartbrew 대시보드

데이터 업데이트 자동화하기

대시보드를 최신 상태로 유지하려면 자동 데이터 업데이트를 예약할 수 있습니다:

  1. 데이터셋 갱신 버튼 옆의 Calendar 아이콘을 클릭합니다.
  2. 업데이트 간격(예: 매시간, 매일)을 설정합니다.
  3. 설정을 저장하여 자동 갱신을 활성화합니다.
Chartbrew 데이터셋 갱신 설정

더 알아보기

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

Navigation