> ## 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.
# رحّل بيانات PostgreSQL باستخدام مصادر البيانات في ClickPipes
> تعرّف على كيفية ترحيل قاعدة بيانات PostgreSQL إلى ClickHouse Managed Postgres باستخدام ClickPipes.
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return ;
};
export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
if (link) {
return
Beta
;
}
return ;
};
يوفّر ClickHouse Cloud الآن ClickPipes لترحيل قاعدة بيانات PostgreSQL الخارجية لديك إلى خدمة Managed Postgres. يوفّر هذا التكامل المضمّن تجربة سلسة للاتصال بقاعدة بياناتك المصدرية، وتصدير المخطط، واستيراده إلى Managed Postgres، وإعداد النسخ المتماثل المستمر.
## المتطلبات المسبقة
* إمكانية الوصول إلى قاعدة بيانات PostgreSQL المصدر باستخدام مستخدم لديه صلاحيات النسخ المتماثل. اتبع دليل الإعداد الخاص بالمصدر الذي تستخدمه:
* [Amazon RDS Postgres](/docs/ar/integrations/clickpipes/postgres/source/rds)
* [Amazon Aurora Postgres](/docs/ar/integrations/clickpipes/postgres/source/aurora)
* [Supabase Postgres](/docs/ar/integrations/clickpipes/postgres/source/supabase)
* [Google Cloud SQL Postgres](/docs/ar/integrations/clickpipes/postgres/source/google-cloudsql)
* [Azure Flexible Server for Postgres](/docs/ar/integrations/clickpipes/postgres/source/azure-flexible-server-postgres)
* [Neon Postgres](/docs/ar/integrations/clickpipes/postgres/source/neon-postgres)
* [Crunchy Bridge Postgres](/docs/ar/integrations/clickpipes/postgres/source/crunchy-postgres)
* [TimescaleDB](/docs/ar/integrations/clickpipes/postgres/source/timescale)
* [مصدر Postgres عام](/docs/ar/integrations/clickpipes/postgres/source/generic) لأي مزوّد آخر أو لأي مثيل مستضاف ذاتيًا
* خدمة ClickHouse Managed Postgres لتكون هدف الترحيل. إذا لم تكن لديك واحدة بعد، فراجع [دليل البدء السريع](/docs/ar/products/managed-postgres/quickstart).
* يجب أن يكون `pg_dump` و`psql` مثبَّتين على جهازك المحلي. يأتي كلاهما ضمن أدوات PostgreSQL client القياسية.
## اعتبارات قبل الترحيل
* **نشر تغييرات DDL**: يلتقط النسخ المتماثل المستمر (CDC) عمليات DML و`ADD COLUMN`. أما تغييرات DDL الأخرى، مثل `DROP COLUMN` و`ALTER COLUMN`، فلا تُنقل ويجب تطبيقها يدويًا على النظام الهدف.
إذا واجهت مشكلات أثناء الترحيل، فراجع [الأسئلة الشائعة حول عمليات ترحيل Managed Postgres](/docs/ar/products/managed-postgres/migrations/faq) للاطلاع على الأخطاء الشائعة وحلولها.
افتح [ClickHouse Cloud console](https://clickhouse.cloud) وحدد خدمة Managed Postgres الخاص بك.
في الشريط الجانبي الأيسر، انقر على **مصادر البيانات**.
انقر على **بدء الاستيراد**.
أدخِل تفاصيل الاتصال بقاعدة بيانات PostgreSQL المصدر: المضيف، والمنفذ، واسم المستخدم، وكلمة المرور، واسم قاعدة البيانات. فعِّل **TLS** إذا كان المصدر يتطلب ذلك.
إذا كنت بحاجة إلى اتصال خاص بقاعدة البيانات المصدر، يمكنك اختيار **SSH tunneling** وتقديم تفاصيل SSH اللازمة. يتيح ذلك لعملية الترحيل الاتصال بأمان بقواعد البيانات غير المتاحة علنًا.
اختر طريقة الإدخال:
* **التحميل الأولي + CDC** — ينسخ البيانات الحالية، ثم يُبقي الوجهة متزامنة مع التغييرات المستمرة.
* **التحميل الأولي فقط** — نسخة لمرة واحدة، من دون نسخ متماثل مستمر.
* **CDC فقط** — يتخطى النسخة الأولية ويُجري نسخًا متماثلًا للتغييرات الجديدة فقط بدءًا من هذه النقطة.
انقر على **التالي**.
يعرض المعالج أمر `pg_dump` مُعبّأ مسبقًا بتفاصيل الاتصال بالمصدر. شغّله في الطرفية:
```shell theme={null}
pg_dump \
-h \
-U \
-d \
--schema-only \
-f pg.sql
```
يؤدي ذلك إلى إنشاء الملف `pg.sql` في الدليل الحالي.
انقر على **التالي**.
حدد قاعدة البيانات الهدف من القائمة المنسدلة، أو انقر على **Create a new database** لإنشاء واحدة جديدة.
يعرض المعالج أمر `psql` لتطبيق ملف تفريغ المخطط على خدمة Managed Postgres الخاصة بك. شغّله في الطرفية:
```shell theme={null}
psql \
-h \
-p 5432 \
-U \
-d \
-f pg.sql
```
انقر على **التالي**.
حدّد الـ publication المراد استخدامها للنسخ المتماثل المنطقي. إذا تركت هذا الحقل فارغًا، فسيتم إنشاء publication تلقائيًا.
وسّع **Advanced replication settings** لضبط معدل النقل:
| Setting | Default | Description |
| ------------------------------------- | ------- | ----------------------------------------------- |
| Sync interval (seconds) | 10 | عدد مرات الاستعلام عن فتحة النسخ المتماثل |
| Parallel threads for initial load | 4 | عدد الخيوط لمرحلة النسخ المجمّع |
| Pull batch size | 100,000 | عدد الصفوف التي يتم جلبها في كل دفعة نسخ متماثل |
| Snapshot number of rows per partition | 100000 | حجم partition للّقطات الخاصة بالجداول الكبيرة |
| Snapshot number of tables in parallel | 1 | عدد الجداول التي تؤخذ لقطاتها بالتوازي |
انقر على **التالي**.
حدد الجداول التي تريد نسخها متماثلًا. تُجمَّع الجداول بحسب المخطط. حدد جداول فردية أو وسّع مخططًا لاختيارها جميعًا.
انقر على **Create migration**.
## راقب الترحيل
بعد إنشاء الترحيل، ستجده مُدرجًا في **مصادر البيانات** بالحالة **قيد التشغيل**.
انقر على الترحيل لفتح العرض التفصيلي. تعرض علامة التبويب **الجداول** تقدّم التحميل الأوّلي لكل جدول، بما في ذلك الصفوف المُعالجة، والأقسام، ومتوسط الوقت لكل قسم. وتعرض علامة التبويب **المقاييس** تأخر النسخ المتماثل ومعدل النقل بمجرد بدء CDC.
## مهام ما بعد الترحيل
بمجرد اكتمال التحميل الأولي، وإذا كنت تستخدم CDC، واقترب تأخر النسخ المتماثل من الصفر:
**تحقق من عدد الصفوف.** أجرِ مراجعة سريعة للجداول المهمة في كلٍّ من المصدر والهدف قبل تحويل حركة المرور:
```sql theme={null}
SELECT COUNT(*) FROM public.orders;
```
**أوقِف عمليات الكتابة على المصدر.** أوقِف عمليات كتابة التطبيق مؤقتًا. لفرض وضع القراءة فقط أثناء مرحلة التحويل:
```sql theme={null}
ALTER DATABASE SET default_transaction_read_only = on;
```
**تأكّد من اكتمال تزامن النسخ المتماثل.** قارن أحدث صف في كلٍّ من المصدر والهدف:
```sql theme={null}
-- Run on both source and target
SELECT MAX(id), MAX(updated_at) FROM public.orders;
```
**أعِد ضبط التسلسلات.** اضبط التسلسلات لتتوافق مع القيم القصوى الحالية في كل جدول:
```sql theme={null}
DO $$
DECLARE r RECORD;
BEGIN
FOR r IN
SELECT
n.nspname AS schema_name,
c.relname AS table_name,
a.attname AS column_name,
pg_get_serial_sequence(format('%I.%I', n.nspname, c.relname), a.attname) AS seq_name
FROM pg_class c
JOIN pg_namespace n ON n.oid = c.relnamespace
JOIN pg_attribute a ON a.attrelid = c.oid
WHERE c.relkind = 'r'
AND a.attnum > 0
AND NOT a.attisdropped
AND n.nspname NOT IN ('pg_catalog', 'information_schema')
LOOP
IF r.seq_name IS NOT NULL THEN
EXECUTE format(
'SELECT setval(%L, COALESCE((SELECT MAX(%I) FROM %I.%I), 0) + 1, false)',
r.seq_name, r.column_name, r.schema_name, r.table_name
);
END IF;
END LOOP;
END $$;
```
**حوِّل حركة مرور التطبيق.** وجِّه عمليات القراءة والكتابة إلى خدمة Managed Postgres لديك، وراقب الأخطاء ومخالفات القيود وسلامة النسخ المتماثل.
**نظِّف.** بمجرد إتمام التحويل والتأكد من أن الخدمة الجديدة سليمة، احذف عملية الترحيل من **مصادر البيانات**. إذا كنت قد استخدمت CDC، فاحذف فتحة النسخ المتماثل من المصدر لتحرير الموارد:
```sql theme={null}
SELECT pg_drop_replication_slot('');
```
## الخطوات التالية
* [البدء السريع لـ Managed Postgres](/docs/ar/products/managed-postgres/quickstart)
* [تفاصيل الاتصال بـ Managed Postgres](/docs/ar/products/managed-postgres/connection)
* [الأسئلة الشائعة حول Postgres في ClickPipes](/docs/ar/integrations/clickpipes/postgres/faq)