إنشاء أول اتصال لك

مرحباً بك في HarborDB! سيوجهك هذا الدليل خلال إنشاء أول اتصال لك مع PostgreSQL. سواء كنت تتصل بقاعدة بيانات محلية على جهاز Mac الخاص بك أو بخادم بعيد، يجعل HarborDB العملية بسيطة وآمنة.

المتطلبات المسبقة

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

1. HarborDB مثبتاً (راجع دليل التثبيت)
2. خادم PostgreSQL قيد التشغيل ويمكن الوصول إليه
3. تفاصيل الاتصال جاهزة:
   • اسم المضيف أو عنوان IP
   • رقم المنفذ (الافتراضي: 5432)
   • اسم قاعدة البيانات
   • اسم المستخدم وكلمة المرور
   • اختياري: شهادة SSL إذا كانت مطلوبة

الخطوة 1: شغّل HarborDB واذهب إلى الاتصالات

1. افتح HarborDB من مجلد التطبيقات أو Launchpad
2. حدد موقع الشريط الجانبي للاتصالات على الجانب الأيسر من النافذة
3. انقر على زر "+" أو انتقل إلى ملف → إضافة اتصال

الخطوة 2: املأ تفاصيل الاتصال

يحتوي مربع حوار الاتصال على عدة حقول لإكمالها:

معلومات أساسية

• الاسم: اسم ودود لهذا الاتصال (مثال: "التطوير المحلي"، "خادم الإنتاج")
• المضيف: عنوان خادم PostgreSQL
  • قاعدة بيانات محلية: localhost أو 127.0.0.1
  • خادم بعيد: عنوان IP أو اسم مضيف (مثال: db.example.com)
• المنفذ: منفذ PostgreSQL (الافتراضي: 5432)
• قاعدة البيانات: قاعدة البيانات المحددة للاتصال بها
• اسم المستخدم: اسم مستخدم PostgreSQL الخاص بك
• كلمة المرور: كلمة مرور PostgreSQL الخاصة بك

خيارات متقدمة (اختياري)

• المخطط: المخطط المفضل (الافتراضي: public)
• وضع SSL: اختر بناءً على تكوين الخادم لديك:
  • prefer: استخدم SSL إذا كان متوفراً
  • require: تطلب اتصال SSL
  • verify-full: تطلب SSL مع التحقق من الشهادة
• المهلة: مهلة الاتصال بالثواني
• اسم التطبيق: معرف مخصص لهذا الاتصال

الخطوة 3: اختبر اتصالك

قبل الحفظ، اختبر اتصالك دائماً:

1. انقر على "اختبار الاتصال" في مربع الحوار
2. انتظر التأكيد - يجب أن ترى "تم الاتصال بنجاح"
3. راجع أي تحذيرات حول SSL أو إعدادات أخرى

نتائج الاختبار الشائعة

• ✅ النجاح: أنت جاهز للحفظ والاتصال
• ❌ الفشل: تحقق من رسالة الخطأ للحصول على أدلة:
  • "تم رفض الاتصال": الخادم لا يعمل أو جدار الحماية يحجب
  • "فشلت المصادقة": اسم المستخدم/كلمة المرور غير صحيحين
  • "قاعدة البيانات غير موجودة": اسم قاعدة البيانات غير صحيح

الخطوة 4: احفظ الاتصال واجعله آمناً

خيارات تخزين كلمة المرور

يقدم HarborDB تخزيناً آمناً لكلمة المرور:

• حفظ في سلسلة المفاتيح (مُوصى به): كلمة مرور مشفرة في سلسلة مفاتيح macOS
• حفظ في الاتصال: كلمة مرور مخزنة مع إعدادات الاتصال (أقل أماناً)
• السؤال في كل مرة: مطالبة بكلمة المرور في كل اتصال

اختيار الخيار المناسب

| طريقة التخزين | الأمان | الراحة | الأفضل لـ | | ------------------ | ----------- | ----------- | --------------------------------- | | سلسلة مفاتيح macOS | 🔒 عالي | ⚡ عالية | الاستخدام اليومي، أجهزة موثوقة | | ملف الاتصال | 🔒 متوسط | ⚡ عالية | الإعداد السريع، الاختبار | | السؤال في كل مرة | 🔒 أعلى | ⚡ منخفضة | أجهزة مشتركة، أمان عالي |

حفظ اتصالك

1. اختر طريقة تخزين كلمة المرور
2. انقر على "حفظ" لتخزين الاتصال
3. ابحث عن اتصالك في الشريط الجانبي للاتصالات
4. انقر نقراً مزدوجاً للاتصال

الخطوة 5: اتصل واستكشف

بمجرد الاتصال، يمكنك:

التنقل في قاعدة البيانات الخاصة بك

• وسّع الاتصال لرؤية قواعد البيانات
• تصفح المخططات والجداول في الشريط الجانبي
• انقر بزر الماوس الأيمن على الجداول لإجراءات سريعة:
  • عرض هيكل الجدول
  • معاينة أول 100 صف
  • إنشاء استعلام SELECT

