深入解析Excel服务器的数据库模型:从三张表看透Flask-SQLAlchemy设计精髓
- 2026-09-18 12:50:17
深入解析Excel服务器的数据库模型:从三张表看透Flask-SQLAlchemy设计精髓看懂这三张表，你就理解了整个系统的数据骨架 上篇文章我们搭建了一个Excel服务器Web应用，跑通了网页端和手机端。但你可能有个疑问：数据到底是怎么存的？三张表之间是什么关系？ 今天就带大家深入拆解 models.py 这个文件，把数据库模型设计的思路和技巧讲透。 一、先看全景：三张表解决所有问题 整个Excel服务器的核心数据模型只有三张表，加起来不到50行代码： ```python from flask_sqlalchemy import SQLAlchemy from flask_login import UserMixin db = SQLAlchemy() class User(UserMixin, db.Model): __tablename__ = 'users' id = db.Column(db.Integer, primary_key=True) username = db.Column(db.String(80), unique=True, nullable=False) password = db.Column(db.String(200), nullable=False) class TableTemplate(db.Model): __tablename__ = 'table_templates' id = db.Column(db.Integer, primary_key=True) name = db.Column(db.String(100), nullable=False) fields = db.Column(db.Text, nullable=False) # JSON created_by = db.Column(db.Integer, db.ForeignKey('users.id')) class TableData(db.Model): __tablename__ = 'table_data' id = db.Column(db.Integer, primary_key=True) template_id = db.Column(db.Integer, db.ForeignKey('table_templates.id')) row_data = db.Column(db.Text, nullable=False) # JSON ``` 三张表的分工： · User：存用户信息，谁是谁 · TableTemplate：存模板定义，长什么样（有哪些字段） · TableData：存具体数据，填了什么内容 这就是一个典型的元数据+数据分离设计模式。 二、逐行拆解：每行代码在做什么 1. User模型 —— 用户管理 ```python class User(UserMixin, db.Model): __tablename__ = 'users' id = db.Column(db.Integer, primary_key=True) username = db.Column(db.String(80), unique=True, nullable=False) password = db.Column(db.String(200), nullable=False) ``` 关键设计点： · UserMixin 是Flask-Login提供的混入类，直接提供了 is_authenticated、is_active 等用户认证所需的方法。不需要自己实现，继承就有了。 · __tablename__ 显式指定表名。如果不写，Flask-SQLAlchemy会自动生成一个，但显式指定更清晰、更可控。 · unique=True 保证用户名不重复，nullable=False 保证必填。这两个约束在数据库层面就做了限制，比在应用层判断更可靠。 编程技巧：密码字段存的是哈希值（generate_password_hash 生成），不是明文。登录时用 check_password_hash 比对，这是安全底线。 2. TableTemplate模型 —— 模板定义 ```python class TableTemplate(db.Model): __tablename__ = 'table_templates' id = db.Column(db.Integer, primary_key=True) name = db.Column(db.String(100), nullable=False) fields = db.Column(db.Text, nullable=False) # JSON created_by = db.Column(db.Integer, db.ForeignKey('users.id')) ``` 关键设计点： · fields 字段存的是 JSON字符串，不是关系表。比如 [{"name":"姓名","type":"text"}, {"name":"年龄","type":"number"}]。为什么不用单独的关系表？因为字段结构是用户动态创建的，用JSON存最灵活，改字段不需要改数据库结构。 · db.ForeignKey('users.id') 建立了外键关联。created_by 指向 users.id，表示“这个模板是谁创建的”。后续查询时只返回当前用户的数据，实现数据隔离。 编程技巧：用JSON字段存储可变结构，是“用户自定义表单”类应用的经典做法。避免了动态创建表的复杂性，查询和写入都更简单。 3. TableData模型 —— 数据存储 ```python class TableData(db.Model): __tablename__ = 'table_data' id = db.Column(db.Integer, primary_key=True) template_id = db.Column(db.Integer, db.ForeignKey('table_templates.id')) row_data = db.Column(db.Text, nullable=False) # JSON ``` 关键设计点： · template_id 外键指向 table_templates.id，表示“这行数据属于哪个模板”。 · row_data 同样是 JSON字符串，存的是单行数据。比如 {"姓名":"张三","年龄":"30"}。 · 数据和模板分离：模板变了（比如加了新字段），旧数据不受影响。新数据按新模板存，旧数据按旧格式读。 编程技巧：JSON字段的读写非常方便——存的时候 json.dumps(dict)，读的时候 json.loads(str)。不需要为每个用户自定义的字段建表，一套代码搞定所有模板。 三、表间关系图解 ``` ┌─────────────┐ ┌──────────────────┐ ┌─────────────┐ │ User │ │ TableTemplate │ │ TableData │ ├─────────────┤ ├──────────────────┤ ├─────────────┤ │ id (PK) │◄────────│ created_by (FK) │ │ id (PK) │ │ username │ │ id (PK) │◄────────│ template_id │ │ password │ │ name │ │ row_data │ └─────────────┘ │ fields (JSON) │ └─────────────┘ └──────────────────┘ ``` · User → TableTemplate：一对多。一个用户可以创建多个模板。 · TableTemplate → TableData：一对多。一个模板可以有多行数据。 · User → TableData：通过模板间接关联，不直接建外键。 四、三个值得借鉴的设计技巧 技巧1：用JSON字段替代动态建表 如果每个模板都建一张物理表，系统会变得极其复杂——需要动态创建表、动态修改表结构、处理迁移问题。用JSON字段存储可变结构，把复杂性转移到应用层，数据库层面保持稳定。 适用场景：用户自定义表单、灵活字段配置、EAV（实体-属性-值）模式。 技巧2：元数据与数据分离 TableTemplate 存“长什么样”（元数据），TableData 存“填了什么”（数据）。好处是： · 改模板不影响已有数据 · 模板可以复用（多个模板共享同一套字段定义） · 查询模板列表不需要扫描大量数据行 技巧3：外键实现数据隔离 created_by 字段把模板和用户绑定，查询时加 filter_by(created_by=current_user.id) 就实现了多用户隔离。不需要复杂的权限表，一张表加一个外键就搞定了。 如果是更复杂的场景（比如模板共享、团队协作），可以再加一张 共享权限表，但初期设计保持简单。 五、进阶优化方向 当数据量变大时，可以考虑这些优化： 优化方向 说明 添加索引 在 created_by、template_id 上建索引，加速关联查询 使用 lazy='selectin' 关联查询时避免N+1问题 分页查询 数据量大时用 paginate() 代替 all() 字段类型细化 日期用 DateTime，金额用 Numeric，比全存文本更精确 这些优化在数据量达到万级时再考虑也不迟，初期保持简单即可。 六、写在最后 三张表，不到50行代码，支撑了一个完整的Excel服务器数据层。 核心思路就三个： 1. JSON存可变结构 —— 灵活应对用户自定义 2. 元数据与数据分离 —— 模板和数据解耦 3. 外键实现隔离 —— 多用户数据互不干扰 这套模式不仅适用于这个Excel服务器项目，也适用于任何需要“用户自定义表单”的场景——问卷系统、CMS、低代码平台，都可以参考这个设计。 福利时间 本文对应的完整项目源码（含全部功能代码）已打包，关注公众号后台回复 “Excel服务器” 即可获取，包含： · ✅ 完整Python后端代码（含本文解析的models.py） · ✅ 前端页面模板 · ✅ 一键启动脚本 · ✅ 适用局域网和微信小程序的双版本 👇 扫码关注，获取更多Python实战开发技巧。
本文来自网友投稿或网络内容，如有侵犯您的权益请联系我们删除，联系邮箱：wyl860211@qq.com 。
