تحذير: مسح فهارس قاعدة البيانات المفقودة في Nextcloud

يمكنك إزالة تحذير "قاعدة البيانات تفتقر إلى بعض الفهارس" من Nextcloud عن طريق تشغيل الأمر occ db:add-missing-indicesكمستخدم خادم الويب من تثبيت Nextcloud الصحيح. يُضيف هذا الأمر الفهارس المُعرّفة بواسطة Nextcloud أو التطبيقات المُثبّتة ولكنها غير موجودة في قاعدة البيانات؛ في وثائق Nextcloud 35 الحالية، --dry-runيتم عرض معاينة SQL قبل تشغيله.

ماذا يعني التحذير؟

فهرس قاعدة البيانات هو بنية بحث تساعد قاعدة البيانات في العثور على الصفوف دون الحاجة إلى مسح الجدول بأكمله. أحيانًا، تُضيف Nextcloud وتطبيقاتها فهارس لتحسين الاستعلامات. قد يُوكل التحديث هذه المهمة إلى مسؤول النظام، لأن إنشاء فهرس على جدول كبير قد يستغرق وقتًا ويؤثر على الأداء أثناء التنفيذ. عادةً ما يكون تحذير "الفهرس المفقود" تنبيهًا للصيانة، وليس دليلًا على تلف الملفات أو سجلات قاعدة البيانات.

يصف دليل أوامر قاعدة البيانات الحالي في Nextcloud db:add-missing-indicesإضافة الفهارس الموجودة في المخطط المتوقع ولكنها غير موجودة في التثبيت الحالي. كما يوثق الدليل الحالي --dry-runكيفية معاينة عبارات SQL. وتختلف الفهارس المحددة باختلاف إصدار Nextcloud والتطبيقات المثبتة.

تجهيز الخادم

• تأكد من أي نسخة من Nextcloud تعرض التحذير، خاصة إذا كنت تدير بيئة تجريبية وبيئة إنتاج أو أكثر من حاوية واحدة.
• تأكد من وجود نسخة احتياطية حديثة لقاعدة البيانات وأنك تعرف كيفية استعادتها. هذا الأمر يُغيّر بنية قاعدة البيانات. لا تقم بتعديل أو حذف الفهارس يدويًا كبديل.
• خطط لتنفيذ الأمر عندما يكون حمل قاعدة البيانات معقولاً. يمكن للخادم أن يبقى متصلاً بالإنترنت لهذه العملية وفقًا لإرشادات ترقية Nextcloud، ولكن فهرسة جدول كبير قد تستغرق وقتًا وتؤثر مؤقتًا على سرعة الاستجابة.
• ابحث عن مجلد تثبيت Nextcloud، وإصدار PHP CLI المستخدم من قِبل خادم الويب، وحساب نظام التشغيل الخاص بخادم الويب. غالبًا ما يكون هذا الحساب www-dataموجودًا على أنظمة Debian أو Ubuntu، أو apacheFedora أو CentOS، أو httpArch Linux.

يشرح دليل OCC الخاص بـ Nextcloud أن occهذه هي واجهة سطر الأوامر للخادم، ويجب تشغيلها باستخدام حساب مستخدم HTTP لضمان اتساق ملكية الملفات والأذونات. لا تستخدمها www-dataبشكل أعمى إذا كان تثبيتك يستخدم حسابًا مختلفًا.

قم بمعاينة وإضافة الفهارس المفقودة

لتثبيت ملف مضغوط قياسي على نظامي Debian أو Ubuntu، افتح نافذة طرفية على خادم Nextcloud وانتقل إلى المجلد الذي يحتوي على occالملف. يستخدم هذا المثال المسار التالي /var/www/nextcloud؛ قد يختلف المسار لديك.

cd /var/www/nextcloud
sudo -E -u www-data php occ db:add-missing-indices --dry-run

