简单说,ORM 就像你和一个外国厨师之间的"翻译官"。
ORM 全称是 Object-Relational Mapping(对象关系映射)。
它会把你写的 Python 对象(类和实例),自动翻译成数据库能听懂的 SQL 语句,去操作数据表。
FastAPI 本身不内置 ORM,但它通常会搭配 SQLAlchemy、Tortoise-ORM 等 ORM 库一起用,来实现上面这种翻译工作。
通俗比喻:去餐厅点菜
想象你去一家西餐厅:
你(程序员):想说"来一份牛排",但你只会说 Python。
数据库(厨师):只懂 SQL(数据库语言),听不懂 Python。
ORM(服务员):接过你的 Python 需求,转身对厨房喊:"SELECT * FROM menu WHERE name='牛排'",再把做好的牛排端给你。
你不用关心厨房怎么运作,说"人话"就能拿结果------这就是 ORM 的精髓。
ORM 在 FastAPI 中的具体作用
- 用 Python 类代替 SQL 语句
没有 ORM,你要手写长长的字符串:
INSERT INTO users (name, email) VALUES ('小明', 'xiao@email.com');
有了 ORM,你只需操作 Python 对象:
new_user = User(name="小明", email="xiao@email.com") # 建一个用户对象
db.add(new_user) # 交给数据库,ORM 自动生成 SQL 插入
对程序员来说,这就是"用操作对象的思维来操作数据库",思维更连贯。
- 防止 SQL 注入攻击
如果你手动拼接 SQL,比如:
query = f"SELECT * FROM users WHERE id = {user_input}"
- 换数据库更容易
假如项目原本用 SQLite,后来要换成 PostgreSQL。用 ORM 的话,基本只改一个连接地址,代码一行不用动。因为 ORM 帮你屏蔽了不同数据库的方言差异。
- 和 FastAPI 的类型系统完美配合
FastAPI 强在 Pydantic 模型(用于请求/响应数据校验)。而 ORM 负责定义数据库表模型。这两者可以清晰分工:
Pydantic 模型 → 定义接口长什么样(给前端看)
ORM 模型 → 定义数据库表长什么样(存数据)
两者结构类似,真正实现了"数据验证"和"数据存储"的解耦。这是 FastAPI 开发中最经典的模式。
总结一句话
ORM 让你能用写 Python 类的方式操作数据库,把又臭又长的 SQL 代码变成优雅的对象操作,更安全、好维护,且天生适合 FastAPI 的现代开发风格。