1.数据库的连接、创建会话与模型

半生小憩

SQLAlchemy 是一个强大的 Python 库，它让你可以用一种面向对象的方式来操作数据库（ORM 技术）。
在学习 SQLAlchemy 的过程中，需要一些基础知识的沉淀：Python基础、Python面向对象、MySQL数据库的诸多知识点……
在此之前，你可能需要了解传统执行SQL语句和使用ORM的一些区别以及他们的概念。

什么是传统执行 SQL？

传统执行 SQL 是指直接使用 SQL 语句与数据库进行交互。这通常包括连接数据库、编写 SQL 查询、执行查询以及处理结果。
特点

• 直接编写 SQL 语句：你需要手动编写 SQL 查询来操作数据库。
  
• 灵活性高：可以使用所有的 SQL 功能，精确控制查询和操作。
  
• 低级别控制：你需要管理数据库连接、事务处理等。
  

示例

1. import pymysql
3. # 连接数据库
4. connection = pymysql.connect(
5.     host='localhost',
6.     user='root',
7.     password='0908',
8.     database='db_flask_demo_school',
9.     charset='utf8mb4'
10. )
12. try:
13.     with connection.cursor() as cursor:
14.         # 执行 SQL 查询
15.         sql = "SELECT * FROM tb_student"
16.         cursor.execute(sql)
17.         result = cursor.fetchall()
18.         for row in result:
19.             print(row)
20. finally:
21.     connection.close()

复制代码

什么是 ORM（对象关系映射）？

ORM 是一种通过面向对象的方式来操作数据库的技术。ORM 将数据库表映射为类，将表中的记录映射为类的实例，使得你可以用面向对象的方式来进行数据库操作。
特点

• 面向对象：使用类和对象来表示数据库表和记录。
  
• 自动生成 SQL：ORM 框架会根据你的操作自动生成相应的 SQL 语句。
  
• 简化代码：简化了数据库操作的代码，使得代码更易读、更易维护。
  

示例

1. from sqlalchemy import create_engine, Column, Integer, String, Boolean
2. from sqlalchemy.orm import declarative_base, sessionmaker
4. # 创建数据库引擎
5. engine = create_engine('mysql+pymysql://root:0908@localhost:3306/db_flask_demo_school?charset=utf8mb4')
6. Base = declarative_base()
8. # 定义模型
9. class Student(Base):
10.     __tablename__ = 'tb_student'
11.     id = Column(Integer, primary_key=True)
12.     name = Column(String(20))
13.     sex = Column(Boolean, default=True)
14.     age = Column(Integer)
16. # 创建会话
17. SessionLocal = sessionmaker(bind=engine)
18. session = SessionLocal()
20. # 查询数据
21. students = session.query(Student).all()
22. for student in students:
23.     print(student.name)

复制代码

比较

特性传统执行 SQLORM编写 SQL 语句手动编写自动生成操作方式直接操作数据库面向对象操作灵活性高，完全控制 SQL 语句中等，受限于 ORM 框架代码简洁性代码较冗长代码简洁易读学习曲线需要掌握 SQL 语法需要学习 ORM 框架的用法性能可能更高效，具体取决于 SQL 语句可能稍慢，但差异通常不明显维护性低，SQL 语句分散在代码中高，结构清晰，易于维护适用场景

• 传统执行 SQL：适用于需要精细控制 SQL 查询的场景，或者需要使用复杂的 SQL 特性的场景。
  
• ORM：适用于需要快速开发、代码可读性和维护性要求高的场景。ORM 可以大大简化常见的数据库操作。
  

接下来进入 SQLAlchemy 的快速学习

1. 创建数据库驱动引擎

首先，我们需要创建一个数据库驱动引擎。当你连接数据库时，需要提前创建这个数据库。

1. CREATE DATABASE db_flask_demo_school CHARSET=utf8mb4

复制代码

这个引擎就是你和数据库之间的桥梁。

1. from sqlalchemy import create_engine
3. engine = create_engine(
4.     # url = '驱动://账户:密码@地址:端口/数据库名?charset=编码'
5.     url='mysql+pymysql://root:0908@localhost:3306/db_flask_demo_school?charset=utf8mb4',
6.     echo=True,  # 在控制台输出SQL语句，方便调试
7.     pool_size=8,  # 连接池的数据库连接数量
8.     max_overflow=30,  # 连接池的数据库连接最大数量
9.     pool_recycle=60 * 30,  # 设置秒数限制数据库多久没连接自动断开
10. )

