انتقل إلى المحتوى
شعار أوراباسي
aurabase

تدقيق الأداء ص99

حدد الاستعلامات البطيئة، وافهم شرح التحليل، واستراتيجيات الفهرسة، والأنماط الخمسة المضادة التي تقتل Postgres في الإنتاج.

دليل عملي14 د قراءةالمستوى متقدمتمت المراجعة في 15‏/04‏/2026

تمت ترجمة هذه الصفحة تلقائيًا. النسخة الإنجليزية موثوقة.

قياس قبل التحسين#

يبدأ التدقيق بالأرقام. يعرض الاستوديو p50/p95/p99 عن طريق نقطة النهاية وعن طريق الاستعلام. احصل على خط أساس لمدة 7 أيام قبل أي تغيير.

معلومات

استعلام أوامر aura db slow-queries وaura db stats CLI pg_stat_statements ومقاييس تجمع/حجم قاعدة البيانات في مشروعك المرتبط، على نطاق مشروعك (متوفر أيضًا في Studio › قاعدة البيانات والسجلات ). يسرد aura db inspect indexes|tables|locks استخدام الفهرس (مع وضع علامة على الفهرس غير المستخدم)، وأحجام الجدول والصفوف الميتة، وأقفال الحظر - التشخيصات التي لا يمكن لـ /raw تشغيلها لأنه يرفض كتالوجات النظام.

clibash
# أغلى 10 استفسارات (الوقت الإجمالي)
aura db slow-queries --limit 10

# الاتصالات وحجم قاعدة البيانات (زمن استجابة نقطة النهاية: الاستوديو ›السجلات)
aura db stats

pg_stat_statements في الوقت الحقيقي#

يتم تثبيت pg_stat_statements وتحميله مسبقًا في كل مشروع جديد. يقوم بتجميع كل استعلام تم تسويته (لا يتم تخزين أي قيم حرفية) مع mean_exec_time و calls و rows. لا يقرأه /raw مباشرة - العرض على مستوى المجموعة - لذا استخدم الأوامر أعلاه، والتي تُرجع استعلامات مشروعك فقط، أو Studio › Database.

top-10bash
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_name
  • Nested Loop على أكثر من 100 ألف سطر → يُفضل الانضمام إلى التجزئة، وربما يكون مفقودًا أين
  • Materialize أو Sort Method: external merge → ذاكرة الوصول العشوائي استنفدت، work_mem للزيادة
debugsql
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 في الإنتاج#

  1. استعلامات N+1 - قم بالربط أو استخدم !inner في SDK بدلاً من التكرار الحلقي
  2. ترقيم الصفحات بواسطة OFFSET — بعد 1000، استخدم المستند إلى المؤشر (where id > last_seen)
  3. SELECT * على الجداول الكبيرة - اطلب الأعمدة الضرورية فقط
  4. المعاملات الطويلة — تمنع VACUUM وتتسبب في الانتفاخ. احتفظ بـ < ثانية واحدة
  5. سياسات RLS غير مفهرسة — إذا كانت سياستك تستخدم tenant_id = auth.tenant()، فهرس tenant_id

للذهاب أبعد من ذلك#