postgres-patterns
مراجعة ترحيلات PostgreSQL وتحسين الاستعلامات
تولد Alembic ترحيلات بدون فهم تأثيرات أداء PostgreSQL. توفر هذه المهارة أنماطاً لمراجعة ترحيلات قاعدة البيانات وكتابة استعلامات فعالة تتجنب فخاخ الأداء الشائعة.
下載技能 ZIP
在 Claude 中上傳
前往 設定 → 功能 → 技能 → 上傳技能
開啟並開始使用
測試它
正在使用「postgres-patterns」。 راجع هذا الترحيل لمشكلات PostgreSQL: op.add_column('users', sa.Column('bio', sa.Text(), nullable=False))
預期結果:
- تحذير: هذا الترحيل سيُقفل الجدول على الجداول الكبيرة
- مشكلة: إضافة عمود NOT NULL بدون افتراضي يُعيد كتابة الجدول بالكامل
- نهج أفضل (عملية من 3 خطوات):
- 1. أضف العمود القابل للقيمة الخالية أولاً: ALTER TABLE users ADD COLUMN bio TEXT;
- 2. امسح البيانات على دفعات لتجنب الأقفال الطويلة
- 3. أضف القيد: ALTER TABLE users ALTER COLUMN bio SET NOT NULL;
- أيضاً: فكر في إضافة فهرس على bio إذا كنت ستستعلم عنه
正在使用「postgres-patterns」。 جدول المستخدمين لدينا يحتوي على 10 ملايين صف والاستعلامات بطيئة: SELECT * FROM users WHERE status = 'active' ORDER BY created_at DESC LIMIT 100;
預期結果:
- فكر في فهرس جزئي للمستخدمين النشطين فقط:
- CREATE INDEX ix_users_active_status_created ON users (status, created_at) WHERE status = 'active';
- سيكون هذا الفهرس أصغر بكثير من الفهرس الكامل على status
- تطابق جملة WHERE عامل تصفية استعلامك بالضبط
- فكر أيضاً في إضافة فهرس تغطية إذا حددت أعمدة معينة
安全審計
安全This is a pure documentation skill containing only PostgreSQL best practices. No executable code, network calls, file access, or external commands exist. The skill-report.json audit explicitly states risk_level: safe and safe_to_publish: true. All 81 static findings are false positives caused by the scanner misinterpreting SQL identifier backticks as shell execution and database terminology as malicious patterns.
風險因素
🌐 網路存取 (1)
⚙️ 外部命令 (41)
品質評分
你能建構什麼
مراجعة سلامة الترحيل
تحقق من الترحيلات الجديدة لأقفال الجداول والفهارس المفقودة ومشكلات القيود قبل النشر.
تحسين أداء الاستعلام
تحديد الاستعلامات البطيئة وتطبيق استراتيجيات الفهرسة المناسبة بما في ذلك الفهارس الجزئية وJSONB.
تصحيح أخطاء قاعدة البيانات
تشخيص مشاكل الاتصال وتعارض الأقفال ومشاكل حجم الجدول باستخدام استعلامات التشخيص.
試試這些提示
راجع هذا ترحيل Alembic لمشكلات PostgreSQL. تحقق من أقفال الجداول والفهارس المفقودة ومشكلات القيود: [الصق كود الترحيل]
هذا الاستعلام بطيء. صمم فهارس مناسبة بما في ذلك الفهارس الجزئية إذا كان الاستعلام يُرشح بقيم محددة: [الصق الاستعلام ومخطط الجدول]
استعلامات JSONB بطيئة. أظهر لنا كيفية إنشاء فهارس GIN وفهارس تعبيرية لهذا النمط: [وصف نمط استعلام JSONB]
تطبيقنا يعاني من أقفال. اعرض استعلامات تشخيصية لتحديد العمليات المحجوبة والمعاملات طويلة التشغيل: [وصف الأعراض]
最佳實務
- استخدم دائماً CREATE INDEX CONCURRENTLY على جداول الإنتاج لتجنب قفل الكتابات
- استخدم الفهارس الجزئية عندما تستعلم فقط عن مجموعة فرعية من الصفوف للحفاظ على حجم الفهارس صغيراً
- طبّق عملية الـ 3 خطوات عند إضافة أعمدة NOT NULL إلى الجداول الموجودة
避免
- استخدام CREATE INDEX بدون CONCURRENTLY على قواعد بيانات الإنتاج
- إضافة فهارس على أعمدة ذات تنوع منخفض وحدها (مثلعلامات Boolean)
- استخدام uuid4 كمفاتيح أولية دون النظر في فهارس BRIN أو تجزئة الفهرس