Melhores Práticas do Supabase Postgres

Quando Usar

Use esta habilidade quando precisar de otimização de performance do Postgres e melhores práticas do Supabase. Use esta habilidade ao escrever, revisar ou otimizar consultas Postgres, designs de schema ou configurações de banco de dados.

Guia abrangente de otimização de performance para Postgres, mantido pelo Supabase. Contém regras em 8 categorias, priorizadas por impacto para guiar a otimização automatizada de consultas e o design de schema.

Quando Aplicar

Consulte estas diretrizes quando:

• Escrever consultas SQL ou projetar schemas
• Implementar índices ou otimização de consultas
• Revisar problemas de performance do banco de dados
• Configurar pooling de conexões ou escalabilidade
• Otimizar para recursos específicos do Postgres
• Trabalhar com Segurança em Nível de Linha (RLS)

Categorias de Regras por Prioridade

Como Usar

Leia arquivos de regras individuais para explicações detalhadas e exemplos de 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 de SQL incorreto com explicação
• Exemplo de SQL correto com explicação
• Saída opcional de EXPLAIN ou métricas
• Contexto adicional e referências
• Notas específicas do Supabase (quando aplicável)

Referências

• https://www.postgresql.org/docs/current/
• https://supabase.com/docs
• https://wiki.postgresql.org/wiki/Performance_Optimization
• https://supabase.com/docs/guides/database/overview
• https://supabase.com/docs/guides/auth/row-level-security

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo do seu produto ou API upstream.
• Verifique comandos, comportamento da API, preços, cotas, credenciais e efeitos de implantação contra a documentação oficial atual antes de fazer alterações.
• Não trate exemplos gerados como substitutos para testes específicos do ambiente, revisão de segurança ou aprovação do usuário para ações destrutivas ou custosas.