PostgreSQL

اربط قاعدة بيانات PostgreSQL ليقرأ كيوبت الجداول الموجودة في مخطط واحد. يمكنك نسخ البيانات إلى كيوبت وفق جدول زمني (وضع المزامنة) أو الاستعلام من قاعدة البيانات مباشرة (الوضع المباشر).

قبل البدء

• أنشئ مستخدمًا مخصصًا لكيوبت للقراءة فقط، وامنحه صلاحية SELECT على الجداول التي تريد استخدامها، وصلاحية USAGE على المخطط الذي يحتويها.
• تأكد من أن قاعدة البيانات تقبل الاتصالات الواردة من خوادم كيوبت. وإذا لم تكن متاحة إلا داخل شبكة خاصة، فيمكنك الاتصال بها مرورًا بخادم وسيط SSH (انظر أدناه).
• حدّد المخطط الذي يضم جداولك، ويستخدم PostgreSQL المخطط public افتراضيًا.

ربط PostgreSQL

1. افتح البيانات من الشريط الجانبي، وانقر على إضافة بيانات، ثم اختر ربط قاعدة بيانات.
2. في صفحة مصدر بيانات جديد، انقر على PostgreSQL ضمن فئة قواعد البيانات.
3. أدخل اسم الاتصال.
4. املأ بيانات الاتصال:
   • المضيف أو رابط الاتصال (URI): اسم الخادم أو عنوان IP. ويمكنك أيضًا لصق رابط اتصال كامل مثل postgresql://user:[email protected]:5432/app، فيملأ كيوبت المنفذ وقاعدة البيانات واسم المستخدم وكلمة المرور تلقائيًا، ويقرأ schema وsslmode من الرابط إن وُجدا.
   • المنفذ: القيمة الافتراضية 5432.
   • قاعدة البيانات: اسم قاعدة البيانات.
   • اسم المستخدم وكلمة المرور: بيانات المستخدم المخصص للقراءة فقط.
   • المخطط (Schema): المخطط المراد قراءته، والقيمة الافتراضية public.
5. في وضع الاتصال، اختر وضع المزامنة لنسخ البيانات إلى كيوبت، أو الوضع المباشر للاستعلام من قاعدة البيانات مباشرة دون نسخها.
6. للوصول إلى قاعدة البيانات مرورًا بخادم وسيط، فعّل الاتصال بنفق SSH وأدخل مضيف SSH ومنفذ SSH واسم مستخدم SSH ومفتاح SSH الخاص (PEM)، وعبارة مرور المفتاح إن وُجدت. ويعمل النفق دائمًا بالوضع المباشر.
7. في وضع المزامنة، اختر جدول المزامنة. الخيار الافتراضي يوميًا.
8. انقر على إنشاء.

يختبر كيوبت الاتصال قبل حفظه، فإذا نجح الاختبار حفظ الاتصال ونقلك إلى كتالوج البيانات. وفي وضع المزامنة تبدأ المزامنة الأولى فورًا.

إذا لم ينجح الاختبار

يعرض النموذج رسالة الخطأ بالإنجليزية ويميّز الحقل الذي يحتاج إلى مراجعة:

• «Authentication failed»: اسم المستخدم أو كلمة المرور غير صحيحة.
• «Host could not be resolved»: تحقق من كتابة اسم الخادم.
• «Could not reach» أو «timed out»: تحقق من الخادم والمنفذ، ومن أن قاعدة البيانات تقبل الاتصالات البعيدة من كيوبت.
• «Database does not exist»: تحقق من اسم قاعدة البيانات.
• «Schema does not exist»: تحقق من اسم المخطط، فكثيرًا ما تُحمَّل البيانات في مخطط يحمل اسم قاعدة البيانات.

وإذا نجح الاتصال ولم تظهر جداول، أو أفاد اختبار الاتصال بأنه لا جداول، فتحقق من اختيار المخطط الصحيح ومن قدرة المستخدم على قراءة جداوله.