هجرة ‏MySQL 8.0 إلى 8.4 LTS على خادم VPS: دليل شامل

لماذا تهاجر الآن: انتهاء الدعم والتعرض للثغرات

التغييرات الجذرية التي يجب معرفتها قبل الترقية

• حذف ‏mysql_native_password‏: تمت إزالة هذا المكوّن الإضافي للمصادقة نهائياً في ‏MySQL 8.4 (كان مُهملاً فقط في 8.0). أي حساب مستخدم يعتمد على هذا المكوّن سيفشل في الاتصال فوراً بعد الترقية. تطبيقات ‏PHP الأقدم من 8.1، و‏WordPress دون تهيئة ‏PDO صحيحة، وعملاء ‏JDBC القديمة هي الحالات الأكثر شيوعاً.
• تغيير المعامل ‏authentication_policy‏: أصبحت القيمة الافتراضية ‏caching_sha2_password‏، ويُتجاهل أي سطر ‏default_authentication_plugin‏ في ‏my.cnf‏ مع تحذير. يجب استبداله بـ‏authentication_policy‏.
• إزالة ‏innodb_file_format‏ والخيارات المرتبطة: حذف هذا المتغير. الجداول المنشأة بـ‏ROW_FORMAT=COMPRESSED‏ تعمل، لكن أي محاولة لتعيين ‏innodb_file_format‏ تنتج خطأ. تحقق من سكريبتات ‏DDL‏.
• تغييرات نوع ‏JSON‏: يُعزز ‏MySQL 8.4 توافق ‏JSON/SQL‏. دوال مثل ‏JSON_TABLE()‏ و‏JSON_VALUE()‏ قد تتصرف بشكل مختلف. تحقق من الجداول التي تحتوي على أعمدة ‏JSON‏ كبيرة في بيئة اختبار أولاً.
• مجموعة الأحرف والترتيب: تبقى ‏utf8mb4‏ و‏utf8mb4_0900_ai_ci‏ افتراضيتين، لكن ‏MySQL 8.4 ترفض بشكل أكثر صرامة الأعمدة المُعلنة بـ‏utf8‏ (اسم مستعار لـ‏utf8mb3‏). قد تكون هجرة الترتيب ضرورية لقواعد البيانات القديمة المنشأة تحت ‏MySQL 5.7.
• متغيرات النظام المُزالة أو المُعاد تسميتها: إزالة عدة متغيرات كانت مُهملة في 8.0 — خاصة ‏innodb_undo_tablespaces‏ و‏slave_*‏ (استُبدلت بـ‏replica_*‏ ) و‏query_cache_*‏.
• النسخ المتطابق: أسماء المتغيرات المرتبطة بالنسخ المتطابق تحولت نهائياً إلى مصطلح ‏source‏/‏replica‏. أي سكريبت يستدعي ‏SHOW SLAVE STATUS‏ يجب تحديثه إلى ‏SHOW REPLICA STATUS‏.

المتطلبات الأساسية قبل البدء

• نسخة احتياطية كاملة ومُتحقق منها: نفّذ ‏mysqldump --all-databases --single-transaction --routines --events > backup_pre_migration.sql‏ وتحقق أن الملف قابل للقراءة. نسخة احتياطية غير مُتحقق منها ليست نسخة احتياطية.
• الإصدار الحالي ومحركات الجداول: نفّذ ‏SELECT VERSION();‏ وأدرج الجداول غير المستندة إلى ‏InnoDB‏ من ‏information_schema.tables‏. يجب تقييم أي جدول ‏MyISAM‏ أو ‏MEMORY‏ قبل الترقية.
• توافق التطبيق: حدّد مكوّن المصادقة لكل حساب بـ‏SELECT user, host, plugin FROM mysql.user;‏. أي مستخدم على ‏mysql_native_password‏ يجب ترحيله إلى ‏caching_sha2_password‏.
• المساحة المتاحة على القرص: قد تضاعف الترقية مؤقتاً المساحة التي تشغلها ملفات ‏ibdata‏. تحقق من وجود 20% على الأقل من المساحة الحرة على قسم ‏/var‏.

إجراء هجرة ‏MySQL 8.0 → 8.4 LTS على خادم VPS

1. 01

   نسخة احتياطية كاملة مع التحقق

   نفّذ ‏mysqldump --all-databases --single-transaction --routines --events --triggers > /root/backup_mysql80_$(date +%Y%m%d).sql‏. تحقق من نهاية الملف بـ‏tail -5 /root/backup_mysql80_*.sql‏: يجب أن يكون آخر سطر ‏-- Dump completed on …‏. احفظ الملف خارج الخادم قبل المتابعة.

2. 02

   مراجعة الحسابات ومكوّنات المصادقة

   نفّذ ‏SELECT user, host, plugin FROM mysql.user ORDER BY plugin;‏. لكل مستخدم على ‏mysql_native_password‏، نفّذ ‏ALTER USER 'اسم'@'مضيف' IDENTIFIED WITH caching_sha2_password BY 'كلمة_مرور';‏. حدّث سلسلة الاتصال لكل تطبيق متأثر قبل الترقية.

