> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-a804b3ad.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

# ClickHouse를 Holistics에 연결하기

export const CommunityMaintainedBadge = () => {
  return <div className="CommunityMaintainedBadge">
            <div className="CommunityMaintainedIcon">
            <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" fill="currentColor" viewBox="0 0 256 256">
                <path d="M244.8,150.4a8,8,0,0,1-11.2-1.6A51.6,51.6,0,0,0,192,128a8,8,0,0,1-7.37-4.89,8,8,0,0,1,0-6.22A8,8,0,0,1,192,112a24,24,0,1,0-23.24-30,8,8,0,1,1-15.5-4A40,40,0,1,1,219,117.51a67.94,67.94,0,0,1,27.43,21.68A8,8,0,0,1,244.8,150.4ZM190.92,212a8,8,0,1,1-13.84,8,57,57,0,0,0-98.16,0,8,8,0,1,1-13.84-8,72.06,72.06,0,0,1,33.74-29.92,48,48,0,1,1,58.36,0A72.06,72.06,0,0,1,190.92,212ZM128,176a32,32,0,1,0-32-32A32,32,0,0,0,128,176ZM72,120a8,8,0,0,0-8-8A24,24,0,1,1,87.24,82a8,8,0,1,0,15.5-4A40,40,0,1,0,37,117.51,67.94,67.94,0,0,0,9.6,139.19a8,8,0,1,0,12.8,9.61A51.6,51.6,0,0,1,64,128,8,8,0,0,0,72,120Z"></path>
            </svg>
        </div>
            커뮤니티에서 관리
        </div>;
};

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

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

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

<div id="prerequisites">
  ## 사전 요구사항
</div>

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

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

<div id="recommended-privileges">
  ### 권장 권한
</div>

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

```sql theme={null}
-- 예시: 특정 데이터베이스에 읽기 권한 부여
GRANT SELECT ON my_database.* TO holistics_user;

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

<Steps>
  <Step>
    ## 연결 정보 수집

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

    <Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/holistics_01.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=0c06dbff3e7942d884733153690e44ee" alt="ClickHouse Cloud 콘솔에서 Connect 버튼 위치" border width="998" height="932" data-path="images/integrations/data-visualization/holistics_01.png" />
  </Step>

  <Step>
    ## 네트워크 액세스 구성

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

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

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/holistics_02.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=bf29f476300a4cc7bea4d2ed9378cd9d" alt="ClickHouse Cloud에서 IP 허용 목록 추가 예시" border width="1651" height="1131" data-path="images/integrations/data-visualization/holistics_02.png" />

    2. **Reverse SSH Tunnel:** 데이터베이스가 비공개 네트워크(VPC)에 있어 공개적으로 노출할 수 없는 경우 [Reverse SSH Tunnel](https://docs.holistics.io/docs/connect/connect-tunnel)을 사용하십시오.
  </Step>

  <Step>
    ## Holistics에 데이터 소스 추가

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

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/holistics_03.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=eadd91bf45f4b47ff729fced63b404a2" alt="Holistics 설정에서 Data Sources로 이동" border width="1647" height="1129" data-path="images/integrations/data-visualization/holistics_03.png" />

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

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/holistics_04.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=31c0776f61389300fddc4ba5eb652522" alt="새 데이터 소스 목록에서 ClickHouse 선택" border width="1651" height="1131" data-path="images/integrations/data-visualization/holistics_04.png" />

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

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

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/holistics_05.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=0b762c683d9966ccb59805c50af8928e" alt="Holistics에서 ClickHouse 연결 정보 입력" border width="1651" height="1131" data-path="images/integrations/data-visualization/holistics_05.png" />

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

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99-mintlify-a804b3ad/P3SyKDuwIqPWegWb/images/integrations/data-visualization/holistics_06.png?fit=max&auto=format&n=P3SyKDuwIqPWegWb&q=85&s=cd464cf9d7f72ba1bcc30c495434d7c1" alt="Holistics에서 ClickHouse 연결 테스트 성공" border width="1651" height="1131" data-path="images/integrations/data-visualization/holistics_06.png" />

       * **성공:** **Save**를 클릭하십시오.
       * **실패:** 사용자 이름/비밀번호를 확인하고 [Holistics IP가 허용 목록에 추가되어 있는지](https://docs.holistics.io/docs/connect/ip-whitelisting) 확인하십시오.
  </Step>
</Steps>

<div id="known-limitations">
  ## 알려진 제한 사항
</div>

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

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

지원되는 기능의 전체 목록은 [데이터베이스별 제한 사항 페이지](https://docs.holistics.io/docs/connect/faqs/clickhouse-limitations)를 참조하십시오.