复制代码

2. 创建数据库会话

有了引擎之后，我们需要创建一个会话，这样才能和数据库进行交互。会话就像是你和数据库之间的对话窗口。

1. from sqlalchemy.orm import sessionmaker
3. SessionLocal = sessionmaker(bind=engine)  # 工厂函数，创建新的会话类
4. session = SessionLocal()  # 实例化。用于与数据库进行交互

复制代码

另一种创建会话的方式

1. from sqlalchemy.orm import Session
3. # 目前官方文档上的案例使用的这种
4. # 大多数机构教学或者旧的学习资料中可能是上述方式
5. session = Session(bind=engine)

复制代码

3. 定义模型基类

在 SQLAlchemy 中，模型是与数据库表对应的类。我们需要定义一个基类，所有的模型都将继承这个基类。

1. from sqlalchemy.orm import declarative_base
3. Model = declarative_base()

复制代码

另一种创建基类的方式

1. from sqlalchemy.orm import DeclarativeBase
3. class Model(DeclarativeBase):
4.     pass

复制代码

该方式也是来源于目前官方文档的示例。
4. 创建模型

现在我们基于上方的模型基类，创建一个学生模型，这个模型对应数据库中的 tb_student 表。
每个模型类对应的其实就是数据库中的表，其中表名、字段都对应了类属性的设置，而每个类的实例对象也就是一条记录。

1. import db
2. import datetime
4. class Student(db.Model):
5.     __tablename__ = 'tb_student'  #  数据表的名字
6.     # db.Column 是一个字段对象，对应表字段，接受很多很多的参数（没啥好记的，浪费大脑为数不多的空间，参见末尾的表），常用字段属性是字段类型、是否为主键、备注描述、默认值指定等等
7.     # 整型 + 主键 + 告知这是学生编号（默认自增）
8.     id = db.Column(db.Integer, primary_key=True, comment='学生编号')
9.     # 20位字符串 + 告知这是学生姓名
10.     name = db.Column(db.String(20), comment='学生姓名')
11.     # 布尔型（实际上存储是0或1），默认是 True（存储是1）
12.     sex = db.Column(db.Boolean, default=True, comment='学生性别')
13.     # 精度更小的整型
14.     age = db.Column(db.SmallInteger, comment='学生年龄')
15.     # 'class' 这里不是类型，而是别名，因为 class = xxx，在python中是不行的（关键字）
16.     class_ = db.Column('class', db.SMALLINT, comment='学生班级')
17.     # 文本类型
18.     description = db.Column(db.Text, comment='个性签名')
19.     # 布尔型，默认值也可以写成 1
20.     status = db.Column(db.Boolean, default=1, comment='登录状态')
21.     # 日期时间类型，默认值需要特别注意，引用了 datetime 库，使用的是 now函数的地址，而不是它的调用结果。如果使用调用结果，将以项目执行启动的时间为准
22.     addtime = db.Column(db.DateTime, default=datetime.datetime.now, comment='入学时间')
23.     orders = db.Column(db.SMALLINT, default=1, comment='学生排序')
25.     def __repr__(self):
26.         # 便于打印列表时，显示 [ <Student: 老王(12)>,...]
27.         return f'<{self.__class__.__name__}: {self.name}({self.id})>'
29.     def to_dict(self):
30.         # 便于对象直接转成字符串，实现方式很多，比如 __dict__ 拷贝一份，然后筛选非'_'字符开头的键也行。
31.         return {
32.             'id': self.id,
33.             'name': self.name,
34.             'sex': self.sex,
35.             'age': self.age,
36.             'class': self.class_,
37.             'description': self.description,
38.             'status': self.status,
39.             'addtime': self.addtime.strftime('%Y-%m-%d %H:%M:%S'),  # 需要注意获取到的是 DateTime 对象，参见 datetime 库
40.             'orders': self.orders,
41.         }
43. if __name__ == '__main__':
44.     # 建表操作，如果如果你所在的公司或者团队或者你自身负责数据库的设计（DBA），那么建表无需执行 create_all
45.     # 当然，也有一些坑13，如果没有为你建表甚至没有设计，emmmm……，那就自己来吧！
46.     db.Model.metadata.create_all(db.engine)

