قاعدة البيانات

يغطي هذا الدليل قاعدة البيانات المضمنة في سحابة Atoms. إذا كان مشروعك يستخدم Supabase، فراجع ربط Supabase بدلًا من ذلك.

فتح قاعدة بيانات

قبل فتح قاعدة بيانات، قم بربط مشروعك بـ سحابة Atoms. إذا لم يكن متصلًا بعد، فاتبع خطوات الاتصال في سحابة Atoms.

1. افتح مشروعك على جهاز سطح مكتب.
2. في شريط أدوات مساحة العمل نفسه حيث يوجد عارض التطبيقات، حدد سحابة Atoms.
3. حدد قاعدة البيانات في الشريط الجانبي لـ سحابة Atoms.
4. ضمن Databases، حدد قاعدة البيانات التي تريد فحصها. تظهر بطاقتا Development و Production لقاعدة البيانات عندما تكونان متاحتين للمشروع.

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

اختر قاعدة بيانات Development أو Production.

تصفح بيانات الجدول وتصفيتها

1. حدد بطاقة قاعدة بيانات Development أو Production، بحسب البيئة التي تريد العمل فيها.
2. استخدم Search tables للعثور على جدول، أو حدده مباشرة من القائمة. تعرض كل بطاقة جدول عدد صفوفه وما إذا كان للقراءة فقط.
3. استخدم Search rows للبحث داخل الجدول الحالي، أو حدد Filter لتضييق النتائج باستخدام حقل واحد أو أكثر.
4. استخدم عناصر التحكم بأسهم الصفحات أسفل الجدول لعرض صفوف إضافية.
5. لفحص بنية الجدول، افتح قائمة ••• وحدد Schema.

يعرض منظور Schema اسم كل حقل ونوع البيانات وحالة المفتاح والمتطلبات والقيود والقيمة الافتراضية. حدد Copy لنسخ الـ schema المعروض.

إضافة الصفوف أو تعديلها أو حذفها

عندما تعثر على قاعدة البيانات التي تريد إجراء تغييرات عليها، يمكنك استخدام هذه الإجراءات للقيام بذلك:

العملية	كيفية القيام بذلك
إضافة صف	افتح... وحدد Add Row. أدخل القيم التي تطابق الحقول المتاحة، ثم أرسل الصف.
تعديل صف	انقر نقرًا مزدوجًا على خلية وأدخل القيمة الجديدة. حددCommit Changes لحفظ جميع التعديلات المعلقة، أو Discard لإزالتها.
حذف صفوف	حدد صفًا واحدًا أو أكثر، ثم حددDelete، ثم أكد العملية. لا يمكن التراجع عن حذف الصفوف.

يؤدي إضافة صف أو تأكيد الحذف إلى تطبيق التغيير فورًا على قاعدة البيانات المحددة. فقط تعديلات الخلايا المضمنة تتطلب منك تحديد Commit Changes أو Discard. إذا كانت لديك أي تعديلات معلقة، فقم بتثبيتها أو تجاهلها قبل إضافة صف، أو استيراد ملف CSV أو تصديره، أو تغيير البحث أو عوامل التصفية، أو الانتقال إلى صفحة أخرى.

إذا كان المشروع ضمن مساحة عمل، فلا يمكن سوى لـ Editors و workspace owner تعديل الصفوف في الجداول القابلة للكتابة. إذا لم يتمكن Atoms من اكتشاف مفتاح أساسي لجدول ما، فلن تتمكن من تعديل صفوفه أو حذفها لأن Atoms لا يمكنه تحديد السجلات الفردية بشكل موثوق.

راجع تعديل صف معلقًا، ثم ثبّت التغيير أو تجاهله.

إنشاء جداول أو تغيير الـ schema

افتح بيئة قاعدة البيانات التي تريد تحديثها، ثم اتبع التعليمات الخاصة بالتغيير الذي تريد إجراءه:

