تخطَّ إلى المحتوى

قاعدة بيانات تطبيقك

باختصارلكل تطبيق ينشئه MonstarX قاعدة بيانات خاصة به، تُنشأ لك عند أول إنشاء. افتح الخدمات السحابية ← قاعدة البيانات لترى كل جدول وصفوفه وتحديثات مخطط البيانات، ولتشغيل استعلامات SQL للقراءة فقط. لإضافة السجلات أو تغييرها، استخدم تبويب الإدارة أو اطلب ذلك في المحادثة. تشترك المعاينة وتطبيقك المنشور في البيانات نفسها، واستعادة إصدار سابق لا تمس البيانات أبدًا.

قاعدة البيانات هي المكان الذي يحفظ فيه تطبيقك معلوماته: قائمة مشروبات المقهى، والطلبات التي يضعها الناس، والوصفات التي ينشرونها، والحسابات التي يسجّلون الدخول بها. لكل تطبيق تنشئه في MonstarX قاعدة بيانات خاصة به، تُنشأ عند أول إنشاء، ولا يستطيع أي تطبيق آخر قراءتها.

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

  1. افتح مشروعك وانقر على الخدمات السحابية في الشريط العلوي.

  2. انقر على قاعدة البيانات. على اليمين ترى الجداول، وبجانب كل جدول عدد صفوفه.

  3. انقر على جدول لترى صفوفه. يعرض MonstarX أول 50 صفًا.

يوضح المربع أعلى القائمة مكان قاعدة البيانات واسمها. وتحت الجداول، يعرض قسم تحديثات مخطط البيانات كل تغيير شكّل قاعدة البيانات حتى الآن (ستجد المزيد عنها أدناه). انقر على سهم التحديث بجانب الجداول لإعادة عدّ الصفوف بعد أن يُستخدم تطبيقك.

ما الجداول الموجودة مسبقًا؟

Section titled “ما الجداول الموجودة مسبقًا؟”

توجد 4 جداول في كل تطبيق قبل أن تطلب أي شيء: user وsession وaccount وverification. تحفظ هذه الجداول من ينشئون حسابًا في تطبيقك وعمليات تسجيل دخولهم. راجع حسابات المستخدمين. كل جدول آخر أنشأه MonstarX خصيصًا لتطبيقك، مثل menu_items أو recipes.

هل يمكنني تشغيل استعلامات SQL بنفسي؟

Section titled “هل يمكنني تشغيل استعلامات SQL بنفسي؟”

نعم، للبحث عن المعلومات. لغة SQL هي اللغة التي تفهمها قواعد البيانات. اكتب استعلامًا في المربع العلوي وانقر على تشغيل، فتظهر الإجابة في جدول أسفله.

مثال:

SELECT title, country_code, tags FROM recipes ORDER BY created_at DESC LIMIT 5

من المفيد أن تعرف:

  • المربع للقراءة فقط. يشغّل عبارة واحدة في كل مرة، ولا يقبل إلا العبارات التي تقرأ: SELECT وWITH وPRAGMA وEXPLAIN. أما ما قد يغيّر البيانات، مثل INSERT وUPDATE وDELETE وDROP، فيُرفض، فلا يمكنك أن تعطّل تطبيقك عن طريق الخطأ.
  • يعرض الاستعلام 200 صف كحد أقصى.
  • تعرض PRAGMA table_info(recipes) أعمدة الجدول.
  • إذا كانت بيانات التطبيق في Supabase أو Railway Postgres، يقبل المربع SELECT وWITH وTABLE وEXPLAIN.

كيف أضيف السجلات أو أغيّرها أو أحذفها؟

Section titled “كيف أضيف السجلات أو أغيّرها أو أحذفها؟”

أمامك طريقتان سهلتان، ولا تحتاج أيٌّ منهما إلى SQL:

  • تبويب الإدارة. لكل تطبيق لوحة إدارة بجانب المعاينة. تعرض جداولك في نماذج سهلة وبلغة الأعمال، فتضيف السجلات وتعدّلها وتحذفها، مع إمكانية تراجع. يظهر التغيير في تطبيقك فورًا ولا يستهلك أي أرصدة. راجع لوحة إدارة تطبيقك.
  • المحادثة. قل ما تريده، مثل «أضف فلات وايت إلى قائمة القهوة بسعر $4.50» أو «احذف طلبات الاختبار». وفي وضع المحادثة يستطيع MonstarX أيضًا الاطلاع على بياناتك والإجابة عن أسئلتك عنها دون أن يغيّر شيئًا. راجع الإنشاء والتخطيط والمحادثة.

