تعديل إعدادات قاعدة بيانات PostgreSQL في ServBay

يوفر ServBay لمطوري macOS بيئة تطوير ويب محلية قوية، تتضمن ضمنها قاعدة بيانات PostgreSQL. يوضح هذا الدليل بالتفصيل كيفية تعديل إعدادات PostgreSQL في ServBay، مع التركيز على الطريقة الموصى بها عبر الواجهة الرسومية UI، وأيضاً طريقة التعديل اليدوي والتي ينصح بها فقط لاحتياجات مؤقتة أو للمستخدمين المتقدمين.

تبعاً لإصدار PostgreSQL المثبت في ServBay، توجد ملفات التكوين الرئيسية غالباً في المسار /Applications/ServBay/etc/postgresql/<version>، مثلاً ملفات تكوين PostgreSQL 16 ستكون في /Applications/ServBay/etc/postgresql/16.

تنبيه هام

يدير ServBay معظم إعدادات التكوين من خلال واجهته الرسومية (UI) ويولّد ملفات التكوين تلقائياً. ننصحك بشدة بتعديل الإعدادات فقط عبر واجهة ServBay UI. التعديل اليدوي لملفات التكوين قد يؤدي إلى فقدان تغييراتك عند قيام ServBay بإدارة أو تحديث الإعدادات لاحقاً. التعديل اليدوي مخصص فقط للاختبارات المؤقتة أو للمستخدمين المتقدمين الذين يفهمون تكوين النظام على مستوى منخفض، ولا يوصى به للإعدادات الدائمة أو في بيئة الإنتاج.

تعديل الإعدادات من خلال واجهة ServBay UI (موصى به)

توفر ServBay واجهة إدارة رسومية بديهية، وهي الطريقة الأسهل والأكثر أماناً لتعديل إعدادات PostgreSQL. أغلب التعديلات التي تتم من خلال الواجهة الرسومية تُطبّق فوراً ولا تحتاج غالباً لإعادة تشغيل الخدمة (ما لم تظهر رسالة بذلك).

خطوات التنفيذ

1. افتح تطبيق ServBay.
2. من شريط التنقل الجانبي، اختر قاعدة البيانات.
3. في قائمة قواعد البيانات، ابحث عن PostgreSQL ثم انقر على الإصدار المناسب الذي ترغب في تعديله.
4. بعد دخولك لواجهة إعدادات PostgreSQL، ستجد تفاصيل الإصدار الحالي وخيارات التكوين.

الخيارات القابلة للتعديل

تستطيع من خلال هذه الواجهة مشاهدة اسم المستخدم الافتراضي وكلمة مرور PostgreSQL (عادةً ما تظهر في نفس الصفحة)، بالإضافة إلى قدرة التعديل المباشر لبعض المعاملات الشائعة:

• عنوان الاستماع (listen_addresses): يحدد الواجهات الشبكية التي يستمع لها PostgreSQL. الافتراضي غالباً هو * بمعنى جميع الواجهات المتاحة.
• المنفذ (port): رقم المنفذ الذي يستقبل عليه PostgreSQL الاتصالات. المنفذ الافتراضي هو 5432 (وتذكر أن هذا يختلف عن 3306 الخاص بـ MySQL/MariaDB).
• الحد الأقصى للاتصالات (max_connections): الحد الأقصى لعدد العملاء الممكن اتصالهم بقاعدة البيانات في نفس الوقت.
• ذاكرة العمل (work_mem): مقدار الذاكرة المخصصة لكل عملية استعلام لكل اتصال أثناء إجراء عمليات الفرز أو جداول التجزئة.

يمكنك أيضاً إضافة أو تعديل إعدادات أخرى غير مدرجة بشكل مباشر في الواجهة من خلال قسم Additional Parameters، حيث تكتب كل إعداد في سطر منفصل بالشكل اسم_الإعداد = القيمة.

تطبيق التعديلات

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

تعديل الإعدادات من خلال تحرير ملفات التكوين يدوياً (غير موصى به للحلول الدائمة)

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

WARNING

تحرير ملفات التكوين يدوياً يصلح فقط للتجربة المؤقتة أو عند الحاجة لاستكشاف المشاكل على مستوى متقدم. يوصي ServBay بشدة باستخدام مهام التكوين من خلال الواجهة الرسومية للحفاظ على ثبات الإعدادات ومطابقتها. قد يتم إعادة ضبط الملفات التي تم تعديلها يدوياً بسبب طريقة إدارة ServBay الداخلية.

مسارات ملفات التكوين

الملفات الرئيسية لتكوين PostgreSQL في ServBay هما postgresql.conf وpg_hba.conf، وتوجد غالباً في:

• postgresql.conf: /Applications/ServBay/etc/postgresql/<version>/postgresql.conf
• pg_hba.conf: /Applications/ServBay/etc/postgresql/<version>/pg_hba.conf

يرجى الانتباه إلى أن المسار /db/postgresql/16/pg_hba.conf المذكور في بعض الوثائق قد يكون من بقايا إصدارات أقدم أو طريقة إدارة ServBay الداخلية، بينما يتم إدارة ملفات التكوين بشكل أساسي تحت /Applications/ServBay/etc. تأكد من المسار الفعلي عند التعديل اليدوي. للحصول على ثبات التكوين، المسار /Applications/ServBay/etc/postgresql/<version> هو الأكثر موثوقية.

