Flask-SQLAlchemy相关与Flask-Migrate相关

from flask_sqlalchemy import SQLAlchemy
from flask import Flask
app = Flask(__name__)
 
app.config["SQLALCHEMY_DATABASE_URI"] = 'mysql://username:password@hostname/database'
 
# 自动追踪，同步修改模型和数据库中的改动，建议设为False，降低内存消耗
app.config[SQLALCHEMY_TRACK_MODIFICATIONS] = False
 
# db是SQLAlchemy类的实例，表示应用使用的数据库
db = SQLAlchemy(app)

class Role(db.Model):
    __tablename__ = "tbl_role"
    id = db.Column(db.Integer, primary_key=True)
    name = db.Column(db.String(32), unique=True)
    users = db.relationship("User", backref="role")  # 不是数据库中真实存在，建立两个表的关系，可通过role访问user，backref用于另一个表反推这个表
    
    def __repr__(self):
    """定义后，可以让显示对象时更直观，自定义显示信息"""
        return "Role object: name=%s" % self.name
 
class User(db.Model):
    """用户表"""
    __tablename__ = "tbl_users"  # 指明数据库表名
    id = db.Column(db.Integer, primary_key=True)  # 指明表的主键，整型的主键会默认设置为自增主键
    name = db.Column(db.String(64), unique=True)  # 指明真实在数据库创建的字段类型，限制长度，不可重复出现
    password = db.Column(db.String(128))
    role_id = db.Column(db.Integer, db.ForeignKey("tbl_role.id"))  # 指明外键，用于反推

class Role(db.Model):
    ...
    users = db.relationship("User", backref="role")
 
class User(db.Model):
    ...
     role_id = db.Column(db.Integer, db.ForeignKey("tbl_role.id"))

db.create_all()函数将寻找所有db.Model的子类，然后在数据库中创建对应的表。如果数据库中表已经存在，那么db.create_all()不会重新创建或更新相应的表。如果修改模型后要把改动应用到现有的数据库，更新现有数据库表的蛮力方式是先删除旧表再重新创建（不可取）。
db.drop_all()  # 清除数据库中所有数据
 
db.create_all()  # 创建所有之前定义的模型类的表

role1 = Role(name="admin")  # 创建Role对象，id是自增的不需要定义
us1 = User(name="wang", password="123", role_id=role1.id)
us2 = User(name="zhou", password="456", role=role1)
    模型的构造函数就受的参数是使用关键字参数指定的模型属性初始值。注User中role属性也可以使用，虽然它不是真正的数据库列，但却是一对多关系的高级表示。无需设定id属性，在多数数据库中主键由数据库自身管理。现在这些对象只存在于python中，还未写入数据库，所以id还未赋值。
    对数据库的改动通过数据库会话管理，也称为事务。在Flask-SQLAlchemy中，会话由db.session表示。准备把对象写入数据库之前，要先将其添加到会话。
# 每次只添加一个
db.session.add(role1)
db.session.add(us1)
db.session.add(us2)
# 每次添加多个
db.session.add_all([role1, us1, us2])
    添加会话后，再调用db.session.commit()方法提交会话。
db.session.commit()
    数据库会话能保证数据库的一致性。提交操作使用原子方式把会话中的对象全部写入数据库。如果在写入会话的过程中发生了错误，那么整个会话都会失效。如果你始终把相关改动放在会话中提交，就能避免因部分更新导致的数据库不一致。
    数据库会话也可以回滚，调用db.session.rollback()后，添加到数据库会话中的所有对象都将还原到它们在数据库在中的状态（提交新数据前）。
db.session.rollback()

us2.name = "zhao"
db.session.add(us2)
db.session.commit()

db.session.delete(us2)
db.session.commit()

Role.query.all()
User.query.all()

# 通过模型类的query对象
Role.query.all()  # 查询多条对象，返回列表
ROle.query.first()  # 查询第一个对象
Role.query.get("主键id值")  # 查询对应主键值的对象
# 通过数据库会话的query对象
db.session.query(Role).all()  # 查询多个实例对象，查询执行方法与上述方式相同
from flask_sqlalchemy import _or
 
User.query.filter_by(name="wang").first().name  # 获取通过过滤器后的查询对象的第一个值的name属性
User.query.filter(User.name=="wang", User.role_id==1).first()  # 过滤器中逗号表并列关系
User.query.filter(or_(User.name=="wang", User.role_id==1)).first()  # or_函数表或关系
User.query.filter(User.role_id.in_([1,2,3]))  # in_函数表包含关系
User.query.filter(~User.role_id.in_([1,2,3]))  # ~表反
User.query.filter(User.role_id.is_(1))  # is_函数表判断关系
User.query.filter(User.role_id.isnot())  # isnot函数表不为空关系
 
User.query.offset(2).limit(2).all()  # offset跳过两条，从第三条开始,limit取两条
 
User.query.order_by("-id").all()  # 按id排序
User.query.order_by(User.id.desc()).all()  # 按id降序的方式排序
User.query.order_by(User.id.asc()).all()  # 按id升序的方式排序，默认升序
#以查询内容进行分组,返回新的查询对象
db.session.query(User.role_id, func.count(User.role_id)).group_by(User.role_id).all()
Role.query.get(1).users  # 关联查询
User.query.get(1).role  # 通过backref对应的字符反向关联查询
 
users = role1.users  # 隐式的查询会调用all()方法
users[0].role

from flask_migrate import Migrate
# ...
app = Flask(__name__)
manager = Manager(app)  # 创建脚本管理对象
db = SQLAlchemy(app)
 
migrate = Migrate(app, db)
 
# 在flask-script中添加一个db命令，与上面创建的db数据库对象无关
manager.add_command('db', MigrateCommand)

flask db init  # 创建migrations文件夹，所有迁移文件都放在里面

flask db upgrade  # 上传更改，前进

flask db downgrade 版本库  # 删除更改,回退,若无版本号默认回退一步
 
flask xxx.py db history  # 查看历史记录