Bonnes pratiques Postgres de Supabase
Guide complet d'optimisation des performances pour Postgres, maintenu par Supabase. Contient des règles réparties dans 8 catégories, classées par impact pour guider l'optimisation automatisée des requêtes et la conception de schémas.
Quand appliquer
Référencez ces directives lorsque :
- Vous écrivez des requêtes SQL ou concevez des schémas
- Vous implémentez des index ou optimisez des requêtes
- Vous examinez des problèmes de performance de base de données
- Vous configurez le pooling de connexions ou le scaling
- Vous optimisez pour des fonctionnalités spécifiques à Postgres
- Vous travaillez avec la sécurité au niveau des lignes (RLS)
Catégories de règles par priorité
| Priorité | Catégorie | Impact | Préfixe |
|---|---|---|---|
| 1 | Performance des requêtes | CRITIQUE | query- |
| 2 | Gestion des connexions | CRITIQUE | conn- |
| 3 | Sécurité et RLS | CRITIQUE | security- |
| 4 | Conception de schéma | ÉLEVÉ | schema- |
| 5 | Concurrence et verrouillage | MOYEN-ÉLEVÉ | lock- |
| 6 | Modèles d'accès aux données | MOYEN | data- |
| 7 | Surveillance et diagnostic | FAIBLE-MOYEN | monitor- |
| 8 | Fonctionnalités avancées | FAIBLE | advanced- |
Comment utiliser
Lisez les fichiers de règles individuels pour des explications détaillées et des exemples SQL :
references/query-missing-indexes.md
references/query-partial-indexes.md
references/_sections.md
Chaque fichier de règle contient :
- Une brève explication de pourquoi c'est important
- Un exemple SQL incorrect avec explication
- Un exemple SQL correct avec explication
- Une sortie EXPLAIN ou des métriques optionnelles
- Contexte supplémentaire et références
- Notes spécifiques à Supabase (lorsque applicable)