> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# الترحيل إلى Managed Postgres باستخدام ClickHouse Cloud
> تعرّف على كيفية ترحيل قاعدة بيانات PostgreSQL الخاصة بك إلى ClickHouse Managed Postgres باستخدام معالج استيراد مصادر البيانات المضمّن في ClickHouse Cloud.
export const Image = ({img, alt, size}) => {
return
;
};
export const galaxyOnClick = eventName => () => {
try {
if (typeof window !== "undefined" && window.galaxy && eventName) {
window.galaxy.track(eventName, {
interaction: "click"
});
}
} catch (e) {}
};
export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
if (link) {
return
Beta
;
}
return ;
};
يتضمن ClickHouse Cloud معالج استيراد مضمّنًا ينقل قاعدة بيانات PostgreSQL الخارجية لديك إلى خدمة Managed Postgres. ويتولى هذا المعالج الاتصال بالمصدر، وتصدير المخطط واستيراده، وإعدادات النسخ المتماثل، واختيار الجداول، عبر خمس خطوات موجَّهة.
## المتطلبات الأساسية
* إمكانية الوصول إلى قاعدة بيانات PostgreSQL المصدر لديك باستخدام مستخدم لديه صلاحيات النسخ المتماثل.
* خدمة ClickHouse Managed Postgres كوجهة لعملية الترحيل. إذا لم تكن لديك واحدة بعد، فراجع [دليل البدء السريع](/ar/products/managed-postgres/quickstart).
* تثبيت `pg_dump` و`psql` على جهازك المحلي. يأتي كلاهما ضمن أدوات عميل PostgreSQL القياسية.
## اعتبارات قبل الترحيل
* **نشر تغييرات DDL**: يلتقط النسخ المستمر (CDC) عمليات DML و`ADD COLUMN`. أما تغييرات DDL الأخرى، مثل `DROP COLUMN` و`ALTER COLUMN`، فلا يتم نشرها ويجب تطبيقها يدويًا على الجهة الهدف.
## الخطوة 1: الاتصال بقاعدة بيانات المصدر
افتح [ClickHouse Cloud console](https://clickhouse.cloud) وحدد خدمة Managed Postgres الخاصة بك.
في الشريط الجانبي الأيسر، انقر على **مصادر البيانات**.
انقر على **Start import**.
أدخل تفاصيل الاتصال بقاعدة بيانات PostgreSQL المصدر: المضيف، والمنفذ، واسم المستخدم، وكلمة المرور، واسم قاعدة البيانات. فعّل **TLS** إذا كانت قاعدة البيانات المصدر تتطلب ذلك.
إذا كنت بحاجة إلى اتصال خاص بقاعدة بيانات المصدر، يمكنك اختيار **SSH tunneling** وإدخال تفاصيل SSH المطلوبة. يتيح ذلك لعملية الترحيل الاتصال بأمان بقواعد البيانات غير المتاحة عبر الإنترنت العام.
اختر طريقة الإدخال:
* **Initial load + CDC** — ينسخ البيانات الحالية أولًا، ثم يُبقي الوجهة متزامنة مع التغييرات اللاحقة.
* **Initial load only** — نسخ لمرة واحدة فقط، من دون تكرار مستمر.
* **CDC only** — يتجاوز النسخ الأولي ويكرّر فقط التغييرات الجديدة من هذه النقطة فصاعدًا.
انقر على **Next**.
## الخطوة 2: صدّر مخطط قاعدة بياناتك
يعرض المعالج أمر `pg_dump` مُعبّأً مسبقًا بتفاصيل اتصال المصدر. شغّله في الطرفية:
```shell theme={null}
pg_dump \
-h \
-U \
-d \
--schema-only \
-f pg.sql
```
سيُنشئ هذا الملف `pg.sql` في الدليل الحالي.
انقر على **التالي**.
## الخطوة 3: استيراد المخطط إلى خدمة Managed Postgres الخاصة بك
اختر قاعدة البيانات الوجهة من القائمة المنسدلة، أو انقر على **إنشاء قاعدة بيانات جديدة** لإنشاء واحدة.
يعرض المعالج أمر `psql` لتطبيق ملف تفريغ المخطط على خدمة Managed Postgres الخاصة بك. شغِّله في الطرفية:
```shell theme={null}
psql \
-h \
-p 5432 \
-U \
-d \
-f pg.sql
```
انقر على **Next**.
## الخطوة 4: ضبط إعدادات الإدخال
حدّد الـ publication المطلوب استخدامه للنسخ المتماثل المنطقي. إذا تركت هذا الحقل فارغًا، فسيتم إنشاء publication تلقائيًا.
وسّع **إعدادات النسخ المتماثل المتقدمة** لضبط معدل النقل:
| الإعداد | الافتراضي | الوصف |
| -------------------------------------- | --------- | ----------------------------------------------- |
| فترة المزامنة (بالثواني) | 10 | مدى تكرار استطلاع replication slot |
| الخيوط المتوازية للتحميل الأولي | 4 | عدد الخيوط المستخدمة في مرحلة النسخ المجمّع |
| حجم دفعة السحب | 100,000 | عدد الصفوف التي يتم جلبها في كل دفعة نسخ متماثل |
| عدد الصفوف في اللقطة لكل partition | 100000 | حجم partition للقطات الجداول الكبيرة |
| عدد الجداول التي تؤخذ لقطاتها بالتوازي | 1 | الجداول التي تؤخذ لقطاتها بشكل متزامن |
انقر **التالي**.
## الخطوة 5: حدِّد الجداول
حدِّد الجداول التي تريد مزامنتها. الجداول مُجمَّعة حسب المخططات. حدِّد جداول فردية أو وسِّع مخططًا لاختيارها جميعًا.
انقر على **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، فاحذف replication slot من المصدر لتحرير الموارد:
```sql theme={null}
SELECT pg_drop_replication_slot('');
```
## الخطوات التالية
* [دليل البدء السريع لـ Managed Postgres](/ar/products/managed-postgres/quickstart)
* [تفاصيل الاتصال بـ Managed Postgres](/ar/products/managed-postgres/connection)
* [الأسئلة الشائعة حول Postgres في ClickPipes](/ar/integrations/clickpipes/postgres/faq)