> ## 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 동기화를 제어하는 문서

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

이 문서에서는 MySQL ClickPipe가 **CDC (Running) 모드**에 있을 때 동기화를 제어하는 방법을 설명합니다.

<div id="overview">
  ## 개요
</div>

데이터베이스 ClickPipes는 원본 데이터베이스에서 데이터를 가져오고 대상 데이터베이스로 전송하는 두 개의 병렬 프로세스로 구성된 아키텍처를 사용합니다. 가져오기 프로세스는 동기화 구성에서 제어하며, 이 구성은 데이터를 얼마나 자주 가져올지와 한 번에 얼마나 많은 데이터를 가져올지를 정의합니다. 여기서 "한 번에"는 하나의 배치를 의미합니다. ClickPipe는 데이터를 배치 단위로 가져오고 전송하기 때문입니다.

MySQL ClickPipe의 동기화를 제어하는 주요 방법은 두 가지입니다. 아래 설정 중 하나가 적용되면 ClickPipe가 전송을 시작합니다.

<div id="interval">
  ### 동기화 간격
</div>

파이프의 동기화 간격은 ClickPipe가 원본 데이터베이스에서 레코드를 가져오는 시간(초)을 의미합니다. 현재까지 수집한 내용을 ClickHouse로 푸시하는 데 걸리는 시간은 이 간격에 포함되지 않습니다.

기본값은 **1분**입니다.
동기화 간격은 임의의 양의 정수로 설정할 수 있지만, 10초보다 크게 유지하는 것이 좋습니다.

<div id="batch-size">
  ### Pull 배치 크기
</div>

Pull 배치 크기는 ClickPipe가 한 번의 배치로 원본 데이터베이스에서 가져오는 레코드 수를 의미합니다. 여기서 레코드는 파이프에 포함된 테이블에서 수행된 삽입, 업데이트, 삭제를 뜻합니다.

기본값은 **100,000**개입니다.
안전한 최대값은 1,000만 개입니다.

<div id="transactions">
  ### 예외: 원본에서 장시간 실행되는 트랜잭션
</div>

원본 데이터베이스에서 트랜잭션이 실행되면 ClickPipe는 해당 트랜잭션의 COMMIT을 받을 때까지 기다렸다가 그다음 단계로 진행합니다. 이 동작은 동기화 간격과 pull batch 크기보다 우선 적용됩니다.

<div id="configuring">
  ### 동기화 설정 구성하기
</div>

ClickPipe를 생성하거나 기존 ClickPipe를 편집할 때 동기화 간격과 pull batch 크기를 설정할 수 있습니다.
ClickPipe를 생성할 때는 아래와 같이 생성 마법사의 2단계에서 이 설정을 확인할 수 있습니다:

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/8xU-7NRzcVe16bmG/images/integrations/data-ingestion/clickpipes/postgres/create_sync_settings.png?fit=max&auto=format&n=8xU-7NRzcVe16bmG&q=85&s=412a27effa804c759b0b303c959754ac" alt="동기화 설정 생성" size="md" width="902" height="654" data-path="images/integrations/data-ingestion/clickpipes/postgres/create_sync_settings.png" />

기존 ClickPipe를 편집할 때는 파이프의 **설정** 탭으로 이동해 파이프를 일시 중지한 다음, 여기에서 **구성**을 클릭하십시오:

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/8xU-7NRzcVe16bmG/images/integrations/data-ingestion/clickpipes/postgres/edit_sync_button.png?fit=max&auto=format&n=8xU-7NRzcVe16bmG&q=85&s=30b39dfdad9cce8936706e7c8282ab0e" alt="동기화 편집 버튼" size="md" width="933" height="417" data-path="images/integrations/data-ingestion/clickpipes/postgres/edit_sync_button.png" />

그러면 동기화 설정이 포함된 플라이아웃이 열리며, 여기서 동기화 간격과 pull batch 크기를 변경할 수 있습니다:

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/8xU-7NRzcVe16bmG/images/integrations/data-ingestion/clickpipes/postgres/sync_settings_edit.png?fit=max&auto=format&n=8xU-7NRzcVe16bmG&q=85&s=a2a2c74960206a297f679bda02614969" alt="동기화 설정 편집" size="md" width="598" height="588" data-path="images/integrations/data-ingestion/clickpipes/postgres/sync_settings_edit.png" />

<div id="monitoring">
  ### 동기화 제어 동작 모니터링
</div>

ClickPipe의 **메트릭** 탭에 있는 **CDC Syncs** 테이블에서 각 배치에 걸리는 시간을 확인할 수 있습니다. 여기서 표시되는 소요 시간에는 푸시 시간도 포함됩니다. 또한 유입되는 행이 없으면 ClickPipe가 대기하며, 그 대기 시간 역시 소요 시간에 포함된다는 점에 유의하십시오.

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/8xU-7NRzcVe16bmG/images/integrations/data-ingestion/clickpipes/postgres/cdc_syncs.png?fit=max&auto=format&n=8xU-7NRzcVe16bmG&q=85&s=9516e13f2173892288776aa86a587959" alt="CDC Syncs 테이블" size="md" width="2428" height="626" data-path="images/integrations/data-ingestion/clickpipes/postgres/cdc_syncs.png" />
