사전 준비 사항
다음에 익숙하다고 가정합니다:
- ClickHouse Connector Sink
- Confluent Cloud
Confluent Cloud용 ClickHouse 공식 Kafka Connector
토픽 생성
Confluent Cloud에서 토픽을 생성하는 것은 비교적 간단하며, 자세한 안내는 여기에서 확인할 수 있습니다.
중요 참고 사항
- Kafka 토픽 이름은 ClickHouse 테이블 이름과 동일해야 합니다. 이를 변경하려면 변환기(transformer)를 사용하면 됩니다(예:
ExtractTopic). - 파티션이 더 많다고 해서 항상 성능이 더 좋아지는 것은 아닙니다. 자세한 내용과 성능 최적화 팁은 곧 공개될 가이드를 참조하십시오.
연결 정보 준비
HTTP(S)로 ClickHouse에 연결하려면 다음 정보가 필요합니다.
| 매개변수 | 설명 |
|---|---|
HOST and PORT |
일반적으로 TLS를 사용하는 경우 포트는 8443, TLS를 사용하지 않는 경우 8123입니다. |
DATABASE NAME |
기본적으로 default라는 이름의 데이터베이스가 제공되며, 연결할 데이터베이스 이름을 사용하십시오. |
USERNAME and PASSWORD |
기본 사용자 이름은 default입니다. 사용 사례에 맞는 사용자 이름을 사용하십시오. |
ClickHouse Cloud 서비스의 연결 정보는 ClickHouse Cloud 콘솔에서 확인할 수 있습니다. 서비스를 선택한 다음 Connect를 클릭하십시오.

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

자가 관리형 ClickHouse를 사용하는 경우 연결 정보는 ClickHouse 관리자가 설정합니다.
커넥터 설치
공식 문서를 따라 Confluent Cloud에서 완전 관리형 ClickHouse 싱크 커넥터를 설치하십시오.
커넥터 구성
ClickHouse 싱크 커넥터를 구성할 때는 다음 정보를 제공해야 합니다:
- ClickHouse 서버의 호스트명
- ClickHouse 서버의 포트(기본값: 8443)
- ClickHouse 서버의 사용자 이름과 비밀번호
- 데이터가 기록될 ClickHouse 데이터베이스 이름
- ClickHouse에 데이터를 기록하는 데 사용할 Kafka 토픽 이름
Confluent Cloud UI는 성능 최적화를 위해 폴링 주기, 배치 크기 및 기타 매개변수를 조정할 수 있는 고급 구성 옵션을 지원합니다.
알려진 제한 사항
- 공식 문서의 connector 제한 사항 목록을 확인하십시오