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

يغطي هذا الدليل قاعدة البيانات المضمنة في سحابة 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 لنسخ المخطط المعروض.

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

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

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

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

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

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

إنشاء جداول أو تغيير المخطط

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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