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

> إعداد مثيل Neon Postgres ليكون مصدرًا لـ ClickPipes

# دليل إعداد مصدر Neon Postgres

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

هذا دليل يوضح كيفية إعداد Neon Postgres، والذي يمكنك استخدامه للنسخ المتماثل في ClickPipes.
تأكد من أنك مسجّل الدخول إلى [وحدة تحكم Neon](https://console.neon.tech/app/projects) لإتمام هذا الإعداد.

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

اتصل بمثيل Neon الخاص بك باستخدام مستخدم مسؤول، ثم نفّذ الأوامر التالية:

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

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

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

   ```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. امنح المستخدم امتيازات النسخ المتماثل:

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

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

<Warning>
  يجب أن يكون لكل جدول مُدرج في الـ publication إما **مفتاح أساسي** معرّف، *أو* أن تكون **هوية النسخة المتماثلة** له مضبوطة على `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 لجميع الجداول ضمن مخطط محدد:

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

سيحتوي الـ publication المسمى `clickpipes` على مجموعة أحداث التغيير الناتجة من الجداول المحددة، وسيُستخدم لاحقًا لإدخال دفق النسخ المتماثل.

<div id="enable-logical-replication">
  ## تمكين النسخ المتماثل المنطقي
</div>

في Neon، يمكنك تمكين النسخ المتماثل المنطقي عبر واجهة المستخدم. وهذا ضروري لكي يتمكن CDC في ClickPipes من إجراء نسخ متماثل للبيانات.
انتقل إلى تبويب **Settings** ثم إلى قسم **Logical Replication**.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/Kmm8X3tBno--Vzxh/images/integrations/data-ingestion/clickpipes/postgres/source/setup/neon-postgres/neon-enable-replication.png?fit=max&auto=format&n=Kmm8X3tBno--Vzxh&q=85&s=b72b3e8a601419e8869f9ab39b8a3b78" alt="تمكين النسخ المتماثل المنطقي" border width="3414" height="1336" data-path="images/integrations/data-ingestion/clickpipes/postgres/source/setup/neon-postgres/neon-enable-replication.png" />

انقر على **Enable** لإتمام الإعداد هنا. وبمجرد تمكينه، ينبغي أن تظهر لك رسالة النجاح أدناه.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/Kmm8X3tBno--Vzxh/images/integrations/data-ingestion/clickpipes/postgres/source/setup/neon-postgres/neon-enabled-replication.png?fit=max&auto=format&n=Kmm8X3tBno--Vzxh&q=85&s=f2368c52700f405e1b4e8e80c920cd0b" alt="تم تمكين النسخ المتماثل المنطقي" border width="3414" height="1336" data-path="images/integrations/data-ingestion/clickpipes/postgres/source/setup/neon-postgres/neon-enabled-replication.png" />

لنتحقق من الإعدادات التالية في مثيل Neon Postgres لديك:

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

<div id="ip-whitelisting-for-neon-enterprise-plan">
  ## إدراج عناوين IP في قائمة السماح (لخطة Neon Enterprise)
</div>

إذا كانت لديك خطة Neon Enterprise، فيمكنك إدراج [ClickPipes IPs](/ar/integrations/clickpipes/home#list-of-static-ips) في قائمة السماح لتمكين النسخ المتماثل من ClickPipes إلى مثيل Neon Postgres الخاص بك.
للقيام بذلك، انقر على علامة التبويب **Settings** ثم انتقل إلى قسم **IP Allow**.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/Kmm8X3tBno--Vzxh/images/integrations/data-ingestion/clickpipes/postgres/source/setup/neon-postgres/neon-ip-allow.png?fit=max&auto=format&n=Kmm8X3tBno--Vzxh&q=85&s=8f7d91f7b936653f6667b9e50787cdba" alt="شاشة السماح لعناوين IP" border width="2184" height="1184" data-path="images/integrations/data-ingestion/clickpipes/postgres/source/setup/neon-postgres/neon-ip-allow.png" />

<div id="copy-connection-details">
  ## انسخ تفاصيل الاتصال
</div>

الآن بعد أن أصبح لدينا المستخدم، وأصبحت الـ publication جاهزة، وأصبح النسخ المتماثل مفعّلًا، يمكننا نسخ تفاصيل الاتصال لإنشاء ClickPipe جديد.
توجّه إلى **Dashboard**، وفي مربع النص الذي يعرض سلسلة الاتصال،
غيّر طريقة العرض إلى **Parameters Only**. سنحتاج إلى هذه المعلمات في الخطوة التالية.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/Kmm8X3tBno--Vzxh/images/integrations/data-ingestion/clickpipes/postgres/source/setup/neon-postgres/neon-conn-details.png?fit=max&auto=format&n=Kmm8X3tBno--Vzxh&q=85&s=e039f19f686ccd27200f07ad5f59d1e1" alt="تفاصيل الاتصال" border width="1932" height="1438" data-path="images/integrations/data-ingestion/clickpipes/postgres/source/setup/neon-postgres/neon-conn-details.png" />

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

يمكنك الآن [إنشاء ClickPipe الخاص بك](/ar/integrations/clickpipes/postgres/index) والبدء في إدخال البيانات من مثيل Postgres الخاص بك إلى ClickHouse Cloud.
احرص على تدوين تفاصيل الاتصال التي استخدمتها أثناء إعداد مثيل Postgres، إذ ستحتاج إليها خلال عملية إنشاء ClickPipe.
