ClickHouse를 Holistics에 연결하기

Holistics는 셀프서비스 BI와 임베디드 애널리틱스를 위한 AI 기반 플랫폼으로, 누구나 거버넌스가 적용된 손쉽게 활용할 수 있는 메트릭을 통해 더 나은 의사결정을 내리도록 돕습니다.

Holistics는 일관되고 신뢰할 수 있는 메트릭을 위한 프로그래밍 가능한 시맨틱 레이어를 제공하는 AI 네이티브 셀프서비스 BI 플랫폼입니다.

ClickHouse를 Holistics에 연결하면 팀은 코드 기반 시맨틱 레이어를 바탕으로 빠르고 안정적인 AI 기반 셀프서비스 환경을 활용할 수 있습니다. 비즈니스 사용자는 드래그 앤 드롭과 AI를 통해 데이터를 자신 있게 탐색할 수 있으며, 메트릭 정의는 Git에서 재사용 가능하고 조합 가능하며 버전 관리되도록 유지할 수 있습니다.

​

사전 요구사항

연결하기 전에 다음 사항을 확인하십시오:

• 권한: 새 Data Sources를 추가하려면 Holistics에서 관리자여야 합니다.
• 네트워크 액세스: Holistics의 IP 주소에서 ClickHouse 서버에 접속할 수 있어야 합니다.
• 데이터베이스 사용자: 관리자 계정을 사용하는 대신 Holistics 전용 읽기 전용 사용자를 생성하십시오.

​

권장 권한

전용 사용자는 쿼리할 테이블과 system 테이블(스키마 감지용)에 대한 SELECT 권한이 필요합니다.

-- 예시: 특정 데이터베이스에 읽기 권한 부여
GRANT SELECT ON my_database.* TO holistics_user;

-- 시스템 메타데이터 접근 권한 부여
GRANT SELECT ON system.* TO holistics_user;

1. ​

   연결 정보 수집

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

   매개변수	설명
   Host	ClickHouse 서버의 호스트명(예: mz322.eu-central-1.aws.clickhouse.cloud)입니다.
   Port	ClickHouse Cloud(SSL/TLS)의 경우 8443입니다. SSL이 없는 자가 관리형 인스턴스의 경우 8123입니다.
   Database Name	연결할 데이터베이스의 이름입니다. 기본값은 일반적으로 default입니다.
   Username	데이터베이스 사용자 이름입니다. 기본값은 default입니다.
   Password	데이터베이스 사용자의 비밀번호입니다.

   ClickHouse Cloud 콘솔에서 Connect 버튼을 클릭한 다음 HTTPS를 선택하면 이 정보를 확인할 수 있습니다.

2. ​

   네트워크 액세스 구성

   Holistics는 클라우드 기반 애플리케이션이므로 Holistics 서버에서 데이터베이스에 연결할 수 있어야 합니다. 사용할 수 있는 옵션은 2가지입니다:

   1. 직접 연결(권장): 방화벽 또는 ClickHouse Cloud IP 액세스 목록에 Holistics’ IP 주소를 허용 목록에 추가하십시오. IP 목록은 IP Whitelisting guide에서 확인할 수 있습니다.

   2. Reverse SSH Tunnel: 데이터베이스가 비공개 네트워크(VPC)에 있어 공개적으로 노출할 수 없는 경우 Reverse SSH Tunnel을 사용하십시오.

3. ​

   Holistics에 데이터 소스 추가

   1. Holistics에서 Settings → Data Sources로 이동하십시오.

   2. New Data Source를 클릭하고 ClickHouse를 선택하십시오.

   3. 1단계에서 수집한 정보로 양식을 작성하십시오.

      필드	설정
      Host	ClickHouse 호스트명
      Port	8443 (또는 8123)
      Require SSL	8443 포트를 사용하는 경우 ON으로 설정합니다(ClickHouse Cloud에서는 필수).
      Database Name	default (또는 사용 중인 특정 DB)

   4. Test Connection을 클릭하십시오.

      • 성공: Save를 클릭하십시오.
      • 실패: 사용자 이름/비밀번호를 확인하고 Holistics IP가 허용 목록에 추가되어 있는지 확인하십시오.

​

알려진 제한 사항

Holistics는 ClickHouse의 대부분의 표준 SQL 기능을 지원하지만, 다음과 같은 예외가 있습니다:

• Running Total: 이 분석 함수는 현재 ClickHouse에서 제한적으로만 지원됩니다.
• 중첩된 데이터 타입: 여러 단계로 중첩된 JSON 또는 배열(Array) 구조는 시각화 전에 SQL 모델을 통해 평탄화해야 할 수 있습니다.

지원되는 기능의 전체 목록은 데이터베이스별 제한 사항 페이지를 참조하십시오.