supabase-postgres-best-practices

Vue d'ensemble

Qu'est-ce que supabase-postgres-best-practices ?

Supabase Postgres Best Practices est une compétence sélectionnée conçue pour aider les développeurs et les ingénieurs en bases de données à optimiser les performances de Postgres. Maintenue par Supabase, cette compétence fournit des règles concrètes et des exemples pour écrire des requêtes SQL efficaces, concevoir des schémas robustes, gérer les connexions et appliquer les meilleures pratiques de sécurité. Elle couvre huit catégories essentielles, notamment la performance des requêtes, la gestion des connexions, la sécurité (y compris la sécurité au niveau des lignes), la conception des schémas, la concurrence, les modèles d'accès aux données, la surveillance et les fonctionnalités avancées de Postgres.

À qui s'adresse cette compétence ?

• Développeurs backend travaillant avec Postgres ou Supabase
• Ingénieurs bases de données souhaitant améliorer la fiabilité et la rapidité
• Équipes en charge de la revue ou du refactoring des requêtes SQL et des schémas de base de données
• Toute personne configurant Postgres pour des environnements à haute concurrence ou serverless

Problèmes résolus

• Identification et correction des anti-patterns courants de Postgres
• Fourniture de réécritures SQL concrètes et de métriques de performance
• Aide à prévenir les requêtes lentes, les goulets d'étranglement de connexion et les erreurs de configuration de sécurité
• Offre des conseils prioritaires pour des améliorations critiques et progressives

Comment utiliser

Étapes d'installation

1. Ajoutez la compétence à votre agent ou projet :

   npx skills add https://github.com/supabase/agent-skills --skill supabase-postgres-best-practices
   

2. Commencez par la documentation principale :
   • Ouvrez SKILL.md pour une vue d'ensemble de toutes les meilleures pratiques et catégories de règles.
   • Consultez AGENTS.md pour une liste compilée et navigable de toutes les références.
3. Explorez les sujets détaillés :
   • Parcourez le dossier references/ pour des guides approfondis sur des sujets comme la recherche en texte intégral, l'indexation JSONB, le pooling de connexions et l'optimisation des requêtes.
   • Utilisez le fichier references/_sections.md pour comprendre l'impact et la priorité de chaque catégorie de règles.
4. Adaptez à votre flux de travail :
   • Intégrez les règles et exemples SQL pertinents dans vos revues de code, migrations ou contrôles automatisés.
   • Référez-vous à README.md pour les instructions aux contributeurs et la validation si vous souhaitez étendre ou personnaliser la compétence.

Fichiers et dossiers clés

• SKILL.md : manifeste principal de la compétence et vue d'ensemble (à lire en premier)
• AGENTS.md : documentation compilée destinée aux agents
• references/ : guides individuels des meilleures pratiques (ex. query-missing-indexes.md, conn-pooling.md)
• README.md : instructions pour contributeurs et validation

Cas d'utilisation exemples

• Refactorisation de requêtes lentes en appliquant les règles de performance des requêtes
• Conception de nouvelles tables selon les meilleures pratiques de schéma
• Mise en place du pooling de connexions pour des applications serverless
• Application de la sécurité au niveau des lignes avec des modèles clairs et exploitables

FAQ

Quand devrais-je utiliser supabase-postgres-best-practices ?

Utilisez cette compétence chaque fois que vous écrivez, révisez ou optimisez des requêtes Postgres, concevez des schémas, configurez des connexions ou appliquez des politiques de sécurité. Elle est particulièrement utile lors des revues de code, des migrations de base de données et du dépannage des performances.

Qu'est-ce qui différencie cette compétence des guides Postgres généraux ?

Cette compétence est sélectionnée par Supabase et privilégie des règles concrètes et exploitables avec des exemples SQL avant/après, un impact de performance quantifié et une structure adaptée aux agents. Elle est conçue pour un usage pratique dans des projets Postgres et Supabase réels.

Comment trouver les meilleures pratiques les plus pertinentes pour mon cas d'usage ?

Commencez par SKILL.md pour voir toutes les catégories et priorités. Pour des sujets spécifiques, parcourez le dossier references/ ou consultez AGENTS.md pour une liste navigable. Chaque référence comprend des titres clairs et des tags pour faciliter la découverte.

Puis-je contribuer ou personnaliser la compétence ?

Oui. Suivez les directives dans references/_contributing.md et README.md pour ajouter de nouvelles meilleures pratiques ou adapter celles existantes à votre environnement. Des scripts de validation et de build sont inclus pour le contrôle qualité.

Où puis-je voir des exemples SQL concrets ?

Chaque référence dans le dossier references/ inclut des modèles SQL incorrects et corrects, avec des explications et des liens vers la documentation officielle lorsque c'est pertinent.

Pour un arbre complet des fichiers et toutes les références disponibles, ouvrez l'onglet Fichiers dans votre agent ou navigateur de dépôt.