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

# التحكم في مزامنة ClickPipe لـ Postgres

> مستند يشرح التحكم في مزامنة ClickPipe لـ Postgres

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

تشرح هذه الوثيقة كيفية التحكّم في مزامنة Postgres ClickPipe عندما يكون ClickPipe في **وضع CDC (قيد التشغيل)**.

<div id="overview">
  ## نظرة عامة
</div>

تتكوّن معمارية ClickPipes لقواعد البيانات من عمليتين متوازيتين: السحب من قاعدة البيانات المصدر والدفع إلى قاعدة البيانات الهدف. وتخضع عملية السحب لإعداد مزامنة يحدّد مدى تكرار سحب البيانات وكمية البيانات التي ينبغي سحبها في كل مرة. والمقصود بعبارة "في كل مرة" هو دفعة واحدة، لأن ClickPipe يسحب البيانات ويدفعها على شكل دفعات.

هناك طريقتان أساسيتان للتحكم في مزامنة Postgres ClickPipe. وسيبدأ ClickPipe بالدفع عند استيفاء أحد الإعدادات أدناه.

<div id="interval">
  ### فاصل المزامنة
</div>

فاصل المزامنة الخاص بـ pipe هو مقدار الوقت (بالثواني) الذي يسحب خلاله ClickPipe السجلات من قاعدة البيانات المصدر. ولا يشمل هذا الفاصل الوقت اللازم لدفع ما لدينا إلى ClickHouse.

القيمة الافتراضية هي **دقيقة واحدة**.
يمكن ضبط فاصل المزامنة على أي عدد صحيح موجب، ولكن يُوصى بالإبقاء عليه فوق 10 ثوانٍ.

<div id="batch-size">
  ### حجم دفعة السحب
</div>

حجم دفعة السحب هو عدد السجلات التي يسحبها ClickPipe من قاعدة البيانات المصدر في دفعة واحدة. والمقصود بالسجلات هنا عمليات الإدراج والتحديث والحذف التي تُجرى على الجداول التي تكون جزءًا من الـ pipe.

القيمة الافتراضية هي **100,000** سجل.
والحد الأقصى الآمن هو 10 ملايين.

<div id="transactions">
  ### استثناء: المعاملات طويلة الأمد على قاعدة البيانات المصدر
</div>

عند تنفيذ معاملة على قاعدة البيانات المصدر، ينتظر ClickPipe حتى يتلقى COMMIT الخاص بها قبل أن يتابع. وهذا **يتجاوز** كلاً من فاصل المزامنة وحجم دفعة السحب.

<div id="configuring">
  ### ضبط إعدادات المزامنة
</div>

يمكنك ضبط فاصل المزامنة وحجم دفعة السحب عند إنشاء ClickPipe أو تعديل ClickPipe موجود.
عند إنشاء ClickPipe، ستظهر هذه الإعدادات في الخطوة الثانية من معالج الإنشاء، كما هو موضح أدناه:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/Kmm8X3tBno--Vzxh/images/integrations/data-ingestion/clickpipes/postgres/create_sync_settings.png?fit=max&auto=format&n=Kmm8X3tBno--Vzxh&q=85&s=0a763dc35eb94dbcf597057ed474e208" 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-mintlify-8c05c8a2/Kmm8X3tBno--Vzxh/images/integrations/data-ingestion/clickpipes/postgres/edit_sync_button.png?fit=max&auto=format&n=Kmm8X3tBno--Vzxh&q=85&s=a9446df1358608c9d3b5ffe521312867" 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-8c05c8a2/Kmm8X3tBno--Vzxh/images/integrations/data-ingestion/clickpipes/postgres/sync_settings_edit.png?fit=max&auto=format&n=Kmm8X3tBno--Vzxh&q=85&s=a86606d4d9efddbc68eeed86260b4071" alt="تعديل إعدادات المزامنة" size="md" width="598" height="588" data-path="images/integrations/data-ingestion/clickpipes/postgres/sync_settings_edit.png" />

<div id="tweaking">
  ### تعديل إعدادات المزامنة للمساعدة في الحد من نمو replication slot
</div>

لنتحدث عن كيفية استخدام هذه الإعدادات للتعامل مع replication slot كبير في قناة CDC.
لا يتناسب وقت دفع البيانات إلى ClickHouse خطيًا مع وقت سحبها من قاعدة البيانات المصدر. ويمكن الاستفادة من ذلك لتقليل حجم replication slot الكبير.
ومن خلال زيادة كلٍّ من فاصل المزامنة وحجم دفعة السحب، سيقوم ClickPipe بسحب كمية كبيرة جدًا من البيانات من قاعدة البيانات المصدر دفعةً واحدة، ثم دفعها إلى ClickHouse.

<div id="monitoring">
  ### مراقبة سلوك التحكّم في المزامنة
</div>

يمكنك الاطلاع على المدة التي تستغرقها كل دفعة في جدول **CDC Syncs** ضمن علامة التبويب **Metrics** في ClickPipe. لاحظ أن المدة هنا تشمل أيضًا وقت الإرسال، وإذا لم تَرِد أي صفوف، فسينتظر ClickPipe، ويُحتسب وقت الانتظار أيضًا ضمن المدة.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/Kmm8X3tBno--Vzxh/images/integrations/data-ingestion/clickpipes/postgres/cdc_syncs.png?fit=max&auto=format&n=Kmm8X3tBno--Vzxh&q=85&s=c9e3177c30ceb624921e4fb3bfbdeb10" alt="جدول CDC Syncs" size="md" width="2428" height="626" data-path="images/integrations/data-ingestion/clickpipes/postgres/cdc_syncs.png" />