تُظهر عملية التشغيل التجريبي استعلام SQL الذي سيتم تنفيذه دون تغيير قاعدة البيانات. اقرأ المخرجات وتأكد من أنها عملية الصيانة المتوقعة. هذا --dry-runالخيار موثق في دليل Nextcloud 35 الحالي؛ إذا رفضه إصدار أقدم، فراجع تعليمات أوامر ذلك الإصدار بدلاً من إزالة الخيارات عشوائيًا.

عندما تكون مستعدًا لتطبيق التغيير، قم بتشغيل الأمر بدون --dry-run:

sudo -E -u www-data php occ db:add-missing-indices

يتحقق Nextcloud من الجداول ذات الصلة ويُبلغ عن التقدم. دعه يُكمل العملية؛ لا تُقاطعها لمجرد أن جدولًا كبيرًا يستغرق وقتًا أطول من المتوقع. يُدرج دليل الترقية هذا الأمر ضمن مهام المخطط الأطول التي يُمكن تشغيلها أثناء بقاء المثيل متصلًا بالإنترنت، لذا لا تحتاج عادةً إلى تفعيل وضع الصيانة لهذا الإصلاح. تجنب إجراء صيانة متزامنة لقاعدة البيانات أثناء تشغيله.

إذا كان Nextcloud يعمل في Docker

قم بتشغيل الأمر occداخل حاوية تطبيق Nextcloud، وليس داخل حاوية قاعدة البيانات المنفصلة. بالنسبة لحاوية تحمل اسم الحساب nextcloudالمعتاد www-data، يكون الأمر عادةً كالتالي:

docker exec --user www-data -it nextcloud php occ db:add-missing-indices

استبدل nextcloudهذا باسم حاوية تطبيقك الفعلي. إذا كانت صورتك أو عملية النشر تستخدم مستخدم حاوية مختلفًا، أو ملف PHP ثنائيًا مختلفًا، أو غلاف أوامر مختلفًا، فاتبع وثائق تلك الصورة واستمر في تشغيل الأمر كمستخدم HTTP.

تأكد من اختفاء التحذير

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

إذا استمر التحذير

1. تأكد من تشغيل الأمر على نفس تثبيت Nextcloud وقاعدة البيانات اللذين ظهر عليهما التحذير. من الأخطاء الشائعة تشغيله في حاوية صيانة أو بيئة تجريبية أو حاوية قاعدة بيانات.
2. تأكد من تشغيل الأمر بواسطة مستخدم خادم الويب الصحيح وباستخدام نفس إصدار PHP المستخدم في خادم الويب. يُشير Nextcloud إلى أن استخدام إعدادات PHP مختلفة في واجهة سطر الأوامر قد يُسبب occأخطاءً.
3. في Nextcloud 35 والإصدارات الأحدث، شغّل الأمر sudo -E -u www-data php occ db:schema:checkلفحص اختلافات المخطط. يشير المرجع الحالي إلى أن هذا الفحص أُضيف في الإصدار 35. أما في الإصدارات الأقدم، فاستخدم أدوات التشخيص الموثقة لذلك الإصدار.
4. إذا كان الفهرس المفقود تابعًا لتطبيق طرف ثالث، أو إذا أبلغ الأمر عن خطأ، فقم بتحديث التطبيق إن وُجد تحديث، وراجع سجل Nextcloud ومخرجات الأمر، واطلب من مطور التطبيق أو دعم Nextcloud أسماء الفهرس والجدول بدقة. لا تُنفّذ CREATE INDEXأوامر مكتوبة يدويًا إلا إذا وفّرها مطور التطبيق أو مطور قاعدة البيانات لمخططك المحدد.

بالنسبة لخادم الإنتاج، احتفظ بنسخة احتياطية من قاعدة البيانات حتى يزول التحذير ويعود التطبيق للعمل بشكل طبيعي. يتضمن دليل ترقية Nextcloud مهمة الصيانة عبر الإنترنت والتجربة التجريبية الاختيارية.