본문으로 바로가기
본문으로 바로가기

ClickHouse를 Holistics에 연결하기

Community Maintained

Holistics는 일관되고 신뢰할 수 있는 지표를 위한 프로그래머블 시맨틱 레이어를 제공하는 AI 네이티브 셀프 서비스 BI 플랫폼입니다.

ClickHouse를 Holistics에 연결하면 팀은 코드 기반 시맨틱 레이어를 토대로 한 빠르고 신뢰할 수 있는 AI 기반 셀프 서비스 경험을 제공받을 수 있습니다. 비즈니스 사용자는 드래그 앤 드롭 기능과 AI를 통해 데이터를 자신 있게 탐색할 수 있으며, 메트릭 정의는 Git에서 재사용 가능하고 조합 가능하며 버전 관리된 상태로 유지됩니다.

사전 준비 사항​

연결하기 전에 다음 사항을 갖추었는지 확인하십시오.

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

전용 사용자에게는 쿼리하려는 테이블과 스키마 자동 감지를 위한 system 테이블에 대한 SELECT 권한이 있어야 합니다.

-- Example: Grant read access to a specific database
GRANT SELECT ON my_database.* TO holistics_user;

-- Grant access to system metadata
GRANT SELECT ON system.* TO holistics_user;

연결 정보 수집​

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

ParameterDescription
HostClickHouse 서버의 호스트 이름 (예: mz322.eu-central-1.aws.clickhouse.cloud).
PortClickHouse Cloud의 경우 8443 (SSL/TLS), SSL 없이 자가 관리형 인스턴스를 사용하는 경우 8123.
Database Name연결하려는 데이터베이스의 이름. 기본값은 일반적으로 default입니다.
Username데이터베이스 사용자. 기본값은 default입니다.
Password데이터베이스 사용자의 비밀번호.

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

ClickHouse Cloud 콘솔에서 Connect 버튼의 위치

네트워크 액세스 구성​

Holistics는 클라우드 기반 애플리케이션이므로 Holistics 서버가 데이터베이스에 접속할 수 있어야 합니다. 다음 두 가지 옵션이 있습니다:

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

    ClickHouse Cloud에서 IP 허용 목록을 설정하는 예시

  2. Reverse SSH Tunnel: 데이터베이스가 프라이빗 네트워크(VPC)에 있고 퍼블릭으로 노출할 수 없는 경우 Reverse SSH Tunnel을 사용하십시오.

Holistics에서 데이터 소스 추가​

  1. Holistics에서 Settings → Data Sources로 이동합니다.

    Holistics 설정에서 Data Sources로 이동하는 화면

  2. New Data Source를 클릭하고 ClickHouse를 선택합니다.

    새 데이터 소스 목록에서 ClickHouse를 선택하는 화면

  3. 1단계에서 수집한 정보로 양식을 채웁니다.

    FieldSetting
    HostClickHouse 호스트 이름
    Port8443 (또는 8123)
    Require SSL포트 8443을 사용하는 경우 ON으로 설정 (ClickHouse Cloud에서는 필수).
    Database Namedefault (또는 사용하는 특정 DB)
    Holistics에서 ClickHouse 연결 정보를 입력하는 화면

  4. Test Connection을 클릭합니다.

    Holistics에서 ClickHouse 연결 테스트가 성공한 화면

알려진 제한 사항​

Holistics는 ClickHouse에서 표준 SQL 기능 대부분을 지원하지만, 다음 기능은 예외입니다:

  • Running Total: 이 분석 FUNCTION은 현재 ClickHouse에서 제한적으로만 지원됩니다.
  • 중첩 데이터 타입: 깊이 중첩된 JSON 또는 Array 구조는 시각화 전에 SQL 모델을 통해 평탄화 작업이 필요할 수 있습니다.

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