VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
处处都重要的设置
无论使用哪个框架,三件事必须成立:- 连接使用
utf8mb4,否则 emoji 会在传输中损坏。请参阅 utf8mb4 与 emoji。 - 严格 SQL 模式已开启(这是 MySQL 8.x 的默认设置),这样错误数据会报错,而不是被静默截断。
- 连接池大小是有意设定的。 每个框架都会为每个进程打开一个连接池;在选定数字之前,先乘以您的进程数。请参阅连接池。
Django
- 使用
mysqlclient,这是 Django 文档推荐的、持续维护的 C 驱动。 - Django 在 Python 中模拟了一些约束;也要添加真正的数据库约束(
unique=True会成为真正的唯一索引,但 check 约束需要在Meta中使用CheckConstraint)。 select_related()(JOIN)和prefetch_related()(第二个查询)是解决 N+1 的工具;何时使用见下文。
Rails
database.yml中的encoding: utf8mb4同时设置连接字符集和rails db:create的默认值。- ActiveRecord 验证(
validates_uniqueness_of)在并发下存在竞争;为每个唯一性验证配上真正的唯一索引,并让 1062 重复键错误成为最后一道防线。 includes是解决 N+1 的工具;strict_loading模式会把延迟加载变成错误,这样 N+1 会在开发阶段失败,而不是发布到线上。- Rails 8.1 在
database.yml中生成max_connections,而旧版本生成的是pool。pool:键仍然可以静默地工作,作为max_connections读取的回退值;把两者设成不同的值会在启动时抛出异常。请参阅 Rails 8 搭配 MySQL 了解完整的应用,包括 Rails 8 不再默认使用 MySQL 之后所需要的--database=mysql标志。
Prisma
- Prisma 默认使用 utf8mb4;需要注意的设置是 URL 中的
connection_limit,它的默认值偏低。 prisma migrate根据模式漂移生成 DDL。在应用到生产环境之前,请阅读生成的 SQL,就像您对待手写的迁移一样。请参阅模式迁移。- 关系查询使用
include;当您遍历结果并逐个访问关系时,就会出现 N+1 的形态。 - Prisma 7 把上面的连接 URL 从
schema.prisma移到了一个单独的配置文件中,并且需要驱动适配器才能连接。请参阅 Next.js 和 Prisma 搭配 MySQL 了解完整的 Prisma 7 应用。
N+1 问题,一次讲清
通用的 ORM 性能缺陷:加载 100 个订单,然后延迟加载每个订单的客户,ORM 就会发出 101 个查询。修复方法在每个框架中都是同一个思路——预先声明您需要的关系,让 ORM 用一到两个查询把它们取出来(select_related / includes / include)。检测工具也是通用的:在开发环境中打开查询日志,阅读 ORM 实际发送的内容,或者在生产环境中观察慢查询日志。
何时退回到 SQL
ORM 在 CRUD 上物有所值,在分析查询上则不然。窗口函数、CTE、批量 upsert 和多表报表查询,用 SQL 写比用一串试图表达它们的查询构建器链更清晰。每个 ORM 都有逃生通道(Django 的raw()、Rails 的 find_by_sql、Prisma 的 $queryRaw);为那 5% 值得这样做的查询使用它是好的工程实践,而不是认输。这也是 VillageSQL 扩展函数进入 ORM 应用程序的方式:SELECT UUID_V7() 或 ai_prompt(...) 可以通过任何一个这样的逃生通道工作,因为 ORM 只是把 SQL 原样传递过去。
另请参阅
- Next.js 和 Prisma 搭配 MySQL — 基于 Prisma 7 的完整应用,不只是配置
- Next.js 和 Drizzle 搭配 MySQL — 基于 Drizzle 的完整应用,一个上面未涉及的、更轻量、SQL 优先的替代方案
- Next.js 搭配 MySQL — 完全不用 ORM 的连接设置和查询模式
- Rails 8 搭配 MySQL — 完整的应用,包括 Rails 8 选择 MySQL 所需要的脚手架标志
- Laravel 12 搭配 MySQL — 基于 Laravel 的 Eloquent ORM 的完整应用,上面未涉及
- Go 和 sqlc 搭配 MySQL — 生成的类型安全查询,而不是运行时 ORM
- 连接池 — 跨进程调整连接池大小
- utf8mb4 与 emoji — 上面每个配置都设置的字符集
- 慢查询日志 — 捕获 ORM 生成的内容
- 模式迁移 — 安全地应用 ORM 生成的 DDL