أقسام مساحة العمل
قاعدة البيانات: تصفّح الجداول واستيراد CSV
قسم «قاعدة البيانات» في مجموعة «متقدّم» يقرأ ملفات مشروعك: مخطط prisma/schema.prisma إن وُجد، وملفات data/*.json التي يكتبها استيراد CSV. الشاشة للتصفّح والاستيراد والتهيئة، لا لتحرير الصفوف أو كتابة الاستعلامات.
في هذه الصفحة
الوصول والباقات
افتح «قاعدة البيانات» من مجموعة «متقدّم». القسم يحتاج الاستضافة، فهو مقفل في الباقة المجانية ويُرفض برمز 402. المحركات في عقد كل باقة:
| الباقة | المحركات |
|---|---|
| المجانية | - |
| الأساسية | sqlite, postgresql, mariadb |
| المميزة | sqlite, postgresql, mariadb |
| الاحترافية | sqlite, postgresql, mariadb |
MariaDB مذكورة في عقد الباقات لكن هذه الشاشة لا تتعرّف عليها: تعرض الأنواع SQLite وPostgreSQL و«ملفّات JSON» فقط، وأي نوع آخر يظهر «غير معروف». عرض MariaDB غير متاح بعد.
ما تراه
إن لم يكن في المشروع مخطط ولا جداول ملفية ترى «لا توجد قاعدة بيانات في هذا المشروع»، مع اقتراح أن تطلب من الوكيل في المحادثة إضافة تخزين (مثال: «أضف قاعدة بيانات لحفظ طلبات التواصل») فيُنشئ prisma/schema.prisma. راجع المحادثة.
وإلا تظهر ثلاث بطاقات: «النوع» و«الحالة» («مهيّأة» أو «غير مهيّأة») و«الجداول» (عدد جداول المخطط والجداول الملفية معًا)، ثم لوحتان: «الجداول» و«الصفوف».
تصفّح الجداول
- ابحث في «ابحث في الجداول…» لتصفية القائمة.
- جداول المخطط تظهر بوسم «مخطّط» ولا تُفتح: الشاشة تقرأ أسماءها من
prisma/schema.prismaفقط. - الجداول الملفية (المستوردة من CSV) تظهر مع عدد صفوفها؛ اضغط أحدها لتُعرض صفوفه في لوحة «الصفوف».
تُعرض أول 200 صفّ من الجدول، ويقول وصف اللوحة ذلك («… صفّ — تُعرَض أوّل …»). الأعمدة تُجمع من الصفوف نفسها، والقيمة الفارغة تظهر «—».
تصفّح صفوف جداول المخطط (SQLite أو PostgreSQL) غير متاح بعد: تُعرض أسماؤها فقط. ولا يوجد في الشاشة تعديل صفّ أو حذفه أو تشغيل استعلام — كل ما تعرضه للقراءة فقط.
استيراد CSV
لوحة «استيراد CSV» تحفظ الملف داخل مشروعك في data/ باسم الجدول وامتداد json، فينتقل معه عند التصدير.
- اضغط «اختر ملف CSV» واختر الملف (حتى ٥ ميغابايت).
- تظهر المعاينة: «… صفًا صالحًا» و«… صفًا مرفوضًا» و«… عمودًا»، وجدول عيّنة، وقائمة الأسطر المرفوضة بأسبابها («السطر …: …»).
- راجع «اسم الجدول» (يُقترح من اسم الملف؛ يبدأ بحرف صغير ويقبل الأرقام والشرطة والشرطة السفلية).
- اختر «استبدال المحتوى» أو «إضافة إلى الموجود».
- اضغط «استورد». تظهر «استُورد … صفًا» أو «استُورد … صفًا ورُفض …». «إلغاء» يتخلّص من المعاينة.
أسباب الرفض الشائعة: «لم يُرفَع ملف»، «حجم الملف يتجاوز ٥ ميغابايت»، «لا توجد صفوف صالحة للاستيراد».
تهيئة القاعدة
حين يكون النوع SQLite أو PostgreSQL يظهر زر «هيّئ القاعدة» (أو «أعد التهيئة» إن كانت مهيّأة). الزر يزامن ملفات المشروع ثم يطبّق المخطط على نسخة المشروع وحدها. النجاح يعرض «تمت تهيئة قاعدة البيانات»، والفشل يعرض سبب الخطأ.
التهيئة تطبّق المخطط بخيار يقبل فقدان البيانات، فإعادة التهيئة بعد تغيير المخطط قد تحذف بيانات جداول تغيّرت. وحالة PostgreSQL تظهر «غير مهيّأة» دائمًا لأن الشاشة لا تقرأ حالة خادم PostgreSQL: قياس حالته غير متاح بعد.
أسئلة شائعة
أين تُحفظ بيانات CSV؟
في ملفات مشروعك نفسها تحت data/، فتراها أيضًا في الشيفرة وتُحفظ في النسخ.
لماذا لا أرى زر التهيئة؟
الزر لا يظهر حين لا يوجد مخطط Prisma أو حين تكون البيانات جداول ملفية فقط.