إجراءات البدء السريع

1. افتح محرر الاستعلام: انقر على أيقونة SQL أو اضغط على ⌘ + N

2. شغّل استعلام اختبار:

   SELECT version();
   

3. استكشف الواجهة: تعرف على علامات التبويب والألواح والأدوات

إدارة الاتصالات

تنظيم اتصالات متعددة

أثناء إضافة المزيد من الاتصالات، حافظ على تنظيمها:

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

تحرير الاتصالات الموجودة

1. انقر بزر الماوس الأيمن على الاتصال في الشريط الجانبي
2. اختر "تحرير الاتصال"
3. حدّث أي حقول حسب الحاجة
4. اختبر واحفظ التغييرات

تكرار الاتصالات

وفر الوقت بتكرار الاتصالات المماثلة:

1. انقر بزر الماوس الأيمن على الاتصال المصدر
2. اختر "تكرار"
3. عدّل الحقول المتغيرة فقط
4. احفظ كاتصال جديد

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

أمان كلمة المرور

• لا تشارك كلمات مرور سلسلة المفاتيح أبداً
• استخدم كلمات مرور قوية لمستخدمي PostgreSQL
• دور كلمات المرور دورياً
• تجنب إعادة استخدام كلمات المرور عبر خوادم مختلفة

أمان الاتصال

• استخدم SSL للاتصالات البعيدة
• حدّد أذونات قاعدة البيانات للعمليات الضرورية فقط
• استخدم اتصالات للقراءة فقط لإعداد التقارير
• راجع سجلات الاتصال بانتظام

أمان الشبكة

• تكوين جدار الحماية: اسمح فقط بعناوين IP موثوقة
• وصول VPN لقواعد البيانات البعيدة
• نفق SSH لطبقات أمان إضافية

سيناريوهات اتصال شائعة

PostgreSQL محلي (مثبت عبر Homebrew)

الاسم: PostgreSQL المحلي
المضيف: localhost
المنفذ: 5432
قاعدة البيانات: postgres
اسم المستخدم: اسم_المستخدم_الخاص_بك
كلمة المرور: [سلسلة المفاتيح]

حاوية Docker لـ PostgreSQL

الاسم: قاعدة بيانات Docker للتطوير
المضيف: localhost
المنفذ: 5432  # أو منفذ مخصص إذا كان معيناً بشكل مختلف
قاعدة البيانات: قاعدة_بيانات_التطبيق
اسم المستخدم: postgres
كلمة المرور: كلمة_مرور_postgres

Amazon RDS PostgreSQL

الاسم: AWS الإنتاج
المضيف: your-db-instance.region.rds.amazonaws.com
المنفذ: 5432
قاعدة البيانات: قاعدة_بيانات_الإنتاج
اسم المستخدم: مستخدم_التطبيق
وضع SSL: verify-full

Google Cloud SQL

الاسم: GCP Cloud SQL
المضيف: /cloudsql/project:region:instance
المنفذ: 5432
قاعدة البيانات: قاعدة_بيانات_السحابة
وضع SSL: require

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

"لا يمكن الاتصال بالخادم"

1. تحقق من تشغيل PostgreSQL:

   # في Terminal
   pg_isready -h localhost -p 5432
   

2. تحقق من إعدادات جدار الحماية:

   • جدار حماية macOS (تفضيلات النظام → الأمان والخصوصية)
   • قواعد جدار حماية الشبكة

3. اختبر اتصال الشبكة:

   # في Terminal
   ping عنوان-الخادم-الخاص-بك
   telnet عنوان-الخادم-الخاص-بك 5432
   

"فشلت مصادقة كلمة المرور"

1. تحقق من طريقة مصادقة PostgreSQL:

   • اعرض ملف pg_hba.conf
   • تأكد من المصادقة md5 أو scram-sha-256

2. أعد تعيين كلمة المرور إذا لزم الأمر:

   ALTER USER اسم_المستخدم WITH PASSWORD 'كلمة_مرور_جديدة';
   

3. تحقق من وصول المستخدم إلى قاعدة البيانات:

   -- اتصل كمسؤول
   \du  -- ا列出 المستخدمين
   \l   -- ا列出 قواعد البيانات
   

أخطاء اتصال SSL/TLS

1. تحقق من متطلبات SSL:

   • قد يتطلب الخادم وضع SSL محدداً
   • قد تحتاج إلى استيراد الشهادة

2. اضبط وضع SSL في إعدادات الاتصال

3. استورد الشهادة إذا كنت تستخدم وضع verify-full

نصائح الأداء

تجميع الاتصالات

• احتفظ بالاتصالات مفتوحة للاستخدام المتكرر
• أغلق الاتصالات غير المستخدمة لتحرير الموارد
• استخدم تجميع الاتصالات للتطبيقات

تحسين الشبكة

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

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

الآن بعد أن اتصلت:

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

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

إذا كنت لا تزال تواجه مشكلة:

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