> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> 다양한 파이프 상태와 그 의미

# MySQL ClickPipe의 수명 주기

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

<div id="provisioning">
  ## Provisioning
</div>

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

<div id="setup">
  ## Setup
</div>

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

<div id="snapshot">
  ## 스냅샷
</div>

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

<div id="running">
  ## Running
</div>

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

<div id="paused">
  ## 일시 중지됨
</div>

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

<div id="pausing">
  ## Pausing
</div>

<Note>
  이 상태는 곧 제공될 예정입니다. [OpenAPI](/ko/products/cloud/features/admin-features/api/openapi)를 사용 중이라면, 출시 후에도 통합이 계속 정상적으로 작동할 수 있도록 지금부터 이 상태에 대한 지원을 추가하는 것이 좋습니다.
</Note>

Pause 버튼을 클릭하면 파이프가 `Pausing` 상태로 전환됩니다. 이 상태는 CDC 프로세스를 중지하는 중인 일시적 상태입니다. CDC 프로세스가 완전히 중지되면 파이프는 `일시 중지됨` 상태로 전환됩니다.

<div id="modifying">
  ## 수정 중
</div>

<Note>
  이 상태는 곧 제공될 예정입니다. [OpenAPI](/ko/products/cloud/features/admin-features/api/openapi)를 사용 중이라면, 출시 후에도 통합이 계속 작동하도록 지금 미리 지원을 추가해 두는 것이 좋습니다.
</Note>

현재 이 상태는 파이프가 테이블을 제거하는 중임을 나타냅니다.

<div id="resync">
  ## Resync
</div>

<Note>
  이 상태는 곧 제공될 예정입니다. [OpenAPI](/ko/products/cloud/features/admin-features/api/openapi)를 사용 중이라면, 출시 후에도 통합이 계속 정상적으로 작동할 수 있도록 지금부터 이 상태에 대한 지원을 추가하는 것이 좋습니다.
</Note>

이 상태는 파이프가 resync 단계에 있으며, \_resync tables를 원래 테이블과 원자적으로 스왑하는 작업을 수행하고 있음을 나타냅니다. resync에 대한 자세한 내용은 [resync 문서](/ko/integrations/clickpipes/mysql/resync)에서 확인할 수 있습니다.

<div id="completed">
  ## Completed
</div>

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

<div id="failed">
  ## Failed
</div>

파이프에 복구할 수 없는 오류가 발생하면 `Failed` 상태로 전환됩니다. 이 상태에서 복구하려면 지원팀에 문의하거나 파이프를 [resync](/ko/integrations/clickpipes/mysql/resync)하십시오.