أمثلة لإعدادات شائعة

فيما يلي أمثلة لبعض الإعدادات في postgresql.conf وpg_hba.conf. لتحرير هذه الملفات، استخدم محرر نصوص (مثل VS Code أو Sublime Text أو Nano)، ويُفضل تشغيله كمسؤول.

postgresql.conf

يعد postgresql.conf ملف التكوين الرئيسي للخادم، ويتحكم بأغلب سلوك النظام:

# عنوان الاستماع: الواجهات الشبكية التي يستمع لها الخادم. '*' تعني كل الواجهات.
listen_addresses = '*'

# رقم المنفذ: منفذ الشبكة الذي يعمل عليه الخادم. المنفذ الافتراضي لـ PostgreSQL هو 5432.
port = 5432

# الحد الأقصى للاتصالات: العدد الأقصى للمستخدمين المتزامنين المسموح باتصالهم بقاعدة البيانات.
max_connections = 100

# حجم الذاكرة المشتركة المؤقتة: الذاكرة المخصصة لتخزين بيانات قاعدة البيانات مؤقتًا.
shared_buffers = 128MB

# دليل السجلات: المكان الذي تُخزن فيه ملفات السجلات.
log_directory = 'log'

# نمط تسمية ملف السجل: كيف يتم تسمية ملفات السجلات.
log_filename = 'postgresql-%Y-%m-%d.log'

# تفعيل سجل الاستعلامات البطيئة: يسجل الاستعلامات التي يتجاوز تنفيذها وقتاً معيناً (بالملي ثانية).
# استخدم عدد موجب؛ مثلاً 2000 تعني تسجيل الاستعلامات التي تستغرق أكثر من ثانيتين.
# السالب (-1) يعطل تسجيل الاستعلامات البطيئة.
log_min_duration_statement = 2000

pg_hba.conf

يستخدم ملف pg_hba.conf (المصادقة المعتمدة على المضيف) لتحديد طرق وأذونات وصول العملاء لقاعدة البيانات.

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# يسمح بالاتصال المحلي عبر مآخذ Unix دون كلمة مرور (trust).
# "local" هو للاتصالات عبر Unix domain socket فقط
local   all             all                                     trust

# يسمح لجميع عناوين IPv4 بالاتصال عن بعد عبر TCP/IP باستخدام مصادقة md5 (كلمة سر).
# اتصالات محلية IPv4:
host    all             all             0.0.0.0/0               md5

# يسمح لنطاق عناوين IPv4 محدد (مثلاً شبكة 192.168.1.0/24) بالاتصال عن بعد عبر TCP/IP باستخدام مصادقة md5.
# اتصالات IPv4 محلية من شبكة فرعية محددة:
# host    all             all             192.168.1.0/24          md5

عند تعديل pg_hba.conf، احرص على فهم كل عمود (TYPE, DATABASE, USER, ADDRESS, METHOD) لأن الإعدادات الخاطئة قد تؤدي إلى منع الاتصالات بقاعدة البيانات أو إلى ثغرات أمنية.

تفعيل التعديلات اليدوية

بعد تعديل أي ملفات تكوين يدوياً، يتوجب عليك إعادة تشغيل خدمة PostgreSQL لتُطبق التغييرات.

إعادة التشغيل عبر واجهة ServBay

1. افتح الواجهة الإدارية لـ ServBay.
2. من شريط التنقل الجانبي، اختر قاعدة البيانات.
3. ابحث عن PostgreSQL واختر الإصدار المناسب.
4. في نفس الصفحة أو ضمن قائمة "الحزم"/"الخدمات" في واجهة ServBay الرئيسية، حدد خدمة PostgreSQL للإصدار المختار واضغط زر إعادة التشغيل.

إعادة التشغيل عبر أداة الأوامر servbayctl

توفر أداة سطر الأوامر servbayctl الخاصة بـ ServBay طريقة سهلة لإدارة وإعادة تشغيل الخدمات، بما فيها PostgreSQL:

servbayctl restart postgresql <version>

استبدل <version> برقم إصدار PostgreSQL الذي تستخدمه، مثل 16.

الخلاصة

يقدم ServBay واجهة رسومية سهلة وفعالة لتعديل إعدادات PostgreSQL، وهي الطريقة الموصى بها لأنها تضمن استقرار الإعدادات وتمنع فقدانها عند إدارة النظام للملفات. يمكنك من خلال الواجهة تعديل خيارات أساسية كعناوين الاستماع والمنفذ والاتصالات والإطلاع على بيانات الدخول الافتراضية. أما الحالات التي تتطلب تعديلاً يدوياً (كالتجارب المؤقتة)، فالملفات الرئيسية توجد في /Applications/ServBay/etc/postgresql/<version>. وأياً كانت طريقة التعديل، يجب عادةً إعادة تشغيل خدمة PostgreSQL لتفعيل الإعدادات الجديدة، ويمكنك تنفيذ ذلك عبر الواجهة أو باستخدام أداة الأوامر servbayctl.

فهم هذه الإعدادات وطرق تعديلها سيساعدك في تهيئة بيئة PostgreSQL ضمن ServBay بما يلبي متطلبات عملية التطوير لديك.