메인 콘텐츠로 건너뛰기

​
소개

ClickPipes는 몇 번의 클릭만으로 다양한 데이터 소스에서 데이터를 수집할 수 있도록 해주는 관리형 통합 플랫폼입니다. 가장 까다로운 워크로드를 위해 설계된 ClickPipes의 견고하고 확장 가능한 아키텍처는 일관된 성능과 안정성을 보장합니다. ClickPipes는 장기적인 스트리밍 수집은 물론, 일회성 데이터 적재 작업에도 사용할 수 있습니다. ClickPipes는 ClickPipes UI를 사용해 수동으로 배포하고 관리할 수 있으며, OpenAPI 및 Terraform을 사용해 프로그래밍 방식으로도 배포하고 관리할 수 있습니다.

​
지원되는 데이터 소스

더 많은 커넥터가 ClickPipes에 추가될 예정입니다. 자세한 내용은 문의하기에서 확인할 수 있습니다.

​
정적 IP 목록

다음 표에는 ClickPipes가 외부 서비스에 연결할 때 사용하는 정적 NAT IP 주소가 나와 있습니다. ClickHouse Cloud 서비스를 제공하는 ClickPipes 리전의 IP 주소를 IP 허용 목록에 추가하십시오. 객체 스토리지 파이프의 경우 ClickHouse 클러스터 IP도 IP 허용 목록에 추가해야 합니다. 아래 Google Cloud 표에 나열된 Google Cloud 리전의 서비스는 2026년 5월 27일 이후에 생성된 경우에만 해당 Google Cloud IP 주소를 사용합니다. 해당 리전에서 2026년 5월 27일 이전에 생성된 서비스는 아래에 나열된 기본 리전 IP 주소를 계속 사용합니다. 그 외 서비스의 경우 ClickPipes 트래픽은 서비스 위치에 따라 기본 리전에서 발생합니다.
  • eu-central-1: 명시적으로 나열되지 않은 모든 EU 리전, Azure EU 리전, 그리고 2026년 5월 27일 이전에 생성된 Google Cloud EU 서비스에 적용됩니다.
  • eu-west-1: 2026년 1월 20일 이후에 생성된 AWS eu-west-1의 모든 서비스에 적용됩니다(이 날짜 이전에 생성된 서비스는 eu-central-1 IP를 사용합니다).
  • us-east-1: AWS us-east-1의 모든 서비스에 적용됩니다.
  • ap-south-1: 2025년 6월 25일 이후에 생성된 AWS ap-south-1의 서비스에 적용됩니다(이 날짜 이전에 생성된 서비스는 us-east-2 IP를 사용합니다).
  • ap-northeast-2: 2025년 11월 14일 이후에 생성된 AWS ap-northeast-2의 서비스에 적용됩니다(이 날짜 이전에 생성된 서비스는 us-east-2 IP를 사용합니다).
  • af-south-1: 2026년 4월 15일 이후에 생성된 AWS af-south-1의 서비스에 적용됩니다(이 날짜 이전에 생성된 서비스는 us-east-2 IP를 사용합니다).
  • ap-east-1: 2026년 4월 15일 이후에 생성된 AWS ap-east-1의 서비스에 적용됩니다(이 날짜 이전에 생성된 서비스는 us-east-2 IP를 사용합니다).
  • ap-northeast-1: 2026년 4월 15일 이후에 생성된 AWS ap-northeast-1의 서비스에 적용됩니다(이 날짜 이전에 생성된 서비스는 us-east-2 IP를 사용합니다).
  • ap-southeast-1: 2026년 3월 18일 이후에 생성된 AWS ap-southeast-1의 서비스에 적용됩니다(이 날짜 이전에 생성된 서비스는 us-east-2 IP를 사용합니다).
  • ap-southeast-2: 2025년 6월 25일 이후에 생성된 AWS ap-southeast-2의 서비스에 적용됩니다(이 날짜 이전에 생성된 서비스는 us-east-2 IP를 사용합니다).
  • ap-southeast-3: 2026년 3월 6일 이후에 생성된 AWS ap-southeast-3의 서비스에 적용됩니다(이 날짜 이전에 생성된 서비스는 us-east-2 IP를 사용합니다).
  • ca-central-1: 2026년 4월 15일 이후에 생성된 AWS ca-central-1의 서비스에 적용됩니다(이 날짜 이전에 생성된 서비스는 us-east-2 IP를 사용합니다).
  • eu-north-1: 2026년 4월 15일 이후에 생성된 AWS eu-north-1의 서비스에 적용됩니다(이 날짜 이전에 생성된 서비스는 eu-central-1 IP를 사용합니다).
  • eu-west-2: 2026년 4월 15일 이후에 생성된 AWS eu-west-2의 서비스에 적용됩니다(이 날짜 이전에 생성된 서비스는 eu-central-1 IP를 사용합니다).
  • il-central-1: 2026년 4월 15일 이후에 생성된 AWS il-central-1의 서비스에 적용됩니다(이 날짜 이전에 생성된 서비스는 us-east-2 IP를 사용합니다).
  • sa-east-1: 2026년 4월 15일 이후에 생성된 AWS sa-east-1의 서비스에 적용됩니다(이 날짜 이전에 생성된 서비스는 us-east-2 IP를 사용합니다).
  • us-west-2: 2025년 6월 24일 이후에 생성된 AWS us-west-2의 서비스에 적용됩니다(이 날짜 이전에 생성된 서비스는 us-east-2 IP를 사용합니다).
  • us-east-2: 위 규칙에 해당하지 않는 그 밖의 모든 리전에 적용되며, 여기에는 Azure 리전과 2026년 5월 27일 이전에 생성된 Google Cloud 서비스가 포함됩니다.

