메인 콘텐츠로 건너뛰기
이 문서에서는 MySQL ClickPipe의 여러 단계와 발생할 수 있는 다양한 상태, 그리고 각 상태의 의미를 설명합니다. 이 내용은 MariaDB에도 동일하게 적용됩니다.

Provisioning

Create ClickPipe 버튼을 클릭하면 ClickPipe가 Provisioning 상태로 생성됩니다. 프로비저닝 과정에서는 서비스에서 ClickPipes를 실행하는 데 필요한 기반 인프라를 준비하고, 파이프의 초기 메타데이터를 등록합니다. 서비스 내 ClickPipes의 컴퓨트는 공유되므로 두 번째 ClickPipe는 첫 번째 ClickPipe보다 훨씬 더 빠르게 생성됩니다. 이는 인프라가 이미 준비되어 있기 때문입니다.

Setup

파이프가 프로비저닝되면 Setup 상태로 전환됩니다. 이 상태에서는 대상 ClickHouse 테이블을 생성합니다. 또한 이 단계에서 원본 테이블의 정의를 가져와 기록합니다.

스냅샷

설정이 완료되면 Snapshot 상태로 진입합니다(CDC 전용 파이프는 Running 상태로 전환됩니다). Snapshot, Initial Snapshot, Initial Load(더 일반적으로 쓰이는 표현)는 같은 의미로 혼용되는 용어입니다. 이 상태에서는 소스 MySQL 테이블의 스냅샷을 가져와 ClickHouse에 적재합니다. 바이너리 로그의 보존 설정은 초기 적재에 걸리는 시간을 고려해야 합니다. 초기 적재에 대한 자세한 내용은 병렬 초기 적재 문서를 참조하십시오. 또한 resync가 실행되거나 기존 파이프에 새 테이블이 추가되면 파이프는 Snapshot 상태로 진입합니다.

Running

초기 적재가 완료되면 파이프는 Running 상태로 전환됩니다(snapshot-only 파이프인 경우 Completed로 전환됩니다). 이 시점부터 파이프는 Change-Data Capture를 시작합니다. 이 상태에서는 원본 데이터베이스의 바이너리 로그를 읽어 데이터를 배치 단위로 ClickHouse에 동기화합니다. CDC를 제어하는 방법은 CDC 제어 문서를 참조하십시오.

일시 중지됨

파이프가 Running 상태가 되면 일시 중지할 수 있습니다. 그러면 CDC 프로세스가 중지되고 파이프는 Paused 상태가 됩니다. 이 상태에서는 원본 데이터베이스에서 새로운 데이터를 가져오지 않지만, ClickHouse에 있는 기존 데이터는 그대로 유지됩니다. 이 상태에서 파이프를 재개할 수 있습니다.

Pausing

이 상태는 곧 제공될 예정입니다. OpenAPI를 사용 중이라면, 출시 후에도 통합이 계속 정상적으로 작동할 수 있도록 지금부터 이 상태에 대한 지원을 추가하는 것이 좋습니다.
Pause 버튼을 클릭하면 파이프가 Pausing 상태로 전환됩니다. 이 상태는 CDC 프로세스를 중지하는 중인 일시적 상태입니다. CDC 프로세스가 완전히 중지되면 파이프는 일시 중지됨 상태로 전환됩니다.

수정 중

이 상태는 곧 제공될 예정입니다. OpenAPI를 사용 중이라면, 출시 후에도 통합이 계속 작동하도록 지금 미리 지원을 추가해 두는 것이 좋습니다.
현재 이 상태는 파이프가 테이블을 제거하는 중임을 나타냅니다.

Resync

이 상태는 곧 제공될 예정입니다. OpenAPI를 사용 중이라면, 출시 후에도 통합이 계속 정상적으로 작동할 수 있도록 지금부터 이 상태에 대한 지원을 추가하는 것이 좋습니다.
이 상태는 파이프가 resync 단계에 있으며, _resync tables를 원래 테이블과 원자적으로 스왑하는 작업을 수행하고 있음을 나타냅니다. resync에 대한 자세한 내용은 resync 문서에서 확인할 수 있습니다.

Completed

이 상태는 스냅샷 전용 파이프에 적용되며, 스냅샷이 완료되어 더 이상 수행할 작업이 없음을 의미합니다.

Failed

파이프에 복구할 수 없는 오류가 발생하면 Failed 상태로 전환됩니다. 이 상태에서 복구하려면 지원팀에 문의하거나 파이프를 resync하십시오.
마지막 수정일 2026년 6월 10일