artubss Supabase Postgres Best Practices
Guia abrangente de otimização de performance para Postgres, mantido pela Supabase. Contém regras em 8 categorias, priorizadas por impacto para orientar otimização de queries e design de schema automatizados.
Quando Aplicar
Consulte essas diretrizes quando:
- Escrever queries SQL ou projetar schemas
- Implementar índices ou otimização de queries
- Revisar problemas de performance do banco de dados
- Configurar connection pooling ou scaling
- Otimizar para recursos específicos do Postgres
- Trabalhar com Row-Level Security (RLS)
Categorias de Regras por Prioridade
| Prioridade | Categoria | Impacto | Prefixo |
|---|---|---|---|
| 1 | Query Performance | CRÍTICO | query- |
| 2 | Connection Management | CRÍTICO | conn- |
| 3 | Security & RLS | CRÍTICO | security- |
| 4 | Schema Design | ALTO | schema- |
| 5 | Concurrency & Locking | MÉDIO-ALTO | lock- |
| 6 | Data Access Patterns | MÉDIO | data- |
| 7 | Monitoring & Diagnostics | BAIXO-MÉDIO | monitor- |
| 8 | Advanced Features | BAIXO | advanced- |
Como Usar
Leia arquivos de regras individuais para explicações detalhadas e exemplos SQL:
rules/query-missing-indexes.md
rules/schema-partial-indexes.md
rules/_sections.md
Cada arquivo de regra contém:
- Explicação breve do por que é importante
- Exemplo de SQL incorreto com explicação
- Exemplo de SQL correto com explicação
- Output de EXPLAIN opcional ou métricas
- Contexto adicional e referências
- Notas específicas da Supabase (quando aplicável)
Documento Compilado Completo
Para o guia completo com todas as regras expandidas: AGENTS.md