​
AWS 정적 NAT IP 주소

​
Google Cloud 정적 NAT IP 주소

​
ClickHouse 설정 조정

ClickHouse Cloud는 대부분의 경우에 적절한 기본값을 제공합니다. 그러나 ClickPipes 대상 테이블에 일부 ClickHouse 설정을 조정해야 한다면, ClickPipes 전용 역할을 사용하는 것이 가장 유연한 방법입니다. 단계:
  1. 사용자 지정 역할 CREATE ROLE my_clickpipes_role SETTINGS ...을 생성합니다. 자세한 내용은 CREATE ROLE 구문을 참조하십시오.
  2. ClickPipes를 생성할 때 Details and Settings 단계에서 ClickPipes 사용자에 사용자 지정 역할을 추가합니다.

​
ClickPipes 고급 설정 조정

ClickPipes는 대부분의 사용 사례에 적합한 기본 설정을 제공합니다. 추가적인 세부 조정이 필요한 경우 다음 설정을 조정할 수 있습니다:

​
객체 스토리지 ClickPipes

​
스트리밍 ClickPipes

​
오류 보고

ClickPipes는 수집 과정에서 발생한 오류를 오류 유형에 따라 두 개의 별도 테이블(table)에 저장합니다.

​
레코드 오류

ClickPipes는 대상 테이블과 함께 <destination_table_name>_clickpipes_error 접미사가 붙은 테이블을 생성합니다. 이 테이블에는 형식이 잘못된 데이터나 스키마 불일치로 인해 발생한 모든 오류가 포함되며, 유효하지 않은 메시지 전체도 저장됩니다. 이 테이블의 TTL은 7일입니다.

​
시스템 오류

ClickPipe 작동과 관련된 오류는 system.clickpipes_log 테이블에 저장됩니다. 여기에는 ClickPipe 작동 중 발생하는 기타 모든 오류(네트워크, 연결 등)도 저장됩니다. 이 테이블의 TTL은 7일입니다. ClickPipes가 15분 이내에 데이터 소스에 연결하지 못하거나 1시간 이내에 대상에 연결하지 못하면, ClickPipes 인스턴스는 중지되며 system error table에 적절한 메시지가 저장됩니다(ClickHouse 인스턴스를 사용할 수 있는 경우).

​
모니터링

콘솔 내 모니터링 외에도 ClickPipes는 스크레이핑을 위해 Prometheus-compatible endpoint에 메트릭을 노출합니다. 이러한 메트릭은 다른 ClickHouse Cloud 서비스 메트릭과 함께 게시되며, 기존 관측성 스택(예: Grafana, Datadog)에 ClickPipes 모니터링을 통합할 수 있습니다. 사용 가능한 전체 메트릭 목록은 Monitoring ClickPipes에서 확인하십시오.

​
FAQ

  • ClickPipes란 무엇입니까? ClickPipes는 ClickHouse 서비스를 외부 데이터 소스, 특히 Kafka에 쉽게 연결할 수 있도록 해주는 ClickHouse Cloud 기능입니다. ClickPipes for Kafka를 사용하면 데이터를 ClickHouse에 지속적으로 손쉽게 적재하여 실시간 분석에 활용할 수 있습니다.
  • ClickPipes는 데이터 변환을 지원합니까? 예, ClickPipes는 DDL 생성 기능을 제공하여 기본적인 데이터 변환을 지원합니다. 이후에는 ClickHouse의 materialized view 기능을 활용해 데이터가 ClickHouse Cloud 서비스의 대상 테이블에 적재되는 과정에서 더 고급 변환을 적용할 수 있습니다.
  • ClickPipes를 사용하면 추가 비용이 발생합니까? ClickPipes는 수집된 데이터와 컴퓨트의 2가지 차원으로 청구됩니다. 가격에 대한 자세한 내용은 이 페이지에서 확인할 수 있습니다. 또한 ClickPipes를 실행하면 다른 수집 워크로드와 마찬가지로 대상 ClickHouse Cloud 서비스에서 간접적인 컴퓨트 및 스토리지 비용이 발생할 수 있습니다.
  • ClickPipes for Kafka를 사용할 때 오류나 장애를 처리할 방법이 있습니까? 예, ClickPipes for Kafka는 네트워크 문제, 연결 문제 등 운영상 이슈로 인해 Kafka에서 데이터를 수집하지 못하는 경우 자동으로 재시도합니다. 데이터 형식이 잘못되었거나 스키마가 유효하지 않은 경우, ClickPipes는 해당 레코드를 record_error table에 저장하고 처리를 계속합니다.
마지막 수정일 2026년 6월 12일