> ## 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.

> Confluent Cloud에서 완전 관리형 ClickHouse Connector Sink를 사용하는 가이드

# Confluent Cloud와 ClickHouse 통합

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>;
};

<div class="vimeo-container">
  <Frame>
    <iframe
      src="//www.youtube.com/embed/SQAiPVbd3gg"
      frameborder="0"
      allow="autoplay;
fullscreen;
picture-in-picture"
      allowfullscreen
    />
  </Frame>
</div>

<div id="prerequisites">
  ## 사전 준비 사항
</div>

다음에 익숙하다고 가정합니다:

* [ClickHouse Connector Sink](/docs/ko/integrations/connectors/data-ingestion/kafka/kafka-clickhouse-connect-sink)
* Confluent Cloud

<div id="the-official-kafka-connector-from-clickhouse-with-confluent-cloud">
  ## Confluent Cloud용 ClickHouse 공식 Kafka Connector
</div>

<div id="create-a-topic">
  #### 토픽 생성
</div>

Confluent Cloud에서 토픽을 생성하는 것은 비교적 간단하며, 자세한 안내는 [여기](https://docs.confluent.io/cloud/current/client-apps/topics/manage.html)에서 확인할 수 있습니다.

<div id="important-notes">
  #### 중요 참고 사항
</div>

* Kafka 토픽 이름은 ClickHouse 테이블 이름과 동일해야 합니다. 이를 변경하려면 변환기(transformer)를 사용하면 됩니다(예: [`ExtractTopic`](https://docs.confluent.io/platform/current/connect/transforms/extracttopic.html)).
* 파티션이 더 많다고 해서 항상 성능이 더 좋아지는 것은 아닙니다. 자세한 내용과 성능 최적화 팁은 곧 공개될 가이드를 참조하십시오.

<div id="gather-your-connection-details">
  #### 연결 정보 준비
</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="install-connector">
  #### 커넥터 설치
</div>

[공식 문서](https://docs.confluent.io/cloud/current/connectors/cc-clickhouse-sink-connector/cc-clickhouse-sink.html)를 따라 Confluent Cloud에서 완전 관리형 ClickHouse 싱크 커넥터를 설치하십시오.

<div id="configure-the-connector">
  #### 커넥터 구성
</div>

ClickHouse 싱크 커넥터를 구성할 때는 다음 정보를 제공해야 합니다:

* ClickHouse 서버의 호스트명
* ClickHouse 서버의 포트(기본값: 8443)
* ClickHouse 서버의 사용자 이름과 비밀번호
* 데이터가 기록될 ClickHouse 데이터베이스 이름
* ClickHouse에 데이터를 기록하는 데 사용할 Kafka 토픽 이름

Confluent Cloud UI는 성능 최적화를 위해 폴링 주기, 배치 크기 및 기타 매개변수를 조정할 수 있는 고급 구성 옵션을 지원합니다.

<Note>
  Confluent Cloud에서는 [fetch settings](/docs/ko/integrations/connectors/data-ingestion/kafka/kafka-clickhouse-connect-sink#fetch-settings) 및 [poll settings](/docs/ko/integrations/connectors/data-ingestion/kafka/kafka-clickhouse-connect-sink#poll-settings)와 같은 일부 설정을 조정하려면 Confluent Cloud를 통해 지원 요청을 열어야 합니다.
</Note>

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

* [공식 문서의 connector 제한 사항 목록](https://docs.confluent.io/cloud/current/connectors/cc-clickhouse-sink-connector/cc-clickhouse-sink.html#limitations)을 확인하십시오