> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> Astrato는 모든 사용자가 분석을 직접 활용할 수 있도록 지원하여 기업과 데이터 비즈니스에 진정한 셀프서비스 BI를 제공합니다. 이를 통해 IT의 도움 없이도 직접 대시보드, 보고서, 데이터 앱을 만들고 데이터 관련 질문에 답할 수 있습니다. Astrato는 도입을 가속화하고 의사결정 속도를 높이며, 분석, 임베디드 애널리틱스, 데이터 입력, 데이터 앱을 하나의 플랫폼으로 통합합니다. 또한 액션과 분석을 하나로 결합하고, 실시간 write-back을 지원하며, ML 모델과 상호작용하고, AI를 활용해 분석을 가속화할 수 있도록 합니다. Astrato의 pushdown SQL 지원을 통해 단순한 대시보드를 넘어설 수 있습니다.

# Astrato를 ClickHouse에 연결하기

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 = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

<CommunityMaintainedBadge />

Astrato는 Pushdown SQL을 사용해 ClickHouse Cloud 또는 온프레미스 배포 환경을 직접 쿼리합니다. 이를 통해 업계 최고 수준의 ClickHouse 성능을 바탕으로 필요한 모든 데이터에 액세스할 수 있습니다.

<div id="connection-data-required">
  ## 필요한 연결 정보
</div>

데이터 연결을 설정하려면 다음 정보가 필요합니다:

* 데이터 연결: 호스트명, 포트

* 데이터베이스 자격 증명: 사용자 이름, 비밀번호

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

| 매개변수                      | 설명                                                         |
| ------------------------- | ---------------------------------------------------------- |
| `HOST` and `PORT`         | 일반적으로 TLS를 사용하는 경우 포트는 8443, TLS를 사용하지 않는 경우 8123입니다.      |
| `DATABASE NAME`           | 기본적으로 `default`라는 이름의 데이터베이스가 제공되며, 연결할 데이터베이스 이름을 사용하십시오. |
| `USERNAME` and `PASSWORD` | 기본 사용자 이름은 `default`입니다. 사용 사례에 맞는 사용자 이름을 사용하십시오.         |

ClickHouse Cloud 서비스의 연결 정보는 ClickHouse Cloud 콘솔에서 확인할 수 있습니다.
서비스를 선택한 다음 **Connect**를 클릭하십시오.

<div className="ch-image-md">
  <Frame>
    <img src="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/cloud-connect-button.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=ec0a298a33ca841e947fa5e8bae47362" alt="ClickHouse Cloud 서비스 연결 버튼" width="998" height="932" data-path="images/_snippets/cloud-connect-button.webp" />
  </Frame>
</div>

**HTTPS**를 선택하십시오. 연결 정보가 예시 `curl` 명령으로 표시됩니다.

<div className="ch-image-md">
  <Frame>
    <img src="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/connection-details-https.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=cb0fbd98aa2b5b7ca484c9f53395ee07" alt="ClickHouse Cloud HTTPS 연결 정보" width="1320" height="1184" data-path="images/_snippets/connection-details-https.webp" />
  </Frame>
</div>

자가 관리형 ClickHouse를 사용하는 경우 연결 정보는 ClickHouse 관리자가 설정합니다.

<div id="creating-the-data-connection-to-clickhouse">
  ## ClickHouse용 데이터 연결 만들기
</div>

