VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
As Configurações Que Importam em Todo Lugar
Seja qual for o framework, três coisas precisam ser verdadeiras:- A conexão usa
utf8mb4, ou os emojis quebram no caminho. Consulte utf8mb4 e emoji. - O modo SQL estrito está ligado (é o padrão do MySQL 8.x), para que dados ruins gerem erro em vez de serem truncados silenciosamente.
- O tamanho do pool é deliberado. Todo framework abre um pool por processo; multiplique pela sua contagem de processos antes de escolher um número. Consulte Pool de conexões.
Django
- Use
mysqlclient, o driver em C mantido que a documentação do Django recomenda. - O Django emula algumas restrições em Python; adicione restrições reais no banco de dados também (
unique=Truevira um índice único real, mas restrições check precisam deCheckConstraintemMeta). select_related()(JOIN) eprefetch_related()(segunda consulta) são as ferramentas contra N+1; veja abaixo quando usar cada uma.
Rails
encoding: utf8mb4emdatabase.ymldefine tanto o charset da conexão quanto o padrão pararails db:create.- As validações do ActiveRecord (
validates_uniqueness_of) sofrem condições de corrida sob concorrência; sustente toda validação de unicidade com um índice único real, e deixe o erro 1062 de chave duplicada ser a última linha de defesa. includesé a ferramenta contra N+1; o modostrict_loadingtransforma o carregamento preguiçoso em erro, para que os N+1 falhem em desenvolvimento em vez de irem para produção.- O Rails 8.1 gera
max_connectionsemdatabase.ymlonde versões anteriores geravampool. Uma chavepool:ainda funciona, silenciosamente, como o valor de fallback quemax_connectionslê; definir as duas com valores diferentes lança erro na inicialização. Consulte Rails 8 com MySQL para uma aplicação completa, incluindo a flag--database=mysqlde que o Rails 8 precisa, já que ele não usa mais o MySQL por padrão.
Prisma
- O Prisma fala utf8mb4 por padrão; a configuração a observar é
connection_limitna URL, cujo padrão é baixo. prisma migrategera DDL a partir da diferença de schema. Leia o SQL gerado antes de aplicá-lo em produção, exatamente como faria com uma migração escrita à mão. Consulte Migrações de schema.- Consultas de relação usam
include; o formato N+1 aparece quando você itera sobre os resultados e acessa as relações uma a uma. - O Prisma 7 move a URL de conexão acima para fora de
schema.prisma, para um arquivo de configuração separado, e exige um driver adapter para conectar. Consulte Next.js e Prisma com MySQL para uma aplicação completa com Prisma 7.
O Problema N+1, de Uma Vez
O bug de desempenho universal dos ORMs: carregue 100 pedidos, depois carregue preguiçosamente o cliente de cada pedido, e o ORM emite 101 consultas. A correção é a mesma ideia em todos os frameworks — declare de antemão as relações de que você precisa para que o ORM as busque em uma ou duas consultas (select_related / includes / include). A ferramenta de detecção também é universal: ligue o log de consultas em desenvolvimento e leia o que o ORM realmente envia, ou observe o slow query log em produção.
Quando Descer para SQL
ORMs valem o que custam em CRUD e deixam de valer em analytics. Funções de janela, CTEs, upserts em massa e consultas de relatório com várias tabelas são mais claras em SQL do que em uma cadeia de query builder tentando expressá-las. Todo ORM tem uma válvula de escape (raw() no Django, find_by_sql no Rails, $queryRaw no Prisma); usá-la para os 5 por cento de consultas que a merecem é boa engenharia, não derrota. É também assim que as funções de extensão do VillageSQL chegam a uma aplicação com ORM: SELECT UUID_V7() ou ai_prompt(...) funcionam por qualquer uma dessas válvulas de escape, já que o ORM apenas repassa o SQL.
Veja também
- Next.js e Prisma com MySQL — uma aplicação completa com Prisma 7, não só a configuração
- Next.js e Drizzle com MySQL — uma aplicação completa com Drizzle, uma alternativa mais leve e orientada a SQL não coberta acima
- Next.js com MySQL — configuração de conexão e padrões de consulta sem nenhum ORM
- Rails 8 com MySQL — uma aplicação completa, incluindo a flag de scaffold de que o Rails 8 precisa para sequer escolher o MySQL
- Laravel 12 com MySQL — uma aplicação completa com o ORM Eloquent do Laravel, não coberto acima
- Go e sqlc com MySQL — consultas geradas e com tipagem segura em vez de um ORM em tempo de execução
- Pool de conexões — dimensionando pools entre processos
- utf8mb4 e emoji — a configuração de charset que toda configuração acima define
- Slow query log — capturando o que o ORM gera
- Migrações de schema — aplicando DDL gerado pelo ORM com segurança