3. 03

   التحقق من المتغيرات المُهملة في my.cnf

   افتح ‏/etc/mysql/mysql.conf.d/mysqld.cnf‏ وأزل أو استبدل: ‏default_authentication_plugin‏ بـ‏authentication_policy = caching_sha2_password‏، و‏slave_*‏ بـ‏replica_*‏، وأزل ‏innodb_undo_tablespaces‏ و‏query_cache_size‏ و‏query_cache_type‏. أي متغير غير معروف يمنع تشغيل ‏MySQL 8.4.

4. 04

   إيقاف الخدمة وأخذ لقطة

   على خادم ‏Proxmox‏ أو ‏KVM‏، خذ لقطة قبل تعديل الحزم عبر لوحة التحكم أو ‏API‏ لمزود الاستضافة. ثم: ‏systemctl stop mysql‏ وتحقق من التوقف بـ‏systemctl status mysql‏.

5. 05

   إضافة مستودع MySQL 8.4 وتحديث الحزم

   على ‏Debian 12 / Ubuntu 22.04‏: نزّل حزمة إعداد مستودع ‏MySQL‏ من ‏dev.mysql.com/downloads/repo/apt/‏، ثبّتها بـ‏dpkg -i mysql-apt-config_*.deb‏، اختر ‏MySQL 8.4 LTS‏ من القائمة، ثم نفّذ ‏apt-get update && apt-get install mysql-server‏.

6. 06

   ترقية جداول النظام

   عند أول تشغيل لـ‏MySQL 8.4‏، يُحدّث المحرك جداول النظام تلقائياً. تحقق من السجلات: ‏journalctl -u mysql -n 50 | grep -i 'upgrade\|error'‏. إذا لم تتم الترقية التلقائية، نفّذ ‏mysql_upgrade --user=root --password‏.

7. 07

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

   اتصل وتحقق من الإصدار: ‏SELECT VERSION();‏ يجب أن يُرجع ‏8.4.x‏. ثم نفّذ ‏mysqlcheck --all-databases --auto-repair --user=root --password‏ للكشف عن أي تلف في الجداول. راجع سجل الأخطاء ‏/var/log/mysql/error.log‏.

8. 08

   اختبار وظيفي للتطبيق

   أعد تشغيل التطبيق وتحقق من النقاط الحساسة: الاتصال بقاعدة البيانات، مصادقة المستخدمين، استعلامات أعمدة ‏JSON‏، الإجراءات المخزنة. الخطأ ‏The server requested authentication method unknown to the client‏ يعني وجود حساب لا يزال على ‏mysql_native_password‏.

9. 09

   التنظيف وتفعيل المراقبة

   احذف ملف النسخة الاحتياطية المحلية بعد تأكيد النسخة الخارجية. تحقق من أداة المراقبة: بعض أسماء المقاييس تغيرت بين 8.0 و8.4. جدوِل فحص سجل الأخطاء بعد 24 و72 ساعة من الهجرة.

MariaDB 11.x: متى تُفضّل هذا البديل

MySQL 8.0 مقابل MySQL 8.4 LTS مقابل MariaDB 11.x

مرّر الجدول أفقيًا

استكشاف الأخطاء: الأخطاء الشائعة بعد الهجرة

• ERROR 1045 (28000): Access denied‏ بعد الترقية: تحقق من مكوّن المصادقة بـ‏SELECT plugin FROM mysql.user WHERE user='اسم';‏. إذا كان لا يزال ‏mysql_native_password‏، نفّذ ‏ALTER USER … IDENTIFIED WITH caching_sha2_password BY '…';‏.
• Unknown system variable 'default_authentication_plugin'‏: هذا المتغير لم يعد مُعترفاً به في 8.4. أزله من ‏my.cnf‏ واستبدله بـ‏authentication_policy = caching_sha2_password‏.
• ‏MySQL لا يبدأ بعد الترقية: راجع ‏/var/log/mysql/error.log‏. الأكثر شيوعاً هو متغير نظام غير معروف في ‏my.cnf‏. علّق المتغيرات واحداً تلو الآخر حتى تحدد المصدر.
• تدهور الأداء في استعلامات الفرز: يُطبّق ‏MySQL 8.4 ترتيب الفهرس بصرامة أكبر. نفّذ ‏EXPLAIN‏ على الاستعلامات البطيئة. ‏ANALYZE TABLE اسم_الجدول;‏ يُجبر على تحديث الإحصائيات.
• جدول ‏performance_schema.replication_applier_status‏ غير موجود في سكريبتات المراقبة: بعض جداول ‏performance_schema‏ أُعيد تسميتها. حدّث استعلامات المراقبة وفق الأسماء الجديدة الموثّقة في ‏dev.mysql.com/doc/refman/8.4/en/performance-schema.html‏.

الانتقال إلى MySQL 8.4 LTS: ما يجب تذكره