Lightdash와 ClickHouse로 인터랙티브 대시보드 만들기
연결 정보 수집
Lightdash와 ClickHouse 간 연결을 설정할 때는 다음 정보가 필요합니다.- Host: ClickHouse 데이터베이스가 실행 중인 주소
- User: ClickHouse 데이터베이스 사용자명
- Password: ClickHouse 데이터베이스 비밀번호
- DB name: ClickHouse 데이터베이스 이름
- Schema: dbt가 프로젝트를 컴파일하고 실행할 때 사용하는 기본 스키마(schema) (
profiles.yml에서 확인할 수 있음) - Port: ClickHouse HTTPS 인터페이스 포트(기본값:
8443) - Secure: 보안 연결을 위해 HTTPS/SSL을 사용하려면 이 옵션을 활성화합니다
- Retries: 실패한 ClickHouse 쿼리를 Lightdash가 다시 시도하는 횟수(기본값:
3) - Start of week: 보고 주간이 시작되는 요일을 선택합니다. 기본값은 웨어하우스 설정을 따릅니다
| 매개변수 | 설명 |
|---|---|
HOST and PORT | 일반적으로 TLS를 사용하는 경우 포트는 8443, TLS를 사용하지 않는 경우 8123입니다. |
DATABASE NAME | 기본적으로 default라는 이름의 데이터베이스가 제공되며, 연결할 데이터베이스 이름을 사용하십시오. |
USERNAME and PASSWORD | 기본 사용자 이름은 default입니다. 사용 사례에 맞는 사용자 이름을 사용하십시오. |
curl 명령으로 표시됩니다.자가 관리형 ClickHouse를 사용하는 경우 연결 정보는 ClickHouse 관리자가 설정합니다.ClickHouse용 dbt 프로필 구성하기
Lightdash에서는 기존 dbt 프로젝트를 기반으로 연결을 설정합니다. ClickHouse에 연결하려면 로컬~/.dbt/profiles.yml 파일에 유효한 ClickHouse 대상 구성이 포함되어 있는지 확인하세요.예시는 다음과 같습니다:ClickHouse에 연결된 Lightdash 프로젝트 생성하기
dbt 프로필이 ClickHouse용으로 구성되면 dbt 프로젝트도 Lightdash에 연결해야 합니다.이 과정은 모든 데이터 웨어하우스에서 동일하므로 여기서는 자세히 다루지 않겠습니다. dbt 프로젝트를 가져오는 방법은 공식 Lightdash 가이드를 참조하십시오:dbt 프로젝트 가져오기 → Lightdash Docsdbt 프로젝트를 연결한 후에는 Lightdash가profiles.yml 파일에서 ClickHouse 구성을 자동으로 감지합니다. 연결 테스트가 성공하면 dbt 모델을 탐색하고 ClickHouse 기반 대시보드를 만들 수 있습니다.Lightdash에서 ClickHouse 데이터를 탐색하세요
연결되면 Lightdash가 dbt 모델을 자동으로 동기화하고 다음 항목을 제공합니다:- YAML에 정의된 차원 및 측정값
- 메트릭, 조인, Explore와 같은 시맨틱 레이어 로직
- 실시간 ClickHouse 쿼리를 기반으로 하는 대시보드
Lightdash에서 메트릭과 차원 정의하기
Lightdash에서는 모든 메트릭과 차원을 dbt 모델.yml 파일에서 직접 정의합니다. 이렇게 하면 비즈니스 로직을 버전 관리할 수 있고, 일관성과 투명성도 확보됩니다.이를 YAML에 정의하면 팀 전체가 대시보드와 분석 전반에서 동일한 정의를 사용할 수 있습니다. 예를 들어
total_order_count, total_revenue, avg_order_value와 같은 재사용 가능한 메트릭을 dbt 모델 바로 옆에 만들 수 있으므로, UI에서 중복 정의할 필요가 없습니다.이러한 항목을 정의하는 방법을 자세히 알아보려면 다음 Lightdash 가이드를 참조하십시오.테이블에서 데이터 쿼리하기
dbt 프로젝트를 Lightdash에 연결하고 동기화하면 테이블(또는 “explores”)에서 직접 데이터를 탐색할 수 있습니다. 각 테이블은 하나의 dbt 모델을 나타내며, YAML에서 정의한 메트릭과 차원을 포함합니다.Explore 페이지는 5개의 주요 영역으로 구성됩니다.- 차원 및 메트릭 — 선택한 테이블에서 사용할 수 있는 모든 필드
- 필터 — 쿼리에서 반환되는 데이터를 제한합니다
- 차트 — 쿼리 결과를 시각화합니다
- 결과 — ClickHouse 데이터베이스에서 반환된 원시 데이터를 확인합니다
- SQL — 결과를 생성한 SQL 쿼리를 확인합니다
대시보드 만들기
데이터를 탐색하고 시각화를 저장한 후에는 이를 대시보드로 묶어 팀과 공유할 수 있습니다.Lightdash의 대시보드는 완전한 대화형 방식으로 동작하므로 필터를 적용하고, 탭을 추가하고, 실시간 ClickHouse 쿼리로 구동되는 차트를 볼 수 있습니다.또한 대시보드 내에서 바로 새 차트를 만들 수 있어 프로젝트를 체계적으로 정리하고 복잡함을 줄이는 데 도움이 됩니다. 이렇게 만든 차트는 해당 대시보드 전용이므로 프로젝트의 다른 곳에서는 재사용할 수 없습니다.대시보드 전용 차트를 만들려면 다음과 같이 하십시오:- Add tile을 클릭합니다
- New chart를 선택합니다
- 차트 빌더에서 시각화를 만듭니다
- 저장하면 대시보드 하단에 표시됩니다