> ## 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

معاينة خاصة

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

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

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

![صفحة نظرة عامة على خدمة Postgres تعرض لافتة المعاينة الخاصة لـ WalShadow مع روابط معرفة المزيد وتهيئة WalShadow](https://mintcdn.com/private-7c7dfe99/1IUPNo0kgSNuyelj/images/managed-postgres/walshadow/overview-banner.webp?fit=max\&auto=format\&n=1IUPNo0kgSNuyelj\&q=85\&s=868266fa6f2514dcdbdaef9696e53327)

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

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

![صفحة الوصول الخاصة بـ Sync to ClickHouse تعرض طريقتَي النسخ المتماثل ClickPipes وWalShadow](https://mintcdn.com/private-7c7dfe99/1IUPNo0kgSNuyelj/images/managed-postgres/walshadow/sync-landing.webp?fit=max\&auto=format\&n=1IUPNo0kgSNuyelj\&q=85\&s=5932d900f2bd6438fa1ce524a3bc7979)

**1. اختيار محرك النسخ المتماثل**

اختر **WalShadow** كمحرك للنسخ المتماثل، ثم انقر على **Next**.

![خطوة اختيار محرك النسخ المتماثل تعرض خياري ClickPipes وWalShadow مع تحديد WalShadow](https://mintcdn.com/private-7c7dfe99/1IUPNo0kgSNuyelj/images/managed-postgres/walshadow/select-engine.webp?fit=max\&auto=format\&n=1IUPNo0kgSNuyelj\&q=85\&s=4c8138e85677394c695cc11a9455730b)

**2. تهيئة خدمة النسخ المتماثل**

املأ إعدادات النسخ المتماثل:

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

![خطوة تهيئة خدمة النسخ المتماثل تعرض خيارات خدمة ClickHouse وقاعدة بيانات Postgres وطريقة النسخ المتماثل](https://mintcdn.com/private-7c7dfe99/1IUPNo0kgSNuyelj/images/managed-postgres/walshadow/configure-service.webp?fit=max\&auto=format\&n=1IUPNo0kgSNuyelj\&q=85\&s=df2a577cb52e60eefc1fca5f887492f6)

انقر على **Next** للمتابعة.

**3. اختيار الجداول المراد نسخها**

اختر قاعدة بيانات هدف وحدد الجداول التي تريد نسخها:

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

![خطوة اختيار الجداول تعرض تحديد الـ schema والجداول وأسماء الجداول الهدف وcredentials الخاصة بـ ClickHouse](https://mintcdn.com/private-7c7dfe99/1IUPNo0kgSNuyelj/images/managed-postgres/walshadow/select-tables.webp?fit=max\&auto=format\&n=1IUPNo0kgSNuyelj\&q=85\&s=03d6e3f80a706c99f2082408ba3e7832)

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

**4. مراقبة WalShadow**

بعد بدء النسخ المتماثل، يظهر `WalShadow` في صفحة **Sync to ClickHouse**. وتكون حالته **Creating** ريثما يجري تجهيز خط أنابيب بيانات وإعداد الـ initial load.

![صفحة Sync to ClickHouse تعرض WalShadow في حالة Creating](https://mintcdn.com/private-7c7dfe99/1IUPNo0kgSNuyelj/images/managed-postgres/walshadow/walshadow-creating.webp?fit=max\&auto=format\&n=1IUPNo0kgSNuyelj\&q=85\&s=caead405c1e77d03f529034584be0289)

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

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

![صفحة Sync to ClickHouse تعرض WalShadow في حالة Running مع metrics الصفوف المتزامنة والتأخر ومدة التشغيل](https://mintcdn.com/private-7c7dfe99/1IUPNo0kgSNuyelj/images/managed-postgres/walshadow/walshadow-running.webp?fit=max\&auto=format\&n=1IUPNo0kgSNuyelj\&q=85\&s=2bb2a79206e83ac4ef801f944b97602f)

## محاذير

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

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