Práticas Recomendadas para Postgres da Supabase
Guia abrangente de otimização de performance para Postgres, mantido pela Supabase. Contém regras em 8 categorias, priorizadas por impacto para orientar a otimização automatizada de consultas e o design de esquemas.
Quando Aplicar
Consulte estas diretrizes quando:
- Escrevendo consultas SQL ou projetando esquemas
- Implementando índices ou otimização de consultas
- Revisando problemas de performance do banco de dados
- Configurando pool de conexões ou escalabilidade
- Otimizando para recursos específicos do Postgres
- Trabalhando com Segurança em Nível de Linha (RLS)
Categorias de Regras por Prioridade
| Prioridade | Categoria | Impacto | Prefixo |
|---|---|---|---|
| 1 | Performance de Consultas | CRÍTICO | query- |
| 2 | Gerenciamento de Conexões | CRÍTICO | conn- |
| 3 | Segurança e RLS | CRÍTICO | security- |
| 4 | Design de Esquemas | ALTO | schema- |
| 5 | Concorrência e Bloqueios | MÉDIO-ALTO | lock- |
| 6 | Padrões de Acesso a Dados | MÉDIO | data- |
| 7 | Monitoramento e Diagnóstico | BAIXO-MÉDIO | monitor- |
| 8 | Recursos Avançados | BAIXO | advanced- |
Como Usar
Leia os arquivos de regras individuais para explicações detalhadas e exemplos SQL:
references/query-missing-indexes.md
references/query-partial-indexes.md
references/_sections.md
Cada arquivo de regra contém:
- Breve explicação de por que é importante
- Exemplo SQL incorreto com explicação
- Exemplo SQL correto com explicação
- Saída EXPLAIN ou métricas opcionais
- Contexto adicional e referências
- Notas específicas da Supabase (quando aplicável)