ClickHouse를 Hashboard에 연결하기
Community Maintained
Hashboard는 조직 내 누구나 메트릭을 추적하고 실행 가능한 인사이트를 도출할 수 있도록 해 주는 대화형 데이터 탐색 도구입니다. Hashboard는 ClickHouse 데이터베이스에 실시간으로 SQL 쿼리를 전송하며, 특히 셀프 서비스(self-serve) 및 애드혹(ad hoc) 데이터 탐색 사례에 유용합니다.
이 가이드는 Hashboard를 ClickHouse 인스턴스에 연결하는 방법을 단계별로 설명합니다. 이 정보는 Hashboard의 ClickHouse 통합 문서에서도 확인할 수 있습니다.
사전 준비 사항
- 자체 인프라 환경 또는 ClickHouse Cloud에서 호스팅되는 ClickHouse 데이터베이스.
- Hashboard 계정과 프로젝트.
Hashboard를 ClickHouse에 연결하는 절차
1. 연결 정보를 준비합니다
네이티브 TCP를 사용해 ClickHouse에 연결하려면 다음 정보가 필요합니다:
| Parameter(s) | Description |
|---|---|
HOST and PORT | 일반적으로 TLS를 사용하는 경우 포트는 9440, TLS를 사용하지 않는 경우 포트는 9000입니다. |
DATABASE NAME | 기본적으로 default라는 데이터베이스가 있습니다. 연결하려는 데이터베이스의 이름을 사용합니다. |
USERNAME and PASSWORD | 기본적으로 사용자 이름은 default입니다. 사용 사례에 적합한 사용자 이름을 사용합니다. |
ClickHouse Cloud 서비스에 대한 세부 정보는 ClickHouse Cloud 콘솔에서 확인할 수 있습니다. 연결할 서비스를 선택한 후 Connect를 클릭합니다:
Native를 선택하면 예시 clickhouse-client 명령에서 세부 정보를 확인할 수 있습니다.
자가 관리형 ClickHouse를 사용하는 경우 연결 세부 정보는 ClickHouse 관리자가 설정합니다.
2. Hashboard에서 새 데이터베이스 연결 추가
- Hashboard 프로젝트로 이동합니다.
- 사이드 내비게이션 바의 톱니바퀴 아이콘을 클릭하여 Settings 페이지를 엽니다.
+ New Database Connection을 클릭합니다.- 모달에서 "ClickHouse"를 선택합니다.
- 앞에서 확인한 정보를 사용하여 Connection Name, Host, Port, Username, Password, Database 필드를 채웁니다.
- "Test"를 클릭하여 연결이 정상적으로 구성되었는지 확인합니다.
- "Add"를 클릭합니다.
이제 ClickHouse 데이터베이스가 Hashboard에 연결되었으므로, Data Models, Explorations, Metrics, Dashboards를 생성하여 계속 진행할 수 있습니다. 이러한 기능에 대한 자세한 내용은 해당 Hashboard 문서를 참고하십시오.
더 알아보기
고급 기능 및 문제 해결 방법에 대해서는 Hashboard 문서를 참조하십시오.