* 사이드바에서 **Data**를 선택한 다음 **Data Connection** 탭을 선택합니다
  (또는 다음 링크로 이동합니다: [https://app.astrato.io/data/sources](https://app.astrato.io/data/sources))
  ​
* 화면 오른쪽 상단의 **New Data Connection** 버튼을 클릭합니다.

<Image size="sm" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_1_dataconnection.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=806b01cd8d8ae2b482f28368b3e28317" alt="Astrato 데이터 연결" border width="396" height="165" data-path="images/integrations/data-visualization/astrato_1_dataconnection.webp" />

* **ClickHouse**를 선택합니다.

<Image size="sm" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_2a_clickhouse_connection.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=91feeabc20a7665402c8382934173ae9" alt="Astrato ClickHouse 데이터 연결" border width="235" height="164" data-path="images/integrations/data-visualization/astrato_2a_clickhouse_connection.webp" />

* 연결 대화상자에서 필수 필드를 입력합니다

<Image size="sm" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_2b_clickhouse_connection.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=9926d9a8ec14e804e428a7d33ea53502" alt="Astrato에서 ClickHouse에 연결하기 위한 필수 필드" border width="486" height="601" data-path="images/integrations/data-visualization/astrato_2b_clickhouse_connection.webp" />

* **Test Connection**을 클릭합니다. 연결이 성공하면 데이터 연결의 **name**을 입력하고 **Next**를 클릭합니다.

* 데이터 연결의 **사용자 액세스**를 설정한 다음 **connect**를 클릭합니다.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_3_user_access.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=59617eb5f2eaa17d07552ae3b142b78a" alt="Astrato에서 ClickHouse 사용자 액세스 연결" border width="1973" height="1651" data-path="images/integrations/data-visualization/astrato_3_user_access.webp" />

* 연결이 생성되고 데이터 뷰도 생성됩니다.

<Note>
  중복 항목이 생성되면 데이터 소스 이름에 타임스탬프가 추가됩니다.
</Note>

<div id="creating-a-semantic-model--data-view">
  ## 시맨틱 모델 / 데이터 뷰 만들기
</div>

데이터 뷰 편집기에서는 ClickHouse의 모든 테이블과 스키마를 확인할 수 있습니다. 시작하려면 몇 개를 선택하십시오.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_4a_clickhouse_data_view.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=398fe1932fc832d619799aa0d379b5b2" alt="Astrato가 ClickHouse 사용자 액세스에 연결" border width="1210" height="671" data-path="images/integrations/data-visualization/astrato_4a_clickhouse_data_view.webp" />

이제 데이터를 선택했으므로 **데이터 뷰**를 정의할 차례입니다. 웹페이지 오른쪽 상단의 Define을 클릭하십시오.

여기에서는 데이터를 조인할 수 있을 뿐 아니라 **관리되는 차원과 측정값을 생성**할 수도 있습니다. 이는 여러 팀에서 비즈니스 로직의 일관성을 높이는 데 적합합니다.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_4b_clickhouse_data_view_joins.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=879a1a1ebc0e1c1f230e35f5ae844043" alt="Astrato가 ClickHouse 사용자 액세스에 연결" border width="1208" height="669" data-path="images/integrations/data-visualization/astrato_4b_clickhouse_data_view_joins.webp" />

**Astrato는 메타데이터를 기반으로 조인을 지능적으로 제안합니다.** 여기에는 ClickHouse의 키를 활용하는 것도 포함됩니다. 제안된 조인을 사용하면 잘 관리되는 ClickHouse 데이터를 바탕으로 처음부터 다시 만들 필요 없이 쉽게 시작할 수 있습니다. 또한 **조인 품질**도 표시하므로 Astrato의 모든 제안을 자세히 검토할 수 있습니다.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_4c_clickhouse_completed_data_view.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=33668dda643494290403bf9ec908081f" alt="Astrato가 ClickHouse 사용자 액세스에 연결" border width="1210" height="672" data-path="images/integrations/data-visualization/astrato_4c_clickhouse_completed_data_view.webp" />

<div id="creating-a-dashboard">
  ## 대시보드 만들기
</div>

몇 단계만으로 Astrato에서 첫 번째 차트를 만들 수 있습니다.

1. Visuals 패널을 엽니다
2. 시각화를 선택합니다(먼저 Column Bar Chart를 선택합니다)
3. 차원을 추가합니다
4. 측정값을 추가합니다

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_5a_clickhouse_build_chart.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=08a51bb303040f0f31692ec7fc11be71" alt="Astrato를 ClickHouse 사용자 액세스에 연결" border width="1215" height="675" data-path="images/integrations/data-visualization/astrato_5a_clickhouse_build_chart.webp" />

<div id="view-generated-sql-supporting-each-visualization">
  ### 각 시각화를 지원하는 생성된 SQL 보기
</div>

투명성과 정확성은 Astrato의 핵심 가치입니다. 생성된 모든 쿼리를 확인할 수 있으므로 전체 제어를 유지할 수 있습니다. 모든 컴퓨트는 ClickHouse에서 직접 실행되며, 강력한 보안과 거버넌스를 유지하면서 ClickHouse의 속도를 활용합니다.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_5b_clickhouse_view_sql.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=a1f85efb08f5bbf55285658e7cedd93c" alt="Astrato를 ClickHouse 사용자 액세스에 연결" border width="1215" height="675" data-path="images/integrations/data-visualization/astrato_5b_clickhouse_view_sql.webp" />

<div id="example-completed-dashboard">
  ### 완성된 대시보드 예시
</div>

이제 아름답고 완성도 높은 대시보드나 데이터 앱을 바로 구현할 수 있습니다. 구축한 결과물을 더 보려면 웹사이트의 데모 갤러리를 방문하십시오. [https://astrato.io/gallery](https://astrato.io/gallery)

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_5c_clickhouse_complete_dashboard.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=49402b740a457b5c97f0aa3e0236678f" alt="ClickHouse 사용자 액세스에 연결하는 Astrato" border width="1306" height="800" data-path="images/integrations/data-visualization/astrato_5c_clickhouse_complete_dashboard.webp" />
