深度解析SQLAlchemy模型类开发：基于declarative_base ()的定义规范与CRUD实践

原创

于 2025-09-17 09:20:12 发布 · 1.1k 阅读

20 ·

CC 4.0 BY-SA版权

文章标签：

#oracle #microsoft #数据库 #python #flask #pip

文章目录

一、核心概念
二、定义模型类的步骤
三、核心参数说明
四、使用模型类（与数据库交互）
五、注意事项
总结

在 SQLAlchemy 中，declarative_base() 是构建 ORM（对象关系映射）模型的核心工具，它创建了一个基类（通常命名为 Base），所有自定义的模型类都继承自这个基类，从而实现与数据库表的映射。以下是详细的定义方法、核心概念及使用示例：

一、核心概念

1.declarative_base()：SQLAlchemy 提供的一个工厂函数，返回一个基类（Base）。通过继承该基类，模型类可以被 SQLAlchemy 识别并关联到数据库表。
2.** 模型类：继承自 Base 的自定义类，每个类对应数据库中的一张表。
3. 表映射：模型类通过类属性（如 __tablename__、Column 等）定义数据库表的结构（表名、列名、数据类型、约束等）。
4. 会话（Session）**：用于与数据库交互的对象，通过它执行 CRUD（增删改查）操作。

二、定义模型类的步骤

1. 导入必要的模块

from sqlalchemy import create_engine, Column, Integer, String, DateTime, ForeignKey, Boolean
from sqlalchemy.ext.declarative import declarative_base
from sqlalchemy.orm import sessionmaker, relationship
from datetime import datetime

2. 创建基类 `Base`

# 生成基类，所有模型类都继承自它
Base = declarative_base()

3. 定义模型类（映射到数据库表）

以常见的 User（用户）和 Article（文章）表为例，演示单表定义和表关系（一对多）。

示例1：基础模型类（`User` 表）

class User(Base):
    # 1. 定义表名（必须指定，对应数据库中的表名）
    __tablename__ = "user"  # 表名通常用小写，多个单词用下划线分隔

    # 2. 定义列（字段），使用 Column 类
    id = Column(
        Integer,  # 数据类型：整数
        primary_key=True,  # 主键
        autoincrement=True,  # 自增
        comment="用户ID"  # 字段注释（可选）
    )
    username = Column(
        String(50),  # 字符串类型，长度50
        nullable=False,  # 非空约束
        unique=True,