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

# MongoDB ClickPipe の同期を制御する

> MongoDB ClickPipe の同期制御に関するドキュメント

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

このドキュメントでは、MongoDB ClickPipe が **CDC (実行中) モード** のときに、ClickPipe の同期を制御する方法について説明します。

<div id="overview">
  ## 概要
</div>

Database ClickPipes は、ソースデータベースからのプルと移行先データベースへのプッシュという、2 つの並行プロセスで構成されるアーキテクチャです。プルのプロセスは同期設定によって制御され、この設定でデータをどのくらいの頻度でプルするか、また 1 回にどれだけのデータをプルするかを定義します。ここでいう「1 回に」とは 1 バッチのことです。ClickPipe はデータをバッチ単位でプルおよびプッシュするためです。

MongoDB ClickPipe の同期を制御する主な方法は 2 つあります。以下の設定のいずれかの条件を満たすと、ClickPipe はプッシュを開始します。

<div id="interval">
  ### 同期間隔
</div>

パイプの同期間隔は、ClickPipe がソースデータベースからレコードを取得する時間の長さ (秒単位) を指します。取得したデータを ClickHouse に送信するための時間は、この間隔には含まれません。

デフォルトは **1 分** です。
同期間隔には任意の正の整数値を設定できますが、10 秒より大きい値に保つことを推奨します。

<div id="batch-size">
  ### プルバッチサイズ
</div>

プルバッチサイズは、ClickPipe が 1 回のバッチでソースデータベースから取得するレコード数です。ここでいうレコードとは、パイプに含まれるコレクションに対して行われる挿入、更新、削除を指します。

デフォルトは **100,000** レコードです。
安全な最大値は 1,000 万です。

<div id="configuring">
  ### 同期設定を構成する
</div>

ClickPipe の作成時または既存の ClickPipe の編集時に、同期間隔とプルバッチサイズを設定できます。
ClickPipe の作成時には、以下のように作成ウィザードの 2 番目のステップに表示されます。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-67bc7bf8/VOUe3z-tehHaD879/images/integrations/data-ingestion/clickpipes/postgres/create_sync_settings.png?fit=max&auto=format&n=VOUe3z-tehHaD879&q=85&s=97eb7fd30c4b15bf16995558c1070652" alt="同期設定の作成" size="md" width="902" height="654" data-path="images/integrations/data-ingestion/clickpipes/postgres/create_sync_settings.png" />

既存の ClickPipe を編集する場合は、パイプの **Settings** タブに移動し、パイプを一時停止してから、ここで **Configure** をクリックします。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-67bc7bf8/VOUe3z-tehHaD879/images/integrations/data-ingestion/clickpipes/postgres/edit_sync_button.png?fit=max&auto=format&n=VOUe3z-tehHaD879&q=85&s=4c3c58af659a934a9451691bda541700" alt="同期の編集ボタン" size="md" width="933" height="417" data-path="images/integrations/data-ingestion/clickpipes/postgres/edit_sync_button.png" />

すると、同期設定を表示するフライアウトが開き、そこで同期間隔とプルバッチサイズを変更できます。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-67bc7bf8/VOUe3z-tehHaD879/images/integrations/data-ingestion/clickpipes/postgres/sync_settings_edit.png?fit=max&auto=format&n=VOUe3z-tehHaD879&q=85&s=cdc36c318465a3eaef37aaced33890c9" 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-mintlify-67bc7bf8/VOUe3z-tehHaD879/images/integrations/data-ingestion/clickpipes/postgres/cdc_syncs.png?fit=max&auto=format&n=VOUe3z-tehHaD879&q=85&s=82dd4b477c8724152eb6c5bdc7fee012" alt="CDC Syncs テーブル" size="md" width="2428" height="626" data-path="images/integrations/data-ingestion/clickpipes/postgres/cdc_syncs.png" />
