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

مرحباً بك في دليل تنقل قاعدة البيانات! يوفر HarborDB أدوات قوية لاستكشاف وفهم قواعد بيانات PostgreSQL الخاصة بك. سيظهر لك هذا الدليل كيفية التنقل بشكل فعال في هيكل قاعدة البيانات الخاصة بك، وفحص الجداول والعلاقات، والاستفادة القصوى من واجهة HarborDB المرئية.

واجهة التنقل

نظرة عامة على الشريط الجانبي

الشريط الجانبي الأيسر هو أداة التنقل الأساسية الخاصة بك. يعرض عرضاً هرمياً لهيكل قاعدة البيانات الخاصة بك:

اسم الاتصال
├── قواعد البيانات
│   ├── قاعدة البيانات 1
│   │   ├── المخططات
│   │   │   ├── عام
│   │   │   │   ├── الجداول
│   │   │   │   ├── المشاهدات
│   │   │   │   ├── الدوال
│   │   │   │   └── المتتاليات
│   │   │   └── مخططات_أخرى
│   │   └── الإعدادات
│   └── قاعدة البيانات 2
└── كائنات النظام

أوضاع التنقل

يقدم HarborDB وضعين رئيسيين للتنقل:

1. عرض الشجرة (افتراضي): توسيع هرمي للكائنات
2. عرض البحث: بحث سريع عبر جميع الكائنات

استكشاف قواعد البيانات

عرض قواعد البيانات المتاحة

عند الاتصال لأول مرة، سترى قائمة بقواعد البيانات التي يمكنك الوصول إليها:

1. وسّع اتصالك في الشريط الجانبي
2. انقر على "قواعد البيانات" لرؤية القائمة
3. انقر نقراً مزدوجاً على أي قاعدة بيانات لاستكشاف محتوياتها

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

انقر بزر الماوس الأيمن على أي قاعدة بيانات للوصول السريع إلى:

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

العمل مع المخططات

فهم المخططات

المخططات هي حاويات منطقية داخل قواعد البيانات. الافتراضي في PostgreSQL هو المخطط public، ولكن قد تواجه مخططات أخرى.

استكشاف محتويات المخطط

1. وسّع قاعدة بيانات لرؤية مخططاتها
2. وسّع مخططاً لرؤية أنواع الكائنات:
   • الجداول: تخزين البيانات
   • المشاهدات: جداول افتراضية من الاستعلامات
   • الدوال: الإجراءات المخزنة والدوال
   • المتتاليات: مولّدات الأرقام التلقائية التزايدية

عمليات المخطط

انقر بزر الماوس الأيمن على مخطط لـ:

• إنشاء جدول/مشهد/دالة جديدة
• تحديث محتويات المخطط
• تعيين كافتراضي: اجعل هذا مخططك المفضل

فحص الجداول

عرض هيكل الجدول

عند توسيع مجلد "الجداول"، سترى جميع الجداول في المخطط. انقر على أي جدول لرؤية:

علامة تبويب الأعمدة

• أسماء الأعمدة وأنواع البيانات
• القيود (المفتاح الأساسي، المفتاح الخارجي، إلخ.)
• القيم الافتراضية وحالة إمكانية أن تكون فارغة
• معلومات التخزين

علامة تبويب معاينة البيانات

• أول 100 صف من بيانات الجدول
• أعمدة قابلة للفرز (انقر على العناوين)
• بيانات قابلة للتصفية (انقر بزر الماوس الأيمن على عناوين الأعمدة)
• خيارات التصدير السريع

علامة تبويب الفهارس

• أسماء الفهارس وأنواعها
• الأعمدة المفهرسة
• حجم الفهرس والإحصاءات

علامة تبويب المفاتيح الخارجية

• العلاقات مع جداول أخرى
• الجداول والأعمدة المشار إليها
• قواعد التتابع

إجراءات سريعة للجدول

انقر بزر الماوس الأيمن على أي جدول للوصول الفوري إلى:

| الإجراء | الوصف | اختصار لوحة المفاتيح | | -------------------- | ----------------------------------------- | -------------------- | | اختيار أول 100 | افتح استعلاماً مع SELECT * FROM table LIMIT 100 | ⌘ + نقر | | عرض الهيكل | افتح هيكل الجدول في عرض التفاصيل | ⌥ + نقر | | إنشاء SELECT | إنشاء استعلام SELECT أساسي لهذا الجدول | | | إنشاء INSERT | إنشاء قالب INSERT | | | تصدير البيانات | تصدير الجدول إلى CSV/JSON | ⌘ + E | | تحديث | تحديث معلومات الجدول | ⌘ + R |

