> ## 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 Managed Postgres كمصدر لـ ClickPipes

# دليل إعداد مصدر ClickHouse Managed Postgres

[ClickHouse Managed Postgres](/ar/products/managed-postgres/overview) هي خدمة Postgres مُدارة بالكامل في ClickHouse Cloud، وهي أسرع مصادر Postgres في الاتصال بـ ClickPipes: فالنسخ المتماثل المنطقي مُفعَّل على كل instance، وعناوين IP الخاصة بـ ClickPipes مسموح بها افتراضيًا، وتفاصيل الاتصال متاحة في نفس الكونسول الذي تُدار فيه خدمة ClickHouse الخاصة بك.

هناك طريقتان لبدء النسخ المتماثل من instance تابع لـ ClickHouse Managed Postgres، وكلتاهما تُنشئ ClickPipe عاديًا لـ Postgres، لذا ينطبق كل ما ورد في [توثيق Postgres ClickPipe](/ar/integrations/clickpipes/postgres/index) بمجرد أن يبدأ الـ pipe في العمل.

<h2 id="sync-to-clickhouse">
  الخيار 1: المزامنة إلى ClickHouse من خدمة Postgres
</h2>

افتح خدمة ClickHouse Managed Postgres الخاصة بك في كونسول ClickHouse Cloud وانقر على **Sync to ClickHouse** في الشريط الجانبي. يملأ المعالج بيانات اتصال المصدر تلقائيًا، ويتيح لك اختيار destination خدمة ClickHouse وطريقة النسخ المتماثل والجداول المراد نسخها. ولا يتطلب ذلك إعداد أي USER أو publication أو شبكة.

اتبع دليل [Sync to ClickHouse](/ar/products/managed-postgres/sync-to-clickhouse/clickpipes) للحصول على شرح تفصيلي خطوة بخطوة. وللحصول على النسخ المتماثل بزمن استجابة منخفض، يمكنك أيضًا اختيار [WalShadow](/ar/products/managed-postgres/sync-to-clickhouse/walshadow)، وهو engine للنسخ المتماثل native يقرأ على مستوى نظام الملفات، وهو متاح حاليًا في private preview.

<h2 id="clickpipes-source">
  الخيار 2: اختيار ClickHouse Managed Postgres كمصدر في ClickPipes
</h2>

إذا كنت تفضّل البدء من جهة الوجهة، فافتح خدمة ClickHouse الخاصة بك، وانتقل إلى **Data Sources**، ثم اختر **ClickHouse Managed Postgres** من قائمة المصادر. بعدها أدخل تفاصيل الاتصال الخاصة بـ Postgres instance لديك، كما تفعل مع أي مصدر Postgres آخر.

<h3 id="connection-details">
  تفاصيل الاتصال
</h3>

افتح خدمة ClickHouse Managed Postgres وانقر على **Connect** لعرض المضيف والمنفذ وقاعدة البيانات والمستخدم وكلمة المرور. استخدم اتصال Postgres المباشر، وليس خيار **via PgBouncer**، إذ لا يدعم ClickPipes النسخ المتماثل عبر PgBouncer أو أي مجمّع اتصالات آخر. راجع [Connection](/ar/products/managed-postgres/connection) للمزيد من التفاصيل.

<h3 id="creating-a-user-with-permissions">
  إنشاء مستخدم مع الأذونات
</h3>

يمكنك الاتصال باستخدام المستخدم الافتراضي `postgres`. أما في بيئة الإنتاج فنوصي بمستخدم replication مخصص للقراءة فقط، تمامًا كما هو الحال مع أي مصدر Postgres آخر. اتصل بالـ instance الخاص بك عبر `psql` ثم نفّذ:

1. أنشئ مستخدمًا مخصصًا لـ ClickPipes:

   ```sql theme={null}
   CREATE USER clickpipes_user PASSWORD 'some-password';
   ```

2. امنح المستخدم صلاحية وصول للقراءة فقط على مستوى الـ schema. يوضح المثال التالي الأذونات الخاصة بالـ schema المسمى `public`. كرّر هذه الأوامر لكل schema يحتوي على جداول ترغب في نسخها:

   ```sql theme={null}
   GRANT USAGE ON SCHEMA "public" TO clickpipes_user;
   GRANT SELECT ON ALL TABLES IN SCHEMA "public" TO clickpipes_user;
   ALTER DEFAULT PRIVILEGES IN SCHEMA "public" GRANT SELECT ON TABLES TO clickpipes_user;
   ```