العملية	كيفية القيام بذلك
إنشاء جدول	في قائمة الجداول، انقر على...، ثم حدد Create table. أدخل اسم جدول صالحًا والحقول الأولية، ثم أرسل الطلب. انتظر حتى ينتهي Agent، ثم أعد فتح قاعدة البيانات وتحقق من الجدول.
تغيير الـ schema	انقر على الجدول الذي تريد إجراء تغييرات عليه، ثم انقر على...، وحدد Schema. استخدم Add Field لإنشاء حقل، أو حدد حقلًا مؤهلًا لتعديله. يمكنك تغيير اسمه أو نوعه أو قيمته الافتراضية أو حالة كونه مطلوبًا أو تفرده. يمكنك أيضًا وضع علامة على الحقول غير المفتاحية لحذفها. حدد Submit Changes لإرسال الطلب إلى Agent، أو Discard لمسح التغييرات المعلقة.

يمكن فقط لـ workspace owner إنشاء الجداول أو تغيير schema الجدول.

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

أدخل تفاصيل الحقل الجديد في Add Field.

راجع تغييرات الـ schema المعلقة قبل تحديد Submit Changes.

استيراد بيانات CSV أو تصديرها

حدد الجدول الذي تريد العمل عليه، ثم اتبع التعليمات الخاصة بالعملية ذات الصلة:

العملية	كيفية القيام بذلك
استيراد CSV	انقر على... وحدد Import CSV. اختر ملف .csv لا يزيد حجمه عن 10 MB، ثم راجع اسم الملف، والعدد التقديري للصفوف، والجدول المحدد، والبيئة قبل التأكيد. يجب أن تتطابق أعمدة CSV مع schema الجدول. تتم إضافة الصفوف المستوردة فورًا ولا يمكن التراجع عنها تلقائيًا، لذا فكّر في تصدير البيانات الحالية أولًا.
تصدير CSV	انقر على... وحدد Export CSV. إذا كان هناك بحث أو عامل تصفية نشط، فسيتم تصدير الصفوف المطابقة فقط. بخلاف ذلك، سيتم تصدير جميع البيانات من الجدول الحالي.

يمكن فقط لـ workspace owner استيراد ملفات CSV أو تصديرها. بالنسبة للجداول المخصصة للقراءة فقط، يكون Export CSV هو الخيار الوحيد المتاح.

الأذونات والجداول المحمية

الإجراء	من يمكنه تنفيذه	متطلبات إضافية
إضافة الصفوف أو تعديلها أو حذفها	Editor أو workspace owner	يجب أن يكون الجدول قابلًا للكتابة. كما يتطلب تعديل الصفوف وحذفها معلومات المفتاح الأساسي.
إنشاء الجداول أو تغيير الـ schemas	Workspace owner	لا يمكن تعديل حقول المفتاح الأساسي والجداول المخصصة للقراءة فقط.
استيراد ملفات CSV أو تصديرها	Workspace owner	لا يمكن استيراد ملفات CSV إلى الجداول المخصصة للقراءة فقط.

قد تعرض جداول النظام أو المستخدم المحمية شارة Read-only. يمكنك عرض بياناتها وفحص schema الخاص بها عند توفره، لكن لا يمكنك تعديل صفوفها أو بنيتها من هذه الصفحة.

إصلاح مشكلات قاعدة البيانات الشائعة

"لم يتم العثور على قواعد بيانات" أو "لم يتم العثور على جداول"

تأكد من أن سحابة Atoms متصلة بالمشروع. إذا كانت متصلة بالفعل، فتأكد من أن تطبيقك يتضمن ميزة تخزن بيانات دائمة. إذا لزم الأمر، اطلب من Agent إضافة الميزة المدعومة بقاعدة البيانات. بمجرد أن ينتهي Agent، أعد فتح قاعدة البيانات أو حدد Refresh.

إجراء في قاعدة البيانات مفقود أو غير متاح

تحقق مما إذا كان الجدول يحمل شارة Read-only، ثم راجع الأذونات أعلاه للتأكد من أن دورك في مساحة العمل يسمح بهذا الإجراء. كما يتطلب تعديل الصفوف وحذفها معلومات المفتاح الأساسي.