فهم المشاهدات

المشهد مقابل الجدول

تظهر المشاهدات مشابهة للجداول ولكنها كائنات افتراضية مبنية على استعلامات SQL:

• المشاهدات العادية: تعريفات الاستعلامات المخزنة
• المشاهدات المجسّدة: نتائج محسوبة مسبقاً (مخزنة مؤقتاً)

معلومات المشهد

انقر على أي مشهد لرؤية:

• التعريف: استعلام SQL الذي يحدد المشهد
• الأعمدة: هيكل مجموعة النتائج
• التبعيات: الجداول والمشاهدات التي يعتمد عليها هذا المشهد

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

التصفية والبحث

عند التعامل مع العديد من الكائنات، استخدم هذه الميزات:

عامل تصفية سريع

1. انقر في مربع البحث أعلى الشريط الجانبي
2. اكتب اسم الكائن للتصفية في الوقت الفعلي
3. استخدم الأحرف البدل: *users* يجد جميع الكائنات التي تحتوي على "users" في الاسم

بحث متقدم

• نطاق البحث: قصر على الجداول أو المشاهدات أو جميع الكائنات
• تبديل حساسية الأحرف: تطابق الأحرف الدقيقة
• دعم التعبير النمطي: استخدم التعبيرات النمطية لأنماط معقدة

الكائنات المفضلة

ضع علامة على الكائنات التي يتم الوصول إليها بشكل متكرر للاسترجاع السريع:

1. انقر بزر الماوس الأيمن على أي كائن
2. اختر "إضافة إلى المفضلة"
3. الوصول إلى المفضلة من قسم المفضلة في الشريط الجانبي

فحص العلاقات

تصور علاقات الجداول

يساعدك HarborDB على فهم كيفية اتصال الجداول:

تصور المفتاح الخارجي

1. انقر بزر الماوس الأيمن على أي جدول به مفاتيح خارجية
2. اختر "إظهار العلاقات"
3. اعرض التمثيل البياني للاتصالات

تحليل التبعية

• انظر ما الذي يعتمد على هذا الجدول
• تحديد المراجع الدائرية
• فهم تأثير تغييرات المخطط

متصفح العلاقات

لقواعد البيانات المعقدة، استخدم متصفح العلاقات:

1. افتح قائمة الأدوات → متصفح العلاقات
2. اختر جدول البداية
3. استكشف الاتصالات مرئياً
4. صدّر مخطط العلاقات للتوثيق

أمثلة عملية للتنقل

المثال 1: استكشاف قاعدة بيانات جديدة

عند الاتصال بقاعدة بيانات غير مألوفة:

1. تحقق من حجم قاعدة البيانات (انقر بزر الماوس الأيمن على قاعدة البيانات → الخصائص)
2. اسرد جميع المخططات وحدد الرئيسية منها
3. راجع عدد الجداول في كل مخطط
4. افحص أكبر الجداول (فرز حسب عدد الصفوف أو الحجم)
5. ابحث عن جداول التوثيق (غالباً ما تسمى: docs، documentation، readme)

المثال 2: العثور على بيانات محددة

عندما تحتاج إلى تحديد موقع معلومات العميل:

1. ابحث عن جداول تحتوي على "customer" أو "user" أو "client"
2. افحص الجداول المحتملة للأعمدة ذات الصلة
3. تحقق من المفاتيح الخارجية للعثور على البيانات ذات الصلة
4. استخدم معاينة البيانات لأخذ عينة من البيانات الفعلية

المثال 3: فهم هيكل التطبيق

لفهم كيفية تنظيم التطبيق للبيانات:

1. جمّع الجداول حسب البادئة (مثال: app_، auth_، report_)
2. افحص اصطلاحات التسمية
3. ابحث عن أنماط المفاتيح الخارجية
4. حدد جداول البحث/المرجع

اختصارات لوحة المفاتيح للتنقل

أتقن هذه الاختصارات للتنقل الفعال:

| الاختصار | الإجراء | | ---------- | ------------------------------- | | ⌘ + B | تبديل رؤية الشريط الجانبي | | ⌘ + F | ركز على البحث في الشريط الجانبي | | ⌘ + G | ابحث عن التالي في نتائج البحث | | ⌥ + نقر | افتح الكائن في علامة تبويب جديدة | | ⌘ + نقر | افتح استعلام SELECT للجدول | | ⌘ + R | تحديث العرض الحالي | | ⌘ + . | مسح البحث/عامل التصفية | | ⌘ + 1-9 | التبديل بين أقسام الشريط الجانبي |

أفضل ممارسات التنقل

نصائح التنظيم

