Skip to main content

​
1. ClickHouse 연결 설정

ClickHouse에 연결하려면 Connections 페이지로 이동한 다음 New Connection을 선택하고, New Connection 모달에서 ClickHouse를 선택하십시오. 그러면 host, username, password를 입력하라는 메시지가 표시됩니다.
  • Host: ClickHouse 데이터베이스가 노출된 호스트입니다. 데이터를 wire 상에서 안전하게 전송하기 위해 여기서는 https만 허용됩니다. host URL은 다음 구조를 따라야 합니다: https://url-to-clickhouse-db:port/database 기본적으로 플러그인은 ‘default’ 데이터베이스와 443 포트에 연결됩니다. ’/’ 뒤에 데이터베이스를 지정하면 연결할 데이터베이스를 구성할 수 있습니다.
  • Username: ClickHouse 클러스터에 연결할 때 사용할 사용자 이름입니다.
  • Password: ClickHouse 클러스터에 연결할 때 사용할 비밀번호입니다.
API를 통해 ClickHouse 연결을 생성하는 방법은 개발자 문서의 예시를 참조하십시오.

​
2. 데이터셋 추가

ClickHouse를 연결한 후에는 여기에 설명된 대로 데이터셋을 추가할 수 있습니다. ClickHouse에서 사용할 수 있는 데이터셋을 하나 이상 선택한 다음, Luzmo에서 이를 연결해 하나의 대시보드에서 함께 사용할 수 있도록 하십시오. 또한 분석용 데이터 준비하기 문서도 확인해 보십시오. API를 사용해 데이터셋을 추가하는 방법은 개발자 문서의 이 예시를 참조하십시오. 이제 데이터셋을 활용해 보기 좋은 (임베디드) 대시보드를 만들거나, 고객의 질문에 답할 수 있는 AI 데이터 분석가(Luzmo IQ)를 구동할 수도 있습니다.

​
사용 시 참고 사항

  1. Luzmo ClickHouse 커넥터는 연결에 HTTP API 인터페이스(일반적으로 8123 포트에서 실행됨)를 사용합니다.
  2. Distributed 테이블 엔진을 사용하는 테이블을 사용할 때 distributed_product_mode가 deny로 설정되어 있으면 일부 Luzmo 차트가 작동하지 않을 수 있습니다. 다만 이는 테이블을 다른 테이블에 연결하고, 그 연결을 차트에서 사용할 때만 발생합니다. 이 경우 ClickHouse 클러스터에서 distributed_product_mode를 환경에 맞는 다른 옵션으로 설정하십시오. ClickHouse Cloud를 사용하는 경우 이 설정은 무시해도 됩니다.
  3. 예를 들어 Luzmo 애플리케이션만 ClickHouse 인스턴스에 접근할 수 있도록 하려면 Luzmo의 고정 IP 주소 범위를 허용 목록에 추가하는 것을 강력히 권장합니다. 또한 서비스용 읽기 전용 사용자 계정을 사용하는 것도 권장합니다.
  4. ClickHouse 커넥터는 현재 다음 데이터 타입을 지원합니다.
마지막 수정일 2026년 7월 3일