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

# المزامنة مع ClickHouse باستخدام ClickPipes

> انسخ بيانات Postgres إلى ClickHouse باستخدام إمكانات CDC المدمجة

export const Image = ({img, alt, size = "lg", background}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  const backgroundColor = background === "white" ? "white" : background === "black" ? "rgb(31 31 28)" : undefined;
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} style={{
    backgroundColor
  }} />
      </Frame>
    </div>;
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <span>Beta</span>
            </a>;
  }
  return <a href="https://clickhouse.com/docs/reference/settings/beta-and-experimental-features#beta-features" className="betaBadge">
            <span>ميزة Beta</span>
        </a>;
};

<BetaBadge link="https://clickhouse.com/cloud/postgres" galaxyTrack={true} galaxyEvent="docs.managed-postgres.clickhouse-integration-beta" />

يأتي كل ClickHouse Managed Postgres instance مزوّدًا بقدرات CDC مدمجة نحو أي من خدمات ClickHouse لديك. ويتيح لك ذلك نقل بعض أو كل البيانات الموجودة في Postgres instance إلى ClickHouse، مع انعكاس التغييرات الحاصلة على بيانات Postgres في ClickHouse بشكل مستمر وشبه لحظي. ويعمل ذلك في الخلفية بالاعتماد على [ClickPipes](/ar/integrations/clickpipes/home).

للوصول إلى هذه الميزة، انقر على **Sync to ClickHouse** في الشريط الجانبي لـ Postgres instance.

<Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/xHfTFhAoB3hIpGFb/images/managed-postgres/clickhouse-integration-intro.webp?fit=max&auto=format&n=xHfTFhAoB3hIpGFb&q=85&s=f2de966f7661a462fbb9a0a310bbb270" alt="صفحة ClickHouse Integration التي تعرض خيار التكامل في الشريط الجانبي" size="md" border width="1526" height="956" data-path="images/managed-postgres/clickhouse-integration-intro.webp" />

<Note>
  قبل المتابعة، تأكد من أن Postgres service لديك متاح للوصول من خدمة ClickPipes. وهذا هو الوضع الافتراضي عادةً، لكن إذا كنت قد قيّدت الوصول عبر عناوين IP فقد تحتاج إلى منح الوصول لبعض عناوين IP المصدر من [هذه](/ar/integrations/clickpipes/networking/static-ips) القائمة، وفقًا للمنطقة التي توجد فيها **ClickHouse service** الخاصة بك.
</Note>

انقر على **Replicate data in ClickHouse** لبدء إعداد ClickPipe الخاص بك.

