Compétences postgres-best-practices

📦

postgres-best-practices

Name: postgres-best-practices
Author: sickn33

Sûr

Optimiser les requêtes et schémas PostgreSQL

Vous rencontrez des problèmes de lenteur avec vos requêtes de base de données et de mauvaises performances ? Cette compétence fournit des règles d'optimisation PostgreSQL éprouvées par Supabase avec des exemples SQL concrets et des améliorations de performances mesurables.

Prend en charge: Claude Codex Code(CC)

📊 71 Adéquat

Télécharger le ZIP du skill

Importer dans Claude

Allez dans Paramètres → Capacités → Skills → Importer un skill

Activez et commencez à utiliser

Tester

Utilisation de "postgres-best-practices". Cette requête prend 5 secondes sur 100k lignes : SELECT * FROM orders WHERE customer_id = 42 AND status = 'pending'

Résultat attendu:

Créez un index composite : CREATE INDEX idx_orders_customer_status ON orders (customer_id, status). Cela change le plan d'exécution d'un scan séquentiel à un scan d'index, réduisant le temps de requête à moins de 10ms. L'ordre des colonnes est important : placez le filtre d'égalité (customer_id) avant le filtre status pour une utilisation optimale de l'index.

Utilisation de "postgres-best-practices". Comment empêcher les requêtes N+1 lors de la récupération des utilisateurs avec leurs données de profil ?

Résultat attendu:

Remplacez les requêtes individuelles par un JOIN : SELECT u.*, p.bio, p.avatar_url FROM users u LEFT JOIN user_profiles p ON p.user_id = u.id. Ajoutez un index sur user_profiles(user_id) pour des recherches rapides. Cela réduit 101 requêtes (1 pour les utilisateurs + 100 pour les profils) à une seule requête.

Audit de sécurité

Sûr

v1 • 2/24/2026

This skill contains educational documentation for PostgreSQL best practices from Supabase. All 711 static analysis findings are false positives: the 'external_commands' detections are SQL code blocks in markdown documentation (not shell commands), 'network' URLs are reference links to postgresql.org and supabase.com, 'scripts' findings are SQL WITH clauses (CTEs), and 'crypto' warnings are text pattern matches in documentation. No executable code or security risks present.

Fichiers analysés

3,490

Lignes analysées

résultats

Total des audits

Aucun problème de sécurité trouvé

Audité par: claude

Score de qualité

Architecture

100

Maintenabilité

Contenu

Communauté

100

Sécurité

Conformité aux spécifications

Ce que vous pouvez construire

Développeur backend optimisant les requêtes lentes

Identifier les index manquants, corriger les motifs N+1 et appliquer des techniques d'optimisation de requêtes pour réduire les temps de réponse de plusieurs secondes à quelques millisecondes.

Architecte de base de données concevant de nouveaux schémas

Appliquer les meilleures pratiques pour les types de données, les contraintes, les clés étrangères et les stratégies d'indexation lors de la conception initiale du schéma.

Ingénieur DevOps ajustant les bases de données en production

Configurer les limites de connexions, les paramètres de vacuum et la surveillance pour maintenir la santé de la base de données sous charge.

Essayez ces prompts

Optimisation de requête de base

Examinez cette requête PostgreSQL pour détecter les problèmes de performance et suggérez des améliorations : [coller la requête]

Recommandation d'index

Analysez ce schéma de table et cette charge de requêtes. Quels index dois-je créer pour des performances optimales ? Schéma : [coller le schéma], Requêtes : [coller les requêtes]

Correction de requête N+1

Je récupère les utilisateurs et leurs commandes avec des requêtes séparées. Montrez-moi comment réécrire cela comme un seul JOIN efficace avec une indexation appropriée.

Politique Row-Level Security

Créez une politique Row-Level Security pour un SaaS multi-tenant où les utilisateurs ne peuvent accéder qu'aux données appartenant à leur organisation. Structure de table : [coller le schéma]

Bonnes pratiques

Toujours ajouter des index sur les colonnes WHERE, JOIN et ORDER BY
Utiliser EXPLAIN ANALYZE pour vérifier les plans d'exécution des requêtes avant le déploiement
Implémenter le pool de connexions pour prévenir l'épuisement de la base de données

Éviter

Exécuter des requêtes non indexées sur de grandes tables provoquant des scans séquentiels
Récupérer toutes les colonnes avec SELECT * au lieu de champs spécifiques
Utiliser LIKE avec des caractères génériques en début de chaîne, ce qui empêche l'utilisation des index

Foire aux questions

Comment savoir quelles colonnes doivent être indexées ?

Indexez les colonnes utilisées dans les clauses WHERE, les conditions JOIN, ORDER BY et les clés étrangères. Utilisez pg_stat_user_tables pour identifier les colonnes fréquemment accédées sans index.

Qu'est-ce que N+1 et comment le corriger ?

N+1 se produit lorsque vous récupérez un enregistrement parent puis effectuez N requêtes supplémentaires pour les enregistrements enfants. Corrigez en utilisant des JOINs ou en chargeant par lots avec des clauses IN pour récupérer tous les enfants en une seule requête.

Quand dois-je utiliser des index partiels ?

Utilisez des index partiels lorsque les requêtes filtrent fréquemment sur une condition spécifique (par exemple, WHERE status='active'). Cela crée des index plus petits et plus rapides couvrant uniquement les lignes pertinentes.

Comment fonctionne Row-Level Security ?

RLS applique des politiques d'accès au niveau de la base de données. Activez avec ALTER TABLE ... ENABLE ROW LEVEL SECURITY, puis créez des politiques qui filtrent les lignes basées sur les attributs utilisateur comme organization_id.

Quelle taille de pool de connexions dois-je utiliser ?

Commencez avec 10-20 connexions par instance d'application. Surveillez pg_stat_activity et ajustez en fonction de : (CPU cores * 2) + effective_spindle_count pour les charges de travail limitées par le CPU.

Pourquoi mes requêtes sont-elles lentes après avoir ajouté des index ?

Causes possibles : mauvais ordre des colonnes dans les index composites, utilisation de fonctions sur des colonnes indexées, statistiques obsolètes (exécutez ANALYZE), ou index sur des colonnes à faible cardinalité. Utilisez EXPLAIN ANALYZE pour diagnostiquer.