ClickHouse와 Luzmo 통합

Community Maintained

1. ClickHouse 연결 설정

ClickHouse에 연결하려면 Connections page로 이동한 후 New Connection을 선택하고, 표시되는 New Connection 모달에서 ClickHouse를 선택합니다.

host, username, password를 입력해야 합니다:

• Host: ClickHouse 데이터베이스가 외부에 노출된 호스트입니다. 전송 중 데이터를 안전하게 보호하기 위해 이 값은 https만 허용됩니다. host URL의 형식은 https://url-to-clickhouse-db:port/database여야 합니다. 기본적으로 플러그인은 'default' 데이터베이스와 443 포트에 연결합니다. '/' 뒤에 데이터베이스 이름을 지정하면 어느 데이터베이스에 연결할지 설정할 수 있습니다.
• Username: ClickHouse 클러스터에 연결할 때 사용할 사용자 이름입니다.
• Password: ClickHouse 클러스터에 연결할 때 사용할 비밀번호입니다.

API를 통해 ClickHouse에 대한 연결을 생성하는 방법은 개발자 문서의 예제를 참고하십시오.

2. 데이터셋 추가

ClickHouse 연결을 마쳤다면, 여기에 설명된 방법대로 데이터셋을 추가할 수 있습니다. ClickHouse에 있는 하나 이상의 데이터셋을 선택한 뒤 Luzmo에서 이를 연결하여 대시보드에서 함께 사용할 수 있도록 하십시오. 또한 분석을 위한 데이터 준비에 관한 이 문서도 꼭 확인하십시오.

API를 사용해 데이터셋을 추가하는 방법은 개발자 문서의 이 예시를 참고하십시오.

이제 데이터셋을 사용해 고급스러운 (임베디드) 대시보드를 구성하거나, 고객의 질문에 답변할 수 있는 AI Data Analyst(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 주소 범위를 허용 목록(whitelist)에 추가할 것을 강력히 권장합니다. 또한 전용 읽기 전용 사용자 계정을 사용하는 것도 권장합니다.

4. ClickHouse 커넥터는 현재 다음 데이터 타입을 지원합니다:

   ClickHouse Type	Luzmo Type
   UInt	numeric
   Int	numeric
   Float	numeric
   Decimal	numeric
   Date	datetime
   DateTime	datetime
   String	hierarchy
   Enum	hierarchy
   FixedString	hierarchy
   UUID	hierarchy
   Bool	hierarchy