<Steps>
  <Step title="تهيئة خدمة النسخ المتماثل" id="configure-replication-service">
    املأ إعدادات النسخ المتماثل:

    * **Integration name**: اسم لهذا الـ ClickPipe
    * **ClickHouse service**: اختر خدمة ClickHouse Cloud موجودة أو أنشئ واحدة جديدة
    * **Postgres database**: قاعدة البيانات المصدر التي سيتم النسخ المتماثل منها
    * **Replication method**: اختر أحد الخيارات التالية:
      * **تحميل أولي + CDC**: استيراد البيانات الموجودة وإبقاء الجداول محدَّثة بالتغييرات الجديدة (موصى به)
      * **تحميل أولي فقط**: لقطة واحدة للبيانات الموجودة دون تحديثات مستمرة
      * **CDC only**: تخطّي اللقطة الأولية والتقاط التغييرات الجديدة فقط

    <Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/xHfTFhAoB3hIpGFb/images/managed-postgres/replication-service-step.webp?fit=max&auto=format&n=xHfTFhAoB3hIpGFb&q=85&s=71c792ea56ab5ed02222c2979498ae84" alt="تهيئة خدمة النسخ المتماثل تُظهر اسم التكامل وخدمة الوجهة وخيارات طريقة النسخ المتماثل" size="md" border width="1620" height="956" data-path="images/managed-postgres/replication-service-step.webp" />

    انقر على **Next** للمتابعة.
  </Step>

  <Step title="تهيئة إعدادات النسخ المتماثل" id="replication-settings">
    اضبط تفاصيل كيفية نسخ البيانات:

    * **Sync interval (seconds)**: مدى تكرار سحب التغييرات من Postgres (الافتراضي: 60)
    * **Parallel threads for initial load**: عدد الخيوط المستخدمة أثناء اللقطة الأولية (الافتراضي: 4)
    * **Pull batch size**: عدد الصفوف التي يتم جلبها في كل دفعة أثناء النسخ المتماثل (الافتراضي: 100000)
    * **Snapshot number of rows per partition**: عدد الصفوف لكل partition أثناء اللقطة الأولية (الافتراضي: 100000)
    * **Snapshot number of tables in parallel**: عدد الجداول التي تُؤخذ لها لقطة بالتوازي (الافتراضي: 1)

    <Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/xHfTFhAoB3hIpGFb/images/managed-postgres/integration-replication-settings.webp?fit=max&auto=format&n=xHfTFhAoB3hIpGFb&q=85&s=f73c47e084727b55d05755db6127c896" alt="خطوة إعدادات النسخ المتماثل تُظهر فترة المزامنة والخيوط المتوازية وحجم دفعة السحب وخيارات تهيئة اللقطة" size="md" border width="1526" height="957" data-path="images/managed-postgres/integration-replication-settings.webp" />

    انقر على **Next** للمتابعة.
  </Step>

  <Step title="اختيار الجداول المراد نسخها" id="select-tables">
    اختر قاعدة بيانات هدف وحدِّد الجداول التي سيتم نسخها:

    * **Destination database**: اختر قاعدة بيانات ClickHouse موجودة أو أنشئ واحدة جديدة
    * **Prefix default destination table names with schema name**: يضيف schema الخاص بـ Postgres كبادئة لتجنّب تعارض الأسماء
    * **Preserve NULL values from source**: يحافظ على قيم NULL بدلاً من تحويلها إلى القيم الافتراضية للنوع. ينطبق هذا الإعداد على جميع الجداول في الـ pipe ولا يمكن تغييره بعد إنشائه.
    * **Remove deleted rows during merges**: بالنسبة لجداول [ReplacingMergeTree](/ar/reference/engines/table-engines/mergetree-family/replacingmergetree)، يزيل الصفوف المحذوفة فعلياً أثناء عمليات الدمج في الخلفية

    وسّع المخططات وحدِّد الجداول التي تريد نسخها. يمكنك أيضاً تخصيص أسماء جداول الوجهة وإعدادات الأعمدة.

    <Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/xHfTFhAoB3hIpGFb/images/managed-postgres/select-tables-step.webp?fit=max&auto=format&n=xHfTFhAoB3hIpGFb&q=85&s=be0345181d3022080ad8653542714421" alt="خطوة اختيار الجداول تُظهر تحديد قاعدة البيانات وخيارات النسخ المتماثل ومنتقي الجداول المجمّع حسب المخطط" size="md" border width="2454" height="1804" data-path="images/managed-postgres/select-tables-step.webp" />

    انقر على **Replicate data to ClickHouse** لبدء النسخ المتماثل.
  </Step>

  <Step title="مراقبة الـ ClickPipe الخاص بك" id="monitor-clickpipe">
    بمجرد بدء الـ ClickPipe، ستجده مدرجاً في القائمة نفسها. وقد تستغرق اللقطة الأولية لجميع البيانات بعض الوقت حسب حجم جداولك.

    <Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/xHfTFhAoB3hIpGFb/images/managed-postgres/integration-running.webp?fit=max&auto=format&n=xHfTFhAoB3hIpGFb&q=85&s=37b194710421e11fdbeaf84474491c60" alt="قائمة تكاملات ClickHouse تُظهر ClickPipe قيد التشغيل مع خدمة الوجهة والحالة" size="md" border width="2518" height="622" data-path="images/managed-postgres/integration-running.webp" />

    انقر على اسم التكامل لعرض الحالة التفصيلية ومتابعة التقدم وعرض الأخطاء وإدارة الـ ClickPipe. راجع [دورة حياة ClickPipe الخاص بـ Postgres](/ar/integrations/clickpipes/postgres/lifecycle) لفهم الحالات المختلفة التي قد يمرّ بها الـ ClickPipe الخاص بك.
  </Step>
</Steps>