الانتقال إلى المحتوى الرئيسي
يمكنك استخدام ClickPipes لاستيراد البيانات من قاعدة بيانات Postgres المصدر لديك إلى ClickHouse Cloud. ويمكن استضافة قاعدة بيانات Postgres المصدر ضمن بنيتك التحتية المحلية أو في السحابة، بما في ذلك Amazon RDS وGoogle Cloud SQL وAzure Database for Postgres وSupabase وغيرها. يمكن نشر Postgres ClickPipes وإدارتها يدويًا باستخدام واجهة مستخدم ClickPipes، وكذلك برمجيًا باستخدام OpenAPI وTerraform.

​
المتطلبات المسبقة

للبدء، عليك أولاً التأكد من أن قاعدة بيانات Postgres لديك مُعدّة بشكل صحيح. وبناءً على مثيل Postgres المصدر الذي تستخدمه، يمكنك اتباع أيٍّ من الأدلة التالية:
  1. Amazon RDS Postgres
  2. Amazon Aurora Postgres
  3. Supabase Postgres
  4. Google Cloud SQL Postgres
  5. Azure Flexible Server for Postgres
  6. Neon Postgres
  7. Crunchy Bridge Postgres
  8. مصدر Postgres عام، إذا كنت تستخدم أي موفّر Postgres آخر أو مثيلاً ذاتي الاستضافة.
  9. TimescaleDB، إذا كنت تستخدم امتداد TimescaleDB على خدمة مُدارة أو مثيلاً ذاتي الاستضافة.
وكلاء Postgres مثل PgBouncer وRDS Proxy وSupabase Pooler وغيرها غير مدعومين في النسخ المتماثل المعتمد على CDC. يُرجى التأكد من عدم استخدامها عند إعداد ClickPipes، واستخدام تفاصيل الاتصال الخاصة بقاعدة بيانات Postgres الفعلية بدلاً منها.
بمجرد إعداد قاعدة بيانات Postgres المصدر، يمكنك متابعة إنشاء ClickPipe.

​
إنشاء ClickPipe الخاص بك

تأكد من أنك مسجّل الدخول إلى حسابك في ClickHouse Cloud. إذا لم يكن لديك حساب بعد، يمكنك التسجيل هنا.
  1. في ClickHouse Cloud console، انتقل إلى خدمة ClickHouse Cloud الخاصة بك.
  1. حدِّد زر Data Sources من القائمة الجانبية اليسرى، ثم انقر على “Set up a ClickPipe”
  1. حدِّد مربع Postgres CDC

​
إضافة تفاصيل اتصال قاعدة بيانات Postgres المصدر

  1. أدخل تفاصيل الاتصال لقاعدة بيانات Postgres المصدر التي أعددتها في خطوة المتطلبات الأساسية.
قبل البدء في إضافة تفاصيل الاتصال، تأكد من أنك أدرجت عناوين IP الخاصة بـ ClickPipes ضمن قواعد جدار الحماية المسموح بها. يمكنك العثور على قائمة عناوين IP الخاصة بـ ClickPipes هنا. لمزيد من المعلومات، راجع أدلة إعداد Postgres المصدر المشار إليها في أعلى هذه الصفحة.
يمكنك استخدام AWS Private Link للاتصال بقاعدة بيانات Postgres المصدر إذا كانت مستضافة على AWS. ويكون ذلك مفيدًا إذا كنت ترغب في الحفاظ على خصوصية نقل البيانات. يمكنك اتباع دليل الإعداد لإعداد الاتصال.

​
(اختياري) إعداد نفق SSH

يمكنك تحديد تفاصيل نفق SSH إذا كانت قاعدة بيانات Postgres المصدر غير متاحة للوصول العام.
  1. فعِّل مفتاح التبديل “استخدام نفق SSH”.
  2. أدخِل تفاصيل اتصال SSH.
  3. لاستخدام المصادقة بالمفتاح، انقر على “إلغاء وإنشاء زوج مفاتيح” لإنشاء زوج مفاتيح جديد، ثم انسخ المفتاح العام الذي تم إنشاؤه إلى خادم SSH ضمن ~/.ssh/authorized_keys.
  4. انقر على “التحقق من الاتصال” للتحقق من الاتصال.
