13-03 扩展部分更新

题目

增加阅读备注，区分未提交、清空文本与 null，先列输入和预期状态，再补模型、映射、迁移和测试。

推导与做法

先定义三种操作：未提交 notes 保持原值，提交空字符串保存空文本，提交 null 保存 NULL。NotesPatch 用 model_dump(exclude_unset=True) 区分“没有字段”和“字段值为空”。

题解同时扩展 SQLAlchemy 字段、Pydantic 输入和受身份保护的路由。新库由 metadata 建表；已有库先备份，再执行 ALTER TABLE books ADD COLUMN notes TEXT，并记录迁移版本。改完后新开 Session 读取，确认提交结果与响应一致。

过程图

%% 每个节点保留输入、执行位置或执行后的实际状态。 flowchart TD S0["数据库备注为原备注"] S1["PATCH不含notes：保持原备注"] S0 --> S1 S2["PATCH notes为空字符串：保存空文本"] S1 --> S2 S3["PATCH notes为null：保存NULL"] S2 --> S3 classDef default fill:#EEF0FB,stroke:#4657B5,color:#24324A linkStyle default stroke:#4657B5

实现与运行

查看带注释实现。本题与相关处理函数放在同一章节代码文件中；启动工具负责定位相邻项目和选择题号。

在配套目录的 FastAPI/api_project 中运行。先按项目 README 执行 uv sync --locked。

# 使用项目解释器运行本题，题号决定执行哪一组演示。
uv run python "../../学习索引/参考实现/代码/ch13.py" 13-03

程序按题号输出处理后的值、查询结果或状态。先和前面的手算比较，再修改一项输入重跑。

查看本题运行结果

# 与上面的手算状态和题目数值逐项比较。
{
  "set": {
    "id": 1,
    "notes": "原备注"
  },
  "missing": {
    "id": 1,
    "notes": "原备注"
  },
  "empty": {
    "id": 1,
    "notes": ""
  },
  "null": {
    "id": 1,
    "notes": null
  },
  "new_session": null
}

迁移实现。停服并备份后，用项目解释器执行 python migrate_notes.py 数据库文件，为已有库增加备注列。