> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.mintlify.site/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>;
};

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**를 클릭하십시오.

<Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/0yJtAU6cqYAQlCWC/images/_snippets/cloud-connect-button.webp?fit=max&auto=format&n=0yJtAU6cqYAQlCWC&q=85&s=2d1e2340e1ddccf3199ca1e41eeba836" size="md" alt="ClickHouse Cloud 서비스 연결 버튼" border width="998" height="932" data-path="images/_snippets/cloud-connect-button.webp" />

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

<Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/0yJtAU6cqYAQlCWC/images/_snippets/connection-details-https.webp?fit=max&auto=format&n=0yJtAU6cqYAQlCWC&q=85&s=2ea2af378046d5ec87ea8e78de573bc1" size="md" alt="ClickHouse Cloud HTTPS 연결 정보" border width="1320" height="1184" data-path="images/_snippets/connection-details-https.webp" />

자가 관리형 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-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/astrato_1_dataconnection.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=1a2af101f22999ee033bc1bca1f4e372" 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-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/astrato_2a_clickhouse_connection.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=dbff744b49fbfa725a8bcfc62d301bea" 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-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/astrato_2b_clickhouse_connection.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=d8971a974c731b6f263381a8a9baf5eb" 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-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/astrato_3_user_access.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=bc1dc42860404e191ef25cb2f95e7f6c" 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>

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

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/astrato_4a_clickhouse_data_view.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=64d9657d688749ca897151140346e996" 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-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/astrato_4b_clickhouse_data_view_joins.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=5f2d5cd3b8456c4c2dd30593530f187a" 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-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/astrato_4c_clickhouse_completed_data_view.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=8d91242e8c7b51a78ee725c5fffe8f45" 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-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/astrato_5a_clickhouse_build_chart.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=7212e47eaeae14ecca8303afd3dbe814" 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-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/astrato_5b_clickhouse_view_sql.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=1f2526888a40f99972beb3dbdbea7fbf" 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-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/astrato_5c_clickhouse_complete_dashboard.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=f3a840ead50d91dd68b42e3bf30f7fe8" alt="ClickHouse 사용자 액세스에 연결하는 Astrato" border width="1306" height="800" data-path="images/integrations/data-visualization/astrato_5c_clickhouse_complete_dashboard.webp" />