ماذا يفعل MonstarX بقاعدة البيانات عندما ينشئ التطبيق؟

Section titled “ماذا يفعل MonstarX بقاعدة البيانات عندما ينشئ التطبيق؟”

عندما تحتاج ميزة إلى مكان تحفظ فيه معلوماتها، يكتب MonstarX تحديثًا لمخطط البيانات (migration): مجموعة تعليمات مرقّمة تنشئ الجداول أو تغيّرها، مثل 0001_create_menu_and_orders. يطبّق MonstarX هذا التحديث على قاعدة بياناتك ويحفظه مع الشفرة، فتبقى الجداول والشفرة متطابقتين دائمًا. بعض التحديثات تضيف بيانات أولية، مثل قائمة نموذجية (0002_seed_recipes في المثال أعلاه).

تعرض قائمة تحديثات مخطط البيانات في الخدمات السحابية كل تحديث جرى تشغيله، بالترتيب. التحديث 0000_monstarx_auth خاص بـ MonstarX، وهو الذي ينشئ جداول الحسابات.

هل تبقى بياناتي عندما أغيّر تطبيقي أو أستعيد إصدارًا سابقًا؟

Section titled “هل تبقى بياناتي عندما أغيّر تطبيقي أو أستعيد إصدارًا سابقًا؟”

نعم. بياناتك منفصلة عن الشفرة:

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

هل يمكنني حفظ البيانات في قاعدة بيانات خاصة بي؟

Section titled “هل يمكنني حفظ البيانات في قاعدة بيانات خاصة بي؟”

نعم. في الخدمات السحابيةالسحابة يتيح لك قسم مكان تخزين بيانات هذا التطبيق الاختيار بين:

  • قاعدة بيانات MonstarX: الخيار الافتراضي، ولا يحتاج إلى أي إعداد.
  • Supabase (Postgres): مشروع Supabase الخاص بك. وPostgres قاعدة بيانات شائعة تستخدمها فرق كثيرة. راجع Supabase.
  • Railway (Postgres): قاعدة بياناتك الخاصة على Railway. راجع Railway.
  • Firestore (مشروع Firebase الخاص بك): سجلات تطبيقك في Firebase. راجع Firebase.

ينسخ MonstarX الجداول والصفوف والحسابات، ويعيد كتابة التطبيق ليستخدم المكان الجديد. ويمكنك العودة لاحقًا بزر إعادة البيانات. وعندما تكون البيانات في Firestore، يعرض قسم قاعدة البيانات مجموعات Firestore بدلًا من الجداول (للقراءة فقط، فالتطبيق هو من يكتبها).

هل يمكنني تعديل صف مباشرةً من قسم قاعدة البيانات؟

لا، قسم قاعدة البيانات للقراءة فقط. عدّل السجلات في تبويب الإدارة، الذي يعمل كجدول بيانات سهل مع إمكانية التراجع، أو اطلب ذلك من MonstarX في المحادثة. راجع لوحة إدارة تطبيقك.

لماذا ظهر طلب الاختبار في تطبيقي المنشور؟

تشترك المعاينة والتطبيق المنشور في قاعدة بيانات واحدة، فكل ما تضيفه أثناء الاختبار بيانات حقيقية. احذف صفوف الاختبار في تبويب الإدارة عندما تنتهي.

هل تحذف استعادة إصدار قديم بياناتي؟

لا. استعادة الإصدار تستبدل الشفرة فقط، ويبقى كل صف في قاعدة بياناتك كما هو.

هل يمكنني تنزيل بياناتي؟

يمكنك قراءة أي جدول باستعلام SELECT ونسخ النتيجة، أو نقل البيانات إلى قاعدة Postgres خاصة بك على Supabase أو Railway، حيث تملك وصولًا كاملًا إليها.

ما نوع قاعدة البيانات؟

قاعدة بيانات SQL خاصة لكل تطبيق. ولغة SQL هي اللغة المعيارية لقواعد البيانات، فيستطيع أي مطوّر العمل عليها. وإن كنت تفضّل Postgres، فانقل البيانات إلى Supabase أو Railway.

لماذا أرى رسالة تقول إن التطبيق مستورد؟

لم ينشئ MonstarX قاعدة بيانات للتطبيق المستورد: بياناته موجودة حيث تحفظها شفرته. والمفاتيح التي يقرؤها موجودة في قسم الأسرار.