사전 요구 사항
- ClickHouse Connector Sink
- Confluent Cloud 및 Custom Connectors.
이 페이지에서는 커넥터를 Confluent Cloud에 직접 업로드하는 방법을 다룹니다. 특정 커넥터 버전이나 사용자 지정 설정이 필요하지 않다면 완전 관리형 커넥터를 사용하는 것이 설정이 더 간단합니다.
Custom Connector로 사용하는 ClickHouse 공식 Kafka Connector
Custom Connector로 설치하기
토픽 생성
중요 참고 사항
- Kafka 토픽 이름은 ClickHouse 테이블 이름과 같아야 합니다. 이 값은 변환기(transformer)를 사용해 조정할 수 있습니다(예:
ExtractTopic). - 파티션이 더 많다고 해서 항상 성능이 더 좋아지는 것은 아닙니다. 자세한 내용과 성능 관련 팁은 곧 공개될 가이드를 참조하십시오.
커넥터 설치
커넥터는 리포지토리에서 다운로드할 수 있습니다. 의견과 이슈도 그곳에 자유롭게 남겨 주십시오! “Connector Plugins” -> “Add plugin”으로 이동한 다음, 아래 설정을 사용하십시오:연결 정보를 확인합니다
ClickHouse Cloud 서비스의 연결 정보는 ClickHouse Cloud 콘솔에서 확인할 수 있습니다.
서비스를 선택한 다음 Connect를 클릭하십시오.

curl 명령으로 표시됩니다.

커넥터 설정
Connectors -> Add Connector로 이동한 다음, 다음 설정을 사용하십시오(값은 예시일 뿐입니다):
연결 엔드포인트 지정
u57swl97we.eu-west-1.aws.clickhouse.com:8443
HTTP(S) 포트를 지정해야 합니다. 커넥터는 아직 Native protocol을 지원하지 않습니다.
알려진 제한 사항
- Custom Connectors는 공용 인터넷 엔드포인트를 사용해야 합니다. 고정 IP 주소는 지원되지 않습니다.
- 일부 Custom Connector 속성은 재정의할 수 있습니다. 전체 목록은 공식 문서의 목록을 참조하십시오.
- Custom Connectors는 일부 AWS 리전에서만 사용할 수 있습니다.
- 공식 문서의 Custom Connectors 제한 사항 목록을 참조하십시오.