Supabase

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

قبل البدء

تحتاج إلى بيانات اتصال Session pooler لمشروعك:

1. افتح مشروعك في Supabase وانقر على Connect في الشريط العلوي.
2. اختر Session pooler ودوّن الخادم والمنفذ وقاعدة البيانات والمستخدم.
3. جهّز كلمة مرور قاعدة البيانات، وهي التي حددتها عند إنشاء المشروع، ويمكنك إعادة تعيينها من إعدادات قاعدة البيانات في Supabase.

استخدم خادم Session pooler، مثل aws-0-eu-central-1.pooler.supabase.com. فالخادم المباشر (db.<project-ref>.supabase.co) لا يقبل إلا اتصالات IPv6، ولا يستطيع كيوبت الوصول إليه.

ربط Supabase

1. افتح البيانات من الشريط الجانبي، وانقر على إضافة بيانات، ثم اختر ربط قاعدة بيانات.
2. في صفحة مصدر بيانات جديد، انقر على Supabase ضمن فئة قواعد البيانات.
3. أدخل اسم الاتصال.
4. املأ بيانات الاتصال:
   • مضيف Session pooler: خادم pooler من Supabase. ويمكنك أيضًا لصق رابط الاتصال الكامل postgresql:// هنا، فيملأ كيوبت المنفذ وقاعدة البيانات واسم المستخدم وكلمة المرور منه.
   • المنفذ: القيمة الافتراضية 5432.
   • قاعدة البيانات: القيمة الافتراضية postgres.
   • اسم المستخدم: اسم مستخدم pooler، ويتضمن معرّف مشروعك بعد النقطة، مثل postgres.abcdefghijklmnop.
   • كلمة مرور قاعدة البيانات: كلمة مرور قاعدة البيانات. لا تستخدم مفتاحي API ‏anon أو service_role.
   • المخطط (Schema): القيمة الافتراضية public.
5. في وضع الاتصال، اختر وضع المزامنة أو الوضع المباشر.
6. للاتصال مرورًا بخادم وسيط SSH بدلًا من ذلك، فعّل الاتصال بنفق SSH واملأ حقول SSH. ويعمل النفق دائمًا بالوضع المباشر.
7. في وضع المزامنة، اختر جدول المزامنة. الخيار الافتراضي يوميًا.
8. انقر على إنشاء.

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

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

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

• «This is Supabase's direct host, which is IPv6 only»: استبدل الخادم بخادم Session pooler الظاهر ضمن Connect في Supabase، واستخدم اسم مستخدم pooler بصيغة postgres.<project-ref>.
• «Authentication failed»: تحقق من اسم المستخدم وكلمة مرور قاعدة البيانات.
• «Schema does not exist»: تحقق من اسم المخطط، إذ تحفظ تطبيقات Supabase جداولها عادةً في public.

ولبقية الأخطاء راجع PostgreSQL، فـSupabase يخضع للفحوص نفسها.