复制代码

附表：常用 Column 字段

下面是一个详细的 SQLAlchemy Column 类型及其参数的表格，包括字段的用途、存储到数据库的类型、Python 中表示的数据类型等信息。
字段类型参数示例用途数据库类型Python 类型IntegerColumn(Integer, primary_key=True)存储整数INTEGERintStringColumn(String(50), nullable=False)存储字符串VARCHARstrTextColumn(Text)存储大文本数据TEXTstrBooleanColumn(Boolean, default=True)存储布尔值BOOLEANboolDateTimeColumn(DateTime, default=datetime.datetime.now)存储日期和时间DATETIMEdatetime.datetimeFloatColumn(Float)存储浮点数FLOATfloatSmallIntegerColumn(SmallInteger)存储小范围整数SMALLINTintLargeBinaryColumn(LargeBinary)存储二进制数据BLOBbytesNumericColumn(Numeric(10, 2))存储精确的小数NUMERICdecimal.DecimalDateColumn(Date)存储日期DATEdatetime.dateTimeColumn(Time)存储时间TIMEdatetime.timeEnumColumn(Enum('value1', 'value2'))存储枚举值ENUMenum.EnumIntervalColumn(Interval)存储时间间隔INTERVALdatetime.timedeltaJSONColumn(JSON)存储 JSON 数据JSONdictUUIDColumn(UUID(as_uuid=True))存储 UUIDUUIDuuid.UUIDARRAYColumn(ARRAY(String))存储数组ARRAYlistJSONBColumn(JSONB)存储 JSONB 数据（PostgreSQL）JSONBdictHSTOREColumn(HSTORE)存储键值对（PostgreSQL）HSTOREdictINETColumn(INET)存储 IP 地址（PostgreSQL）INETstrCIDRColumn(CIDR)存储 IP 地址范围（PostgreSQL）CIDRstrMACADDRColumn(MACADDR)存储 MAC 地址（PostgreSQL）MACADDRstr常用 Column 参数

• primary_key：是否为主键。
  
  
  
  • 类型：bool
    
  • 默认值：False
    
  • 示例：Column(Integer, primary_key=True)
    
  
  
• nullable：是否允许为空。
  
  
  
  • 类型：bool
    
  • 默认值：True
    
  • 示例：Column(String, nullable=False)
    
  
  
• default：默认值。
  
  
  
  • 类型：any
    
  • 默认值：None
    
  • 示例：Column(Boolean, default=True)
    
  
  
• unique：是否唯一。
  
  
  
  • 类型：bool
    
  • 默认值：False
    
  • 示例：Column(String, unique=True)
    
  
  
• index：是否创建索引。
  
  
  
  • 类型：bool
    
  • 默认值：False
    
  • 示例：Column(String, index=True)
    
  
  
• comment：字段注释。
  
  
  
  • 类型：str
    
  • 默认值：None
    
  • 示例：Column(String, comment='用户名')
    
  
  
• autoincrement：是否自动递增（通常用于主键）。
  
  
  
  • 类型：bool 或 str（好像是auto表示自增吧，忘记了，可查文档）
    
  • 默认值：True（在主键列上）
    
  • 示例：Column(Integer, primary_key=True, autoincrement=True)
    
  
  
• server_default：数据库服务器端的默认值。
  
  
  
  • 类型：DefaultClause 或 str
    
  • 默认值：None
    
  • 示例：Column(String, server_default='default_value')
    
  
  
• server_onupdate：数据库服务器端的更新值。
  
  
  
  • 类型：DefaultClause 或 str
    
  • 默认值：None
    
  • 示例：Column(DateTime, server_onupdate=func.now())
    
  
  
• onupdate：更新时的默认值。
  
  
  
  • 类型：any
    
  • 默认值：None
    
  • 示例：Column(DateTime, onupdate=datetime.datetime.now)
    
  
  
• foreign_key：外键约束。
  
  
  
  • 类型：ForeignKey
    
  • 默认值：None
    
  • 示例：Column(Integer, ForeignKey('other_table.id'))
    
  
  

来源:https://www.cnblogs.com/gupingan/p/18282769
免责声明：由于采集信息均来自互联网，如果侵犯了您的权益，请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容，谢谢合作！