دليل استخدام استوديو قاعدة البيانات
تنبيه: ما يُنفَّذ هنا يعمل على قاعدة البيانات مباشرة وبلا مراجعة محاسبية.
عند فتح مسودة أو تنفيذ سكربت تُعرض رسالة صريحة:
«هذا التغيير محلي لهذه القاعدة فقط؛ لن يصل إلى عملاء آخرين. لنشره ازرعه في DatabaseSchemaCatalog وERP.QL.»
ولا تُنفَّذ أي مسودة تلقائياً — كلها تُفتح في تبويب محرر للمراجعة ثم تضغط «تنفيذ (F5)» بنفسك.
تحذير الفهارس: «إعادة بناء (Rebuild)» على جدول كبير قد تستغرق وقتاً طويلًا وتحجز أقفالًا
تمنع مستخدمين آخرين؛ نص الرسالة في الشاشة: نفّذها في وقت قليل الضغط.
1) متى تستخدم هذه الشاشة؟
- عند تشخيص مشكلة بيانات: تريد أن ترى الصفوف كما هي في القاعدة، لا كما تعرضها الشاشة.
- عندما تحتاج استعلاماً مباشراً خارج حدود أي تقرير: عدّ صفوف، فحص التكرارات، مقارنة بين جدولين.
- قبل تنفيذ تغيير على مخطط: توليد مسودة ALTER من «مصمم الجدول» وقراءتها في المحرر بدل كتابتها من الصفر.
- لفحص كائن: قراءة «التعريف» و«المعاملات» و«الاعتماديات» لإجراء مخزّن أو طريقة عرض.
- لإضافة «فهرس جديد» أو «مفتاح خارجي جديد» على قاعدة منشأة، أو لإعادة بناء فهرس بطيء.
2) خطوات الاستخدام
-
افتح الشاشة من القائمة إلزامي
تظهر مباشرةً في وضع المنشأة المعتاد. أما في وضع المطور فتسبقها بوابة: حقل «كلمة السر» وزر «التالي»؛ والخطأ فيها «اسم المستخدم او كلمة السر غير صحيحة» بعنوان «فشلت العملية». -
تصفّح الشجرة إلزامي
العقدة الجذرية هي قواعد البيانات، وتحتها لكل قاعدة: «الجداول» · «طرق العرض» · «الإجراءات المخزّنة» · «الدوال» · «المشغّلات» · «الأسماء المستعارة» · «الأنواع»، وتحت الجدول «الأعمدة» و«الفهارس» و«المفاتيح الأجنبية». أسماء الكائنات تُحمَّل عند فتح عقدها، وزر «تحديث القوائم» يعيد قراءة ما ظهر حديثاً في القاعدة. -
افتح جدولاً لعرض بياناته إلزامي
إذا لم يكن للجدول مفتاح أساسي تُعرض «معاينة 100 صف» فقط؛ وإلا تُفتح شبكة كاملة بتصفية وترتيب وتقسيم صفحات، مع «تصدير CSV» للصفوف المحمَّلة على الشاشة. -
عدّل الصفوف إن لزم شرطي
أزرار الإضافة والتحرير والحذف داخل الشبكة تظهر فقط بمنح «إضافة بيانات» و«تعديل بيانات» و«حذف بيانات»، ولكل جدول مفتاح أساسي؛ الحذف يطلب تأكيداً قبل التنفيذ. -
افحص كائناً من عقدة اختياري
لوحة «تفاصيل الكائن» فيها «التعريف» و«المعاملات» و«الاعتماديات» و«السكربت المولَّد» مع «توليد سكربت CREATE» و«توليد سكربت ALTER» و«تطبيق التعريف المحفوظ» و«حذف الكائن» و«تنفيذ بمعاملات» للإجراءات. -
احذف كائناً بالتأكيد المكتوب شرطي
الحذف لا يعمل إلا بكتابة اسم الكائن حرفياً في «اكتب اسم الكائن للتأكيد» — نفس دلالية أدوات الإدارة المعروفة، ولا يعمل بدون إذن «تغيير مخطط القاعدة». -
استعمل «مصمم الجدول» اختياري
من شبكة الجدول: «إضافة عمود» أو «تعديل عمود» أو «حذف عمود»، ثم «توليد مسودة SQL». الرسالة بعد التوليد: «فُتحت مسودة الـ SQL في تبويب محرر جديد للمراجعة؛ لم يُنفَّذ شيء بعد. عدّلها إن لزم ثم اضغط تنفيذ.» -
أدر الفهارس والمفاتيح الأجنبية اختياري
لوحة الفهارس: «فهرس جديد» و«إعادة بناء (Rebuild)» و«إعادة تنظيم (Reorganize)» وحذف. لوحة المفاتيح الأجنبية: «مفتاح خارجي جديد» وحذف، وخيار «غير مطبَّق على النسخ (NOT FOR REPLICATION) — مُوصى به لأن القاعدة تستخدم P2P replication» مُفعَّلٌ افتراضياً. -
اكتب استعلامك في «محرر SQL» ونفّذه شرطي
لا يظهر هذا القسم إلا بإذن «تنفيذ استعلامات SQL». «استعلام جديد» يفتح تبويباً مستقلاً (لكل تبويبه وإلغاؤه بـ«إغلاق»)، وزر «المظهر» يقلب شكل المحرر. «تنفيذ (F5)» يقرأ النص كله، و«إلغاء» يوقف التنفيذ الجاري، و«مسح» يفرّغ التبويب، و«المتابعة عند الخطأ» تكمل بقية الدفعات بعد الأولى الفاشلة. -
اقرأ المخرجات إلزامي
تبويبا «النتائج» و«الرسائل» تحت المحرر؛ كل مجموعة نتائج تُعرض بشبكة، مع «زمن التنفيذ» و«الصفوف المتأثرة»، وحالة «قيد التنفيذ…» أثناء العمل. الاستعلام الذي لا يُرجع صفوفًا يكتب «تم التنفيذ بنجاح بدون أي نتائج.»
3) حقول لوحات الكائنات
| الحقل | الشرح |
|---|---|
| اسم الفهرس | اسم الفهرس الجديد؛ اتركه للفهرس الافتراضي المولَّد من الأعمدة. |
| أعمدة المفتاح | الأعمدة المُفهرَسة بالترتيب — تُختار من «اختر عمودًا». |
| الأعمدة المضمَّنة (اختياري) | أعمدة تُضاف للورقة دون أن تدخل في ترتيب الفهرس. |
| فريد (Unique) / مجمَّع (Clustered) | خصائص الفهرس؛ المجمَّع واحد لكل جدول فقط. |
| اسم القيد | اسم قيد المفتاح الخارجي الجديد. |
| الجدول المرجعي (schema.table) | الجدول الأب، بالكتابة الكاملة للمخطط والاسم. |
| أعمدة هذا الجدول / الأعمدة المرجعية | أعمدة الابن ثم الأب، بنفس العدد والترتيب (الأخيرة «مفصولة بفاصلة، بنفس الترتيب»). |
| فرض القيد على البيانات الموجودة (WITH CHECK) | يتحقق من الصفوف الحالية قبل إنشاء القيد؛ يفشل الإنشاء إن كانت مكسورة. |
| غير مطبَّق على النسخ (NOT FOR REPLICATION) | مفعَّل افتراضياً لأن القاعدة تستخدم نسخًا متقابلًا؛ لا تطفئه إلا بسبب ما تعرفه. |
| اسم العمود · نوع البيانات · يقبل NULL · القيمة الافتراضية | نموذج «إضافة عمود»؛ النوع مثلاً nvarchar(100) أو int أو decimal(18,2). |
| إنشاء | يولّد المسودة ويفتحها في المحرر؛ لا يُنفِّذ شيئاً في القاعدة. |
4) في الديسكتوب
لا نسخة ديسكتوب لهذه الشاشة؛ عنصر القائمة مربوط بالويب وحده. أعمال الصيانة على الديسكتوب تُنفَّذ عبر النسخ الاحتياطي والاستعادة.
5) رسائل الخطأ الشائعة
| الرسالة | معناها وما تعمل |
|---|---|
| «تعذّر تحميل بيانات الشجرة.» | لم تُقرأ قائمة القواعد أو العقد؛ جرّب «تحديث القوائم»، وتحقق من الاتصال ومن أن الحساب يملك إذن الشاشة. |
| «اسم المستخدم او كلمة السر غير صحيحة» | بوابة كلمة السر في وضع المطور؛ تُعرض أحياناً بصيغة «اسم المستخدم او كلمة المرور غير صحيحة» في نفس الشاشة. |
| «فشلت العملية» | عنوان نافذة الخطأ عند رفض التنفيذ؛ نص السبب يُقرأ داخل الرسالة نفسها. |
| «تم التنفيذ بنجاح بدون أي نتائج.» | ليست خطأً: الاستعلام نُفِّذ ولم يُرجع مجموعات نتائج. |
| «لا اعتماديات ظاهرة (قد تكون الحزمة مغلفة Encrypted).» | الكائن مُشفَّر لذا تعذّر سرد اعتمادياته، لا أنه بلا اعتماديات فعلاً. |
6) الصلاحيات
تُمنح الأذونات من شاشة المستخدمين؛ الجدول الكامل لأذونات القسم في فهرس إدارة قواعد البيانات. بدون إذن الشاشة نفسها لا تظهر القائمة أصلاً، وبدون إذن عرض بيانات الجداول تبقى منطقة العمل فارغة حتى لو فُتحت الشجرة.
7) أسئلة شائعة
| السؤال | الجواب |
|---|---|
| لم أرَ «محرر SQL» تحت الشجرة؟ | القسم كله يُحمَّل فقط لمن معه إذن «تنفيذ استعلامات SQL»؛ بغيابه لا يُحمَّل محرك المحرر أيضاً. |
| الجدول مفتوح في الشبكة لكن لا أزرار تحرير؟ | إما لا إذن إضافة/تعديل/حذف، أو أن الجدول بلا مفتاح أساسي فتُعرض المعاينة للقراءة فقط. |
| هل تصدير CSV يُخرج الجدول كله؟ | لا؛ يصدّر الصفوف المحمَّلة أمامك فقط، لهذا تصغير الصفحة أو التصفية أولاً أهم من الانتظار. |
| نفّذت ALTER ونجح — لماذا لم يتغيّر عند العميل الآخر؟ | لأن التغيير محلي لهذه القاعدة كما تقول الرسالة؛ النشر يكون بزراعة السكربت في مصدر المخطط، لا من الاستوديو. |
| هل يمكن إيقاف استعلام طويل؟ | نعم، «إلغاء» يوقف تنفيذ التبويب الحالي ويُبقي ما رجع من نتائج. |