메인 콘텐츠로 건너뛰기
이 문서에서는 MySQL ClickPipe가 CDC (Running) 모드에 있을 때 동기화를 제어하는 방법을 설명합니다.

개요

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

동기화 간격

파이프의 동기화 간격은 ClickPipe가 원본 데이터베이스에서 레코드를 가져오는 시간(초)을 의미합니다. 현재까지 수집한 내용을 ClickHouse로 푸시하는 데 걸리는 시간은 이 간격에 포함되지 않습니다. 기본값은 1분입니다. 동기화 간격은 임의의 양의 정수로 설정할 수 있지만, 10초보다 크게 유지하는 것이 좋습니다.

Pull 배치 크기

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

예외: 원본에서 장시간 실행되는 트랜잭션

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

동기화 설정 구성하기

ClickPipe를 생성하거나 기존 ClickPipe를 편집할 때 동기화 간격과 pull batch 크기를 설정할 수 있습니다. ClickPipe를 생성할 때는 아래와 같이 생성 마법사의 2단계에서 이 설정을 확인할 수 있습니다: 기존 ClickPipe를 편집할 때는 파이프의 설정 탭으로 이동해 파이프를 일시 중지한 다음, 여기에서 구성을 클릭하십시오: 그러면 동기화 설정이 포함된 플라이아웃이 열리며, 여기서 동기화 간격과 pull batch 크기를 변경할 수 있습니다:

동기화 제어 동작 모니터링

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