Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

ClickHouse를 Holistics에 연결하기

View as MarkdownEdit this pageReport an issueSet up docs MCP
커뮤니티 유지 관리

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

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

사전 요구사항

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

  • 권한: 새 Data Sources를 추가하려면 Holistics에서 관리자여야 합니다.
  • 네트워크 액세스: Holistics의 IP 주소에서 ClickHouse 서버에 접속할 수 있어야 합니다.
  • 데이터베이스 사용자: 관리자 계정을 사용하는 대신 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에 연결하려면 다음 정보가 필요합니다:

매개변수 설명
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를 선택하면 이 정보를 확인할 수 있습니다.

ClickHouse Cloud 콘솔에서 Connect 버튼 위치

네트워크 액세스 구성

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

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

    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단계에서 수집한 정보로 양식을 작성하십시오.

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

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

    Holistics에서 ClickHouse 연결 테스트 성공

알려진 제한 사항

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

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

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

Navigation