1. استخدم أسماء اتصالات ذات معنى: اشمل البيئة (تطوير، إنتاج) والغرض
2. جمّع الاتصالات ذات الصلة: التطوير المحلي، المرحلة الانتقالية، الإنتاج
3. شفّر بالألوان حسب البيئة: أخضر للتطوير، أصفر للمرحلة الانتقالية، أحمر للإنتاج
4. أنشئ قوالب اتصال: لإعدادات قاعدة البيانات المماثلة

اعتبارات الأداء

1. حدّد التوسيع التلقائي: لا تُوسّع كل شيء في وقت واحد
2. استخدم البحث بدلاً من التصفح لقواعد البيانات الكبيرة
3. أغلق الاتصالات غير المستخدمة لتحرير الموارد
4. امسح ذاكرة التخزين المؤقت دورياً للمخططات الكبيرة جداً

ممارسات الأمان

1. استخدم بيانات اعتماد خاصة بالاتصال عندما يكون ذلك ممكناً
2. حدّد رؤية المخطط بالأذونات المناسبة
3. تجنب حفظ كلمات مرور الإنتاج في بيئات أقل أماناً
4. راجع استخدام الاتصال بانتظام

استكشاف أخطاء مشكلات التنقل وإصلاحها

أخطاء "الكائن غير موجود"

إذا لم تتمكن من رؤية الكائنات المتوقعة:

1. حدّث الاتصال (انقر بزر الماوس الأيمن → تحديث)
2. تحقق من أذوناتك على قاعدة البيانات
3. تحقق من أنك في المخطط الصحيح
4. أكد أن الكائن لم يتم إعادة تسميته أو إزالته

أداء تنقل بطيء

للرد البطيء:

1. قلّل عمق التوسيع التلقائي في التفضيلات
2. عطّل معاينات الصور المصغرة للجداول الكبيرة
3. زِد مهلة الاستعلام للاتصالات البعيدة
4. استخدم البحث بدلاً من توسيع الشجرة

علاقات مفقودة

إذا لم تظهر المفاتيح الخارجية:

1. تحقق من تعريف المفاتيح الخارجية بشكل صحيح في PostgreSQL
2. تحقق من أن لديك أذونات لعرض معلومات القيد
3. حدّث بيانات تعريف الجدول
4. تحقق من التحقق المؤجل للقيود

ميزات التنقل المتقدمة

استعلامات مخصصة للاستكشاف

أنشئ استعلامات محفوظة للاستكشاف المعقد:

-- ابحث عن جميع الجداول بعمود محدد
SELECT
    table_schema,
    table_name,
    column_name,
    data_type
FROM information_schema.columns
WHERE column_name ILIKE '%email%'
ORDER BY table_schema, table_name;

-- اسرد أكبر الجداول
SELECT
    schemaname,
    tablename,
    pg_size_pretty(pg_total_relation_size(schemaname || '.' || tablename)) as size
FROM pg_tables
WHERE schemaname NOT IN ('pg_catalog', 'information_schema')
ORDER BY pg_total_relation_size(schemaname || '.' || tablename) DESC
LIMIT 20;

وضع إشارات مرجعية للمسارات الشائعة

احفظ مسارات التنقل التي يتم الوصول إليها بشكل متكرر:

1. تنقل إلى كائنك الهدف
2. انقر على زر الإشارة المرجعية في شريط الأدوات
3. سمّ الإشارة المرجعية (مثال: "جداول تحليلات العميل")
4. الوصول إلى الإشارات المرجعية من قائمة الإشارات المرجعية

تصدير هيكل قاعدة البيانات

وثّق هيكل قاعدة البيانات الخاصة بك:

1. اختر الكائنات في الشريط الجانبي
2. انقر بزر الماوس الأيمن → تصدير الهيكل
3. اختر التنسيق: SQL، أو Markdown، أو HTML
4. اشمل الخيارات: مع البيانات، القيود، الفهارس

الخطوات التالية

الآن بعد أن أصبح بإمكانك التنقل في قواعد البيانات بشكل فعال:

1. أساسيات الاستعلام - تعلّم كتابة وتنفيذ استعلامات SQL
2. تصدير البيانات - احفظ النتائج إلى CSV أو JSON
3. تحسين الأداء - حسِّن سير عمل قاعدة البيانات الخاصة بك

الحصول على المساعدة

إذا واجهت مشكلات في التنقل:

1. تحقق من دليل الدعم لاستكشاف الأخطاء وإصلاحها
2. زر الأسئلة الشائعة للأسئلة الشائعة
3. اتصل بالدعم للحصول على مساعدة مخصصة