تأكد من السماح لـ عنوان IP الخاص بـ ClickPipes في قواعد جدار الحماية الخاصة بمضيف bastion الخاص بـ SSH، حتى يتمكن ClickPipes من إنشاء نفق SSH.
بعد إدخال تفاصيل الاتصال، انقر على “التالي”.

​
تكوين إعدادات النسخ المتماثل

  1. تأكد من اختيار replication slot من القائمة المنسدلة التي أنشأتها في خطوة المتطلبات الأساسية.

​
الإعدادات المتقدمة

يمكنك تهيئة الإعدادات المتقدمة عند الحاجة. يرد أدناه وصف موجز لكل إعداد:
  • فاصل المزامنة: هو الفاصل الزمني الذي ستقوم عنده ClickPipes باستطلاع قاعدة البيانات المصدر بحثًا عن التغييرات. ولهذا الإعداد تأثير على خدمة ClickHouse الوجهة، لذا نوصي المستخدمين الحريصين على التكلفة بالإبقاء على هذه القيمة مرتفعة (أكثر من 3600).
  • الخيوط المتوازية للتحميل الأولي: هذا هو عدد العاملين بالتوازي الذين سيُستخدمون لجلب اللقطة الأولية. ويكون هذا مفيدًا عندما يكون لديك عدد كبير من الجداول وتريد التحكم في عدد العاملين بالتوازي المستخدمين لجلب اللقطة الأولية. هذا الإعداد يكون لكل جدول.
  • حجم دفعة السحب: عدد الصفوف التي سيتم جلبها في دفعة واحدة. هذا إعداد يُطبَّق على أساس أفضل جهد، وقد لا يُلتزم به في جميع الحالات.
  • عدد الصفوف لكل قسم في اللقطة: هذا هو عدد الصفوف التي سيتم جلبها في كل قسم أثناء اللقطة الأولية. ويكون هذا مفيدًا عندما يكون لديك عدد كبير من الصفوف في جداولك وتريد التحكم في عدد الصفوف التي يتم جلبها في كل قسم.
  • عدد الجداول في اللقطة بالتوازي: هذا هو عدد الجداول التي سيتم جلبها بالتوازي أثناء اللقطة الأولية. ويكون هذا مفيدًا عندما يكون لديك عدد كبير من الجداول وتريد التحكم في عدد الجداول التي يتم جلبها بالتوازي.

​
إعداد الجداول

  1. هنا يمكنك تحديد قاعدة البيانات الوجهة لـ ClickPipe الخاص بك. يمكنك إما اختيار قاعدة بيانات موجودة أو إنشاء قاعدة بيانات جديدة.
  2. يمكنك تحديد الجداول التي تريد نسخها من قاعدة بيانات Postgres المصدر. وأثناء تحديد الجداول، يمكنك أيضًا اختيار إعادة تسمية الجداول في قاعدة بيانات ClickHouse الوجهة، وكذلك استبعاد أعمدة معيّنة.
إذا كنت تحدد مفتاح الترتيب في ClickHouse بشكل مختلف عن المفتاح الأساسي في Postgres، فلا تنسَ قراءة جميع الاعتبارات المتعلقة بذلك

​
راجع الأذونات وابدأ ClickPipe

  1. اختر دور “وصول كامل” من القائمة المنسدلة للأذونات، ثم انقر على “إكمال الإعداد”.

​
ما التالي؟

بمجرد إعداد ClickPipe لنسخ البيانات من PostgreSQL إلى ClickHouse Cloud، يمكنك التركيز على كيفية الاستعلام عن بياناتك ونمذجتها لتحقيق أفضل أداء. راجع دليل الترحيل لتحديد الاستراتيجية الأنسب لمتطلباتك، وكذلك صفحتي استراتيجيات إزالة التكرار (باستخدام CDC) ومفاتيح الترتيب للاطلاع على أفضل الممارسات لأحمال عمل CDC. للاطلاع على الأسئلة الشائعة حول PostgreSQL CDC واستكشاف الأخطاء وإصلاحها، راجع صفحة الأسئلة الشائعة حول Postgres.
آخر تعديل في ٢٥ يونيو ٢٠٢٦