> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# المزامنة إلى ClickHouse باستخدام WalShadow

> انسخ بيانات Postgres إلى ClickHouse باستخدام WalShadow، وهو محرك نسخ متماثل أصلي يقرأ مباشرةً من سجل WAL في PostgreSQL

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 PrivatePreviewBadge = () => {
  return <div className="privatePreviewBadge">
            <div className="privatePreviewIcon">
            <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path d="M5.33301 6.66667V4.66667V4.66667C5.33301 3.194 6.52701 2 7.99967 2V2C9.47234 2 10.6663 3.194 10.6663 4.66667V4.66667V6.66667" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path d="M8.00033 9.33337V11.3334" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path fillRule="evenodd" clipRule="evenodd" d="M11.333 14H4.66634C3.92967 14 3.33301 13.4033 3.33301 12.6666V7.99996C3.33301 7.26329 3.92967 6.66663 4.66634 6.66663H11.333C12.0697 6.66663 12.6663 7.26329 12.6663 7.99996V12.6666C12.6663 13.4033 12.0697 14 11.333 14Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
            </svg>
        </div>
            {'معاينة خاصة'}
        </div>;
};

<PrivatePreviewBadge />

`WalShadow` هو محرك نسخ متماثل أصلي (native) لـ ClickHouse Managed Postgres يقرأ مباشرةً من سجل الكتابة المسبقة (WAL) في PostgreSQL. وهو مُحسَّن لتقليل زمن الاستجابة ولأحمال العمل عالية الإنتاجية، إذ يحقق تأخّر نسخ متماثل أقل من ثانية واحدة من Postgres إلى ClickHouse. ويجري تطويره بشكل مفتوح المصدر على [ClickHouse/walshadow](https://github.com/ClickHouse/walshadow).

`WalShadow` هو إحدى طريقتَي النسخ المتماثل المتاحتين ضمن **Sync to ClickHouse**. أما الأخرى، [ClickPipes](/docs/ar/cloud/managed-postgres/clickpipes)، فهي خط أنابيب بيانات مُدار بالكامل. اختر `WalShadow` عندما تحتاج إلى أدنى زمن استجابة وأقل عبء نسخ متماثل.

عند توفّر `WalShadow` لخدمتك، تظهر لافتة **Private Preview** في صفحة **Overview**. انقر على **Configure WalShadow** للبدء.

<Image img="https://mintcdn.com/private-7c7dfe99/1IUPNo0kgSNuyelj/images/managed-postgres/walshadow/overview-banner.webp?fit=max&auto=format&n=1IUPNo0kgSNuyelj&q=85&s=868266fa6f2514dcdbdaef9696e53327" alt="صفحة نظرة عامة على خدمة Postgres تعرض لافتة المعاينة الخاصة لـ WalShadow مع روابط معرفة المزيد وتهيئة WalShadow" size="md" border width="3680" height="2392" data-path="images/managed-postgres/walshadow/overview-banner.webp" />

<Note>
  قبل المتابعة، تأكد من أن خدمة Postgres لديك قابلة للوصول من ClickHouse. يتصل `WalShadow` بخدمة ClickHouse الوجهة مباشرةً، لذا ستحتاج إلى مستخدم ClickHouse وكلمة مرور يمتلكان صلاحية إنشاء قواعد البيانات والجداول.
</Note>

لإعداد النسخ المتماثل، انقر على **Sync to ClickHouse** في الشريط الجانبي لمثيل Postgres لديك، ثم انقر على **Replicate data in ClickHouse**.

<Image img="https://mintcdn.com/private-7c7dfe99/1IUPNo0kgSNuyelj/images/managed-postgres/walshadow/sync-landing.webp?fit=max&auto=format&n=1IUPNo0kgSNuyelj&q=85&s=5932d900f2bd6438fa1ce524a3bc7979" alt="صفحة الوصول الخاصة بـ Sync to ClickHouse تعرض طريقتَي النسخ المتماثل ClickPipes وWalShadow" size="md" border width="3680" height="2392" data-path="images/managed-postgres/walshadow/sync-landing.webp" />

<Steps>
  <Step title="اختيار محرك النسخ المتماثل" id="select-replication-engine">
    اختر **WalShadow** كمحرك للنسخ المتماثل، ثم انقر على **Next**.

    <Image img="https://mintcdn.com/private-7c7dfe99/1IUPNo0kgSNuyelj/images/managed-postgres/walshadow/select-engine.webp?fit=max&auto=format&n=1IUPNo0kgSNuyelj&q=85&s=4c8138e85677394c695cc11a9455730b" alt="خطوة اختيار محرك النسخ المتماثل تعرض خياري ClickPipes وWalShadow مع تحديد WalShadow" size="md" border width="3680" height="2392" data-path="images/managed-postgres/walshadow/select-engine.webp" />
  </Step>

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

    * **خدمة ClickHouse**: اختر خدمة ClickHouse موجودة أو أنشئ واحدة جديدة
    * **Postgres database**: اختر قاعدة البيانات المصدر التي سيجري النسخ المتماثل منها، أو أنشئ واحدة جديدة
    * **طريقة النسخ المتماثل**: اختر أحد الخيارات التالية:
      * **Initial load + CDC**: استيراد البيانات الموجودة وإبقاء الجداول محدَّثة بالتغييرات الجديدة (موصى به)
      * **Initial load only**: استيراد لمرة واحدة للبيانات الموجودة دون أي تحديثات مستمرة
      * **CDC only**: تخطي الاستيراد الأولي والاكتفاء بالتقاط التغييرات الجديدة من هذه النقطة فصاعدًا

    <Image img="https://mintcdn.com/private-7c7dfe99/1IUPNo0kgSNuyelj/images/managed-postgres/walshadow/configure-service.webp?fit=max&auto=format&n=1IUPNo0kgSNuyelj&q=85&s=df2a577cb52e60eefc1fca5f887492f6" alt="خطوة تهيئة خدمة النسخ المتماثل تعرض خيارات خدمة ClickHouse وقاعدة بيانات Postgres وطريقة النسخ المتماثل" size="md" border width="3680" height="2392" data-path="images/managed-postgres/walshadow/configure-service.webp" />

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

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

    * **Destination database**: اختر قاعدة بيانات ClickHouse موجودة أو أنشئ واحدة جديدة
    * **Tables**: وسّع كل schema واختر جداول فردية، أو فعّل **Select all tables**. ويمكنك لكل جدول تخصيص **Destination table name** وضبط **Column settings**.
    * **مستخدم ClickHouse** و**ClickHouse password**: يتصل `WalShadow` بـ خدمة ClickHouse الهدف مباشرةً، لذا يحتاج إلى credentials تمتلك permission لإنشاء قاعدة البيانات الهدف والجداول.

    <Image img="https://mintcdn.com/private-7c7dfe99/1IUPNo0kgSNuyelj/images/managed-postgres/walshadow/select-tables.webp?fit=max&auto=format&n=1IUPNo0kgSNuyelj&q=85&s=03d6e3f80a706c99f2082408ba3e7832" alt="خطوة اختيار الجداول تعرض تحديد الـ schema والجداول وأسماء الجداول الهدف وcredentials الخاصة بـ ClickHouse" size="md" border width="3680" height="2392" data-path="images/managed-postgres/walshadow/select-tables.webp" />

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

  <Step title="مراقبة WalShadow" id="monitor-walshadow">
    بعد بدء النسخ المتماثل، يظهر `WalShadow` في صفحة **Sync to ClickHouse**. وتكون حالته **Creating** ريثما يجري تجهيز خط أنابيب بيانات وإعداد الـ initial load.

    <Image img="https://mintcdn.com/private-7c7dfe99/1IUPNo0kgSNuyelj/images/managed-postgres/walshadow/walshadow-creating.webp?fit=max&auto=format&n=1IUPNo0kgSNuyelj&q=85&s=caead405c1e77d03f529034584be0289" alt="صفحة Sync to ClickHouse تعرض WalShadow في حالة Creating" size="md" border width="3680" height="2392" data-path="images/managed-postgres/walshadow/walshadow-creating.webp" />

    وبمجرد اكتمال التجهيز، تتغير الحالة إلى **Running**، وتعرض الصفحة metrics حية للنسخ المتماثل:

    * **Status**: الحالة الراهنة لخط أنابيب بيانات (مثل `Running`)
    * **Rows synced**: إجمالي عدد الصفوف المنسوخة إلى ClickHouse
    * **Backfills pending**: عدد الجداول التي لا تزال بانتظار الـ initial load الخاص بها
    * **Lag**: حجم بيانات WAL التي لم تُطبَّق بعد
    * **Lag time**: مقدار تأخر الوجهة حاليًا عن Postgres
    * **Uptime**: المدة التي ظل فيها خط أنابيب بيانات قيد التشغيل
    * **Last updated**: وقت آخر تحديث للـ metrics

    <Image img="https://mintcdn.com/private-7c7dfe99/1IUPNo0kgSNuyelj/images/managed-postgres/walshadow/walshadow-running.webp?fit=max&auto=format&n=1IUPNo0kgSNuyelj&q=85&s=2bb2a79206e83ac4ef801f944b97602f" alt="صفحة Sync to ClickHouse تعرض WalShadow في حالة Running مع metrics الصفوف المتزامنة والتأخر ومدة التشغيل" size="md" border width="3680" height="2392" data-path="images/managed-postgres/walshadow/walshadow-running.webp" />
  </Step>
</Steps>

<h2 id="caveats">
  محاذير
</h2>

بعض الأمور التي ينبغي أخذها في الحسبان ما دام `WalShadow` في مرحلة Private Preview:

* `WalShadow` واحد فقط لكل خدمة Postgres في الوقت الحالي.
* العمليات (Operations) والمزيد من الـ metrics التفصيلية مدرجة ضمن خارطة الطريق (roadmap).