3. امنح المستخدم صلاحيات الـ replication:

   ```sql theme={null}
   ALTER USER clickpipes_user WITH REPLICATION;
   ```

4. أنشئ [publication](https://www.postgresql.org/docs/current/logical-replication-publication.html) يتضمن الجداول التي ترغب في نسخها. ونوصي بشدة بأن تُضمّن في الـ publication الجداول التي تحتاجها فقط، تجنبًا للأعباء الإضافية على الأداء.

<Warning>
  يجب أن يكون لأي جدول مُضمَّن في الـ publication إما **primary key** معرّف *أو* أن تكون **replica identity** الخاصة به مهيّأة على `FULL`. راجع [أسئلة Postgres الشائعة](/ar/integrations/clickpipes/postgres/faq#how-should-i-scope-my-publications-when-setting-up-replication) للاطلاع على إرشادات تحديد النطاق.
</Warning>

* لإنشاء publication لجداول محددة:

  ```sql theme={null}
  CREATE PUBLICATION clickpipes FOR TABLE table_to_replicate, table_to_replicate2;
  ```

  * لإنشاء publication لجميع الجداول في schema محدد:

    ```sql theme={null}
    CREATE PUBLICATION clickpipes FOR TABLES IN SCHEMA "public";
    ```

<h3 id="logical-replication">
  النسخ المتماثل المنطقي (النسخ المتماثل المنطقي)
</h3>

النسخ المتماثل المنطقي مُفعَّل مسبقًا على كل instance من ClickHouse Managed Postgres. ولا يوجد إعداد `wal_level` أو parameter group يحتاج إلى تغيير. ويمكنك التحقق من ذلك بواسطة:

```sql theme={null}
SHOW wal_level; -- should be logical
```

<h3 id="network-access">
  الوصول عبر الشبكة
</h3>

يقبل ClickHouse Managed Postgres الاتصالات من ClickPipes افتراضيًا. أما إذا كنت قد هيّأت [IP filters](/ar/products/managed-postgres/security#ip-whitelisting) على خدمة Postgres الخاصة بك، فأضف [عناوين IP الثابتة الخاصة بـ ClickPipes](/ar/integrations/clickpipes/networking/static-ips) للمنطقة التي يوجد بها **خدمة ClickHouse** إلى قائمة العناوين المسموح بها.

<h3 id="tls">
  TLS
</h3>

تُقدّم instances الخاصة بـ ClickHouse Managed Postgres شهادة موقّعة من CA فريدة لكل instance وغير موثوقة علنًا. ويكون التحقق من الشهادة مُمكّنًا افتراضيًا في ClickPipes، لذا يفشل فحص الاتصال إلى أن تقوم بأحد الإجراءين التاليين:

* تنزيل حزمة شهادة CA من علامة التبويب **Settings** في خدمة Postgres الخاصة بك وتوفيرها عبر **Upload CA** في إعدادات اتصال ClickPipe. وهذا هو الخيار الموصى به. راجع [اتصال TLS مُتحقَّق منه](/ar/products/managed-postgres/connection#verified-tls) لمعرفة مكان الحصول على الحزمة.
* تفعيل **Skip certificate verification** في إعدادات اتصال ClickPipe. يبقى الاتصال مشفّرًا، لكن دون التحقق من هوية server.

إذا أنشأت pipe باستخدام `clickhousectl`، فاحصل على الحزمة ومرّرها عبر `--ca-certificate`:

```bash theme={null}
clickhousectl cloud postgres certs get <postgres-service-id> --output pg-ca.pem
```

<h2 id="whats-next">
  ما الخطوة التالية؟
</h2>

يمكنك الآن [إنشاء ClickPipe الخاص بك](/ar/integrations/clickpipes/postgres/index) والبدء في استيعاب البيانات من instance الخاص بـ ClickHouse Managed Postgres إلى ClickHouse Cloud. ويُتاح Native CDC من ClickHouse Managed Postgres إلى ClickHouse دون أي تكلفة إضافية؛ راجع [الأسعار](/ar/products/managed-postgres/pricing) لمزيد من التفاصيل.
