> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-postgresql-tls-support.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 = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

このドキュメントでは、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-postgresql-tls-support/vgIzai2BO-JprHxt/images/integrations/data-ingestion/clickpipes/postgres/create_sync_settings.webp?fit=max&auto=format&n=vgIzai2BO-JprHxt&q=85&s=0b421cc50dd749be2078d3fda028558e" alt="同期設定の作成" size="md" width="902" height="654" data-path="images/integrations/data-ingestion/clickpipes/postgres/create_sync_settings.webp" />

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

<Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/vgIzai2BO-JprHxt/images/integrations/data-ingestion/clickpipes/postgres/edit_sync_button.webp?fit=max&auto=format&n=vgIzai2BO-JprHxt&q=85&s=3cddcce54d1b06768120008331a26f6c" alt="同期の編集ボタン" size="md" width="933" height="417" data-path="images/integrations/data-ingestion/clickpipes/postgres/edit_sync_button.webp" />

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

<Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/vgIzai2BO-JprHxt/images/integrations/data-ingestion/clickpipes/postgres/sync_settings_edit.webp?fit=max&auto=format&n=vgIzai2BO-JprHxt&q=85&s=6c873372bc3b574d5d47962576493ec6" alt="同期設定の編集" size="md" width="598" height="588" data-path="images/integrations/data-ingestion/clickpipes/postgres/sync_settings_edit.webp" />

<div id="monitoring">
  ### 同期制御の動作を監視する
</div>

各バッチにかかる時間は、ClickPipe の **メトリクス** タブにある **CDC Syncs** テーブルで確認できます。ここでの所要時間にはプッシュ時間が含まれます。また、受信する行がない場合は ClickPipe が待機し、その待機時間も所要時間に含まれる点に注意してください。

<Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/vgIzai2BO-JprHxt/images/integrations/data-ingestion/clickpipes/postgres/cdc_syncs.webp?fit=max&auto=format&n=vgIzai2BO-JprHxt&q=85&s=dda50711612db431076bba72a0908e88" alt="CDC Syncs テーブル" size="md" width="2428" height="626" data-path="images/integrations/data-ingestion/clickpipes/postgres/cdc_syncs.webp" />
