قد يبدو ALTER TABLE متوقفاً رغم انخفاض استهلاك CPU. ربما يكون السبب معاملة قرأت الجدول ثم بقيت مفتوحة في جلسة خاملة، لا استعلاماً مكلفاً. يحمي MySQL تعريفات الكائنات بأقفال Metadata Lock، ولذلك قد تمنع المعاملة غير المكتملة تغيير البنية. يستهدف الدليل MySQL 8.0 و8.4؛ تحقق بشكل مستقل من MariaDB والإصدارات الأقدم.
١. ميّز قفل البيانات الوصفية عن قفل الصفوف
تحمي أقفال الصفوف السجلات المعدلة، بينما تحمي أقفال Metadata Lock تعريف الجدول واتساق الوصول المتزامن. قد تحتفظ معاملة صريحة نفذت SELECT فقط بقفل الجدول حتى تنتهي. لذلك يمكن لجلسة Sleep أن تمنع DDL. انخفاض CPU أو غياب استعلام حالي لا يثبت انتهاء المعاملة.
قد يسهم طلب DDL ينتظر قفلاً حصرياً في تكوين طابور لعمليات لاحقة على الجدول نفسه. إذا ارتفع زمن استجابة التطبيق أثناء ترحيل البنية، فلا تبدأ عدة أوامر ALTER إضافية. ابحث أولاً عن سلسلة الانتظار. لا يعني Online DDL أو Instant DDL الاستغناء الكامل عن أقفال البيانات الوصفية.
٢. حدد الجلسة المنتظرة والجلسات المانعة
SELECT VERSION();
SHOW FULL PROCESSLIST;
SELECT object_schema, object_name,
waiting_pid, waiting_query_secs, waiting_query,
blocking_pid, blocking_account, blocking_lock_type
FROM sys.schema_table_lock_waits
ORDER BY waiting_query_secs DESC;
يعرض View في sys معرّف Processlist للجلسة المنتظرة ومعرّف الجلسة المانعة. قد توجد عدة جلسات مانعة لطلب واحد؛ احتفظ بجميع الصفوف وقارن الحساب والمضيف وعمر المعاملة مع عملية النشر. استخدم حساب تشخيص مصرحاً له. قد يعني غياب النتائج نقص الصلاحيات أو أدوات القياس، وليس غياب القفل.
٣. افحص المعاملة والأقفال الأساسية
SELECT trx_mysql_thread_id, trx_started, trx_state, trx_query
FROM information_schema.innodb_trx
ORDER BY trx_started;
SELECT ml.OBJECT_SCHEMA, ml.OBJECT_NAME,
ml.LOCK_TYPE, ml.LOCK_DURATION, ml.LOCK_STATUS,
th.PROCESSLIST_ID, th.PROCESSLIST_USER, th.PROCESSLIST_INFO
FROM performance_schema.metadata_locks AS ml
LEFT JOIN performance_schema.threads AS th
ON th.THREAD_ID = ml.OWNER_THREAD_ID
WHERE ml.OBJECT_TYPE = 'TABLE'
AND ml.OBJECT_SCHEMA = 'appdb'
AND ml.OBJECT_NAME = 'orders';
استبدل appdb وorders بالمخطط والجدول المتأثرين. تشير GRANTED إلى قفل ممنوح وPENDING إلى طلب لم يحصل على القفل. يوفر الربط مع threads معرّف Processlist؛ لا تستخدم THREAD_ID الداخلي باعتباره معرّف KILL. ليس كل قفل ممنوح هو المانع المطلوب: قارن نوع القفل واستعن بالعلاقة التي يعرضها sys عندما تتاح.
إذا لم تتوفر بيانات القياس، افحص wait/lock/metadata/sql/mdl في performance_schema.setup_instruments ونسق أي تغيير مع مسؤول قاعدة البيانات. لا تفعّل كل أدوات Performance Schema بلا حاجة. قد تمنع صلاحيات PROCESS المحدودة رؤية معاملات حساب آخر؛ اطلب جلسة تشخيص مصرحاً بها بدلاً من التخمين.
٤. عالج الانتظار بأقل أثر
- إذا كان DDL اختيارياً وبدأ طابور الطلبات بالنمو، ألغِ الترحيل المنتظر عبر مالكه أو أداة النشر أولاً.
- اطلب من مالك المعاملة إنهاءها بقرار صحيح: COMMIT لحفظ التغييرات أو ROLLBACK للتراجع عنها. يجب تنفيذ ذلك داخل الجلسة المالكة.
- لا تفترض أن KILL QUERY لجلسة خاملة أنهى المعاملة؛ إلغاء عبارة لا يساوي دائماً إنهاء المعاملة.
- استخدم KILL CONNECTION فقط بعد التحقق من معرّف الجلسة الحالي والصلاحية والأثر وخطة الاستعادة. قطع الاتصال قد يتراجع عن العمل غير المثبت، وقد يستغرق التراجع وقتاً.
٥. قيّد انتظار الترحيل داخل جلسته
-- In the migration connection, before the reviewed DDL:
SET SESSION lock_wait_timeout = 10;
يحد المثال انتظار قفل Metadata Lock في هذه الجلسة، ولا يضمن انتهاء ALTER كله خلال عشر ثوان. اختر المهلة حسب سياسة النشر والعميل. يعالج innodb_lock_wait_timeout انتظار أقفال صفوف InnoDB وليس بديلاً عن سياسة قفل البيانات الوصفية. تجنب تغيير القيم العامة أثناء الحادث دون تقييم أثرها على التطبيقات الأخرى.
٦. أعد إنتاج الحالة في مختبر قابل للحذف
-- Lab only: disposable database and table
CREATE DATABASE mdl_lab;
CREATE TABLE mdl_lab.demo (id INT PRIMARY KEY);
INSERT INTO mdl_lab.demo VALUES (1);
-- Session A
START TRANSACTION;
SELECT * FROM mdl_lab.demo;
-- Leave this transaction open briefly.
-- Session B, separate connection
SET SESSION lock_wait_timeout = 5;
ALTER TABLE mdl_lab.demo ADD COLUMN note VARCHAR(50);
-- Session A, after observing the wait
ROLLBACK;
نفذ الجلستين يدوياً في بيئة غير إنتاجية. قد تنتهي مهلة ALTER قبل إنهاء الجلسة A؛ أعد المحاولة فقط بعد تحرير المعاملة. تحقق أولاً من التعريف الفعلي باستخدام SHOW CREATE TABLE mdl_lab.demo. إذا أضيف العمود بالفعل، ستفشل محاولة إضافته مرة أخرى. لا تستخدم جدول الطلبات الحقيقي لإثبات السلوك.
٧. تحقق من التعافي ومنع التكرار
تأكد من اختفاء الانتظار وعودة زمن الاستجابة والأخطاء إلى الوضع المعتاد ووجود البنية المقصودة فعلاً. راقب عمر المعاملات بعد الحادث. اجعل المعاملات قصيرة وأنهِها بشكل مضمون في مسارات الاستثناء. لا تتركها مفتوحة أثناء انتظار المستخدم أو طلب شبكة بطيء. اختبر الترحيل تحت حمل واقعي مع نسخة احتياطية ونافذة تنفيذ محكومة.
قد تقطع إعادة تشغيل الخادم الاتصالات وتمحو سياق التشخيص؛ ليست الخطوة الأولى. إذا كان العطل قفل صفوف أو Deadlock، راجع الدليل المنفصل في أرشيف المقالات العربية.
مراجع رسمية
MySQL metadata locking · sys.schema_table_lock_waits · Performance Schema metadata_locks
