تدقيق الأداء ص99
حدد الاستعلامات البطيئة، وافهم شرح التحليل، واستراتيجيات الفهرسة، والأنماط الخمسة المضادة التي تقتل Postgres في الإنتاج.
قياس قبل التحسين#
يبدأ التدقيق بالأرقام. يعرض الاستوديو p50/p95/p99 عن طريق نقطة النهاية وعن طريق الاستعلام. احصل على خط أساس لمدة 7 أيام قبل أي تغيير.
استعلام أوامر aura db slow-queries وaura db stats CLI pg_stat_statements ومقاييس تجمع/حجم قاعدة البيانات في مشروعك المرتبط، على نطاق مشروعك (متوفر أيضًا في Studio › قاعدة البيانات والسجلات ). يسرد aura db inspect indexes|tables|locks استخدام الفهرس (مع وضع علامة على الفهرس غير المستخدم)، وأحجام الجدول والصفوف الميتة، وأقفال الحظر - التشخيصات التي لا يمكن لـ /raw تشغيلها لأنه يرفض كتالوجات النظام.
# أغلى 10 استفسارات (الوقت الإجمالي)
aura db slow-queries --limit 10
# الاتصالات وحجم قاعدة البيانات (زمن استجابة نقطة النهاية: الاستوديو ›السجلات)
aura db stats
pg_stat_statements في الوقت الحقيقي#
يتم تثبيت pg_stat_statements وتحميله مسبقًا في كل مشروع جديد. يقوم بتجميع كل استعلام تم تسويته (لا يتم تخزين أي قيم حرفية) مع mean_exec_time و calls و rows. لا يقرأه /raw مباشرة - العرض على مستوى المجموعة - لذا استخدم الأوامر أعلاه، والتي تُرجع استعلامات مشروعك فقط، أو Studio › Database.
aura db slow-queries --limit 10 --json
aura db inspect indexes # idx_scan = 0 وليس فريدًا/أساسيًا → غير مستخدم
اقرأ الخطة مثل المحترفين#
يتم إلغاء الاستعلام الذي يتم تشغيله لفترة أطول من مهلة بيان المشروع (10 ثوانٍ) باستخدام STATEMENT_TIMEOUT (HTTP 504) / «إلغاء البيان بسبب انتهاء مهلة البيان» في aura db raw: تقليل العمل أو تقسيمه.
تخبرك الخطة لماذا الاستعلام بطيء. الإشارات الأربعة التي يجب البحث عنها:
Seq Scanعلى الجدول> 10 آلاف صف → فهرس مفقودrows (estimated) ≠ rows (actual)بواسطة ±10× → إحصائيات قديمة،analyze table_nameNested Loopعلى أكثر من 100 ألف سطر → يُفضل الانضمام إلى التجزئة، وربما يكون مفقودًا أينMaterializeأوSort Method: external merge→ ذاكرة الوصول العشوائي استنفدت،work_memللزيادة
explain (analyze, buffers, format json)
select * from orders
where customer_id = 'abc' and created_at > now() - interval '30 days';
متى وماذا وكيف#
- B-tree (افتراضي): المساواة، النطاق، الترتيب حسب. 80% من الحالات.
- GIN: البحث عن النص الكامل، JSONB، الجداول.
using gin (to_tsvector('french', body)). - GiST: أنواع النطاق، قيود الاستبعاد، البحث عن التشابه (
pg_trgm). - HNSW (pgvector): بحث المتجهات،> 100 ألف متجه.
- جزئي: الشروط العامة،
where deleted_at is nullللحذف الناعم. - التغطية:
include (...)لتجنب البحث على الطاولة.
يؤدي كل فهرس إلى إبطاء عملية الإدخال/التحديث/الحذف (~5-15% لكل فهرس). قم بإسقاط الفهارس غير المستخدمة - يسردها aura db inspect indexes (لم يتم مسحها ضوئيًا مطلقًا، وليست فريدة، وليست أساسية).
ما الذي يقتل Postgres في الإنتاج#
- استعلامات N+1 - قم بالربط أو استخدم
!innerفي SDK بدلاً من التكرار الحلقي - ترقيم الصفحات بواسطة OFFSET — بعد 1000، استخدم المستند إلى المؤشر (
where id > last_seen) - SELECT * على الجداول الكبيرة - اطلب الأعمدة الضرورية فقط
- المعاملات الطويلة — تمنع VACUUM وتتسبب في الانتفاخ. احتفظ بـ < ثانية واحدة
- سياسات RLS غير مفهرسة — إذا كانت سياستك تستخدم
tenant_id = auth.tenant()، فهرسtenant_id