يمكن أن تمنع تعديلات الصفوف المعلقة إجراءات أخرى. حدد Commit Changes أو Discard قبل إضافة صف، أو استيراد ملف CSV أو تصديره، أو تغيير البحث أو عوامل التصفية، أو الانتقال إلى صفحة أخرى.

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

يتعذر استيراد ملف CSV

يمكن فقط لـ workspace owner استيراد البيانات، ويجب أن يكون الجدول الوجهة قابلًا للكتابة. تأكد من أن:

• يستخدم الملف تنسيق .csv.
• لا يزيد حجم الملف عن 10 MB.
• أعمدته وبياناته متوافقة مع schema جدول الوجهة.
• لقد قمت بتثبيت أي تعديلات صفوف معلقة أو تجاهلها.

إذا استمر فشل الاستيراد، فاتصل بـ Support وضمّن رابط المشروع أو Chat، والبيئة، والجدول الوجهة، ودور مساحة العمل، واسم الملف وحجمه، والإجراء الذي تمت محاولته، ونص الخطأ الكامل.

الأسئلة الشائعة

قاعدة بيانات الإنتاج الخاصة بي لا تتم مزامنتها. ماذا يجب أن أفعل؟

إذا كان Development يعمل بشكل طبيعي لكن الموقع المباشر (Production) يُظهر جداول أو أعمدة مفقودة أو أخطاء ترحيل:

مهم: لا تقم بإعادة بناء قاعدة بيانات الإنتاج أو الكتابة فوقها بنفسك.

المعلومات المطلوبة:

• رابط Chat والرابط المباشر
• رسالة خطأ SQL الكاملة
• أسماء الجداول/الأعمدة المفقودة
• آخر تغيير في schema قاعدة البيانات
• آخر إصدار مباشر كان يعمل
• ما إذا كان يجب الحفاظ على بيانات الإنتاج
• ما إذا كنت تريد مزامنة بيانات Development بالكامل أو فقط استكمال البُنى المفقودة

تواصل مع الدعم بهذه التفاصيل حتى نتمكن من مقارنة إصدارات Development/Production، وحالة الترحيل، وفروقات schema قبل إجراء التغييرات.

لماذا تختلف بيانات التطوير الخاصة بي عن بيانات الإنتاج؟

إذا كنت قد نشرت عدة مرات لكن Production لا يزال يعرض بيانات قديمة بينما تعمل تحديثات الكود بشكل جيد:

قبل التواصل مع الدعم، أكد ما يلي:

1. هل يجب الحفاظ على بيانات الإنتاج الحالية؟

2. هل تريد الكتابة فوقها بالكامل ببيانات Development الحالية، أم فقط استكمال السجلات المفقودة؟

3. هل لديك نسخة احتياطية بالفعل؟

4. ما نافذة الصيانة المقبولة لديك؟

لن نقوم بالكتابة فوق بيانات الإنتاج أو إعادة بنائها حتى يتم تأكيد هدف التعامل مع البيانات. قدّم عناوين URL الخاصة بـ Development/Production ومعرّفات السجلات النموذجية أو الأعداد التي تُظهر الفرق.

هل يمكنني نقل قاعدة بيانات من مشروع Atoms إلى آخر دون فقدان البيانات؟

لا يدعم Atoms حاليًا ترحيل قواعد البيانات تلقائيًا وبدون فقدان بين المشاريع. لن يؤدي إنشاء مشروع جديد أو تقسيم مشروع موجود إلى نسخ حسابات المستخدمين الحالية أو سجلات قاعدة البيانات تلقائيًا إلى المشروع الجديد.

قبل المتابعة:

• لا تقم بإعادة تعيين قاعدة البيانات الحالية أو موارد المشروع أو استبدالها أو ترحيلها أو حذفها.
• أبقِ المشروع الأصلي دون تغيير باعتباره مصدر البيانات الحالية.
• تواصل مع دعم Atoms وقدم المشروع المصدر، والمشروع الوجهة، وموفر قاعدة البيانات، والبيانات التي يجب الحفاظ عليها.

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

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