SQLAlchemy官方文档
Flask-SQLAlchemy快速入门中文文档
1、安装flask-sqlalchemy
pip3 install flask-sqlalchemy
2、安装 flask-mysqldb
pip3 install flask-mysqldb
MySQL的URL格式mysql://username:password@hostname/database
hostname 表示 MySQL 服务所在的主机，可以是本地主机(localhost)， 也可以是远程服务器。数据库服务器上可以托管多个数据库，因此 database 表示要使用的 数据库名。如果数据库需要进行认证，username 和 password 表示数据库用户密令。
程序使用的数据库 URL 必须保存到 Flask 配置对象的 SQLALCHEMY_DATABASE_URI 键中。
3、使用
from flask_sqlalchemy import SQLAlchemy
baseURL = "mysql://root:Mysql123?!@localhost/testDB"
app.config['SQLALCHEMY_DATABASE_URI'] = baseURL #配置数据库url
app.config['SQLALCHEMY_COMMIT_ON_TEARDOWN'] = True
db = SQLAlchemy(app)
4、定义模型User 和Role
class Role(db.Model):
__tablename__='roles'
id = db.Column(db.Integer,primary_key=True)
name = db.Column(db.String(64),unique=True)
def __repr__(self):
return '<Role %r>' % self.name
class User(db.Model):
__tablename__ = 'users'
id = db.Column(db.Integer,primary_key=True)
username = db.Column(db.String(64),unique=True,index=True)
def __repr__(self):
return '<User %r>' % self.username
类变量 tablename 定义在数据库中使用的表名，如果没有定义会有一个默认值
最常用的SQLAlchemy列类型
最常使用的SQLAlchemy列选项
关联两张表，上面创建的两张表users和roles的关系图如下
角色到用户的一对多关系，因为一个角色可属于多个用户，而每个用户只能有一个角色。
(思路小结：’建两个表，一’方不动，’多’方添加一个外键字段)*
class Role(db.Model):
# ...
users = db.relationship('User', backref='role')
class User(db.Model):
# ...
role_id = db.Column(db.Integer, db.ForeignKey('roles.id'))
如图 5-1 所示，关系使用 users 表中的外键连接了两行。添加到 User 模型中的 role_id 列 被定义为外键，就是这个外键建立起了关系。传给 db.ForeignKey() 的参数 'roles.id' 表 明，这列的值是 roles 表中行的 id 值。
添加到 Role 模型中的 users 属性代表这个关系的面向对象视角。对于一个 Role 类的实例， 其 users 属性将返回与角色相关联的用户组成的列表。db.relationship() 的第一个参数表 明这个关系的另一端是哪个模型。如果模型类尚未定义，可使用字符串形式指定。
db.relationship() 中的 backref 参数向 User 模型中添加一个 role 属性，从而定义反向关 系。这一属性可替代 role_id 访问 Role 模型，此时获取的是模型对象，而不是外键的值。
大多数情况下，db.relationship() 都能自行找到关系中的外键，但有时却无法决定把 哪一列作为外键。例如，如果 User 模型中有两个或以上的列定义为 Role 模型的外键， SQLAlchemy 就不知道该使用哪列。如果无法决定外键，你就要为 db.relationship() 提供 额外参数，从而确定所用外键
5、数据库操作
创建表（学习如何使用
模型的最好方法是在 Python shell 中实际操作）
创建表
python3 hello.py shell
from hello import db
db.drop_all() // 先删除再创建
db.create_all()
插入行
下面这段代码创建了一些角色和用户:
>>> from hello import Role, User
>>> admin_role = Role(name='Admin')
>>> mod_role = Role(name='Moderator')
>>> user_role = Role(name='User')
>>> user_john = User(username='john', role=admin_role)
>>> user_susan = User(username='susan', role=user_role)
>>> user_david = User(username='david', role=user_role)
模型的构造函数接受的参数是使用关键字参数指定的模型属性初始值。注意，role 属性也 可使用，虽然它不是真正的数据库列，但却是一对多关系的高级表示。这些新建对象的 id 属性并没有明确设定，因为主键是由 Flask-SQLAlchemy 管理的。现在这些对象只存在于 Python 中，还未写入数据库。因此 id 尚未赋值:
通过数据库会话管理对数据库所做的改动，在 Flask-SQLAlchemy 中，会话由 db.session 表示。准备把对象写入数据库之前，先要将其添加到会话中:
>>> db.session.add(admin_role)
>>> db.session.add(mod_role)
>>> db.session.add(user_role)
>>> db.session.add(user_john)
>>> db.session.add(user_susan)
>>> db.session.add(user_david)
或者简写成:
>>> db.session.add_all([admin_role, mod_role, user_role,
... user_john, user_susan, user_david])
为了把对象写入数据库，我们要调用 commit() 方法提交会话:
>>> db.session.commit()
修改行
在数据库会话上调用 add() 方法也能更新模型。我们继续在之前的 shell 会话中进行操作，
下面这个例子把 "Admin" 角色重命名为 "Administrator":
>>> admin_role.name = 'Administrator'
>>> db.session.add(admin_role)
>>> db.session.commit()
删除行
数据库会话还有个 delete() 方法。下面这个例子把 "Moderator" 角色从数据库中删除:
>>> db.session.delete(mod_role)
>>> db.session.commit()
注意，删除与插入和更新一样，提交数据库会话后才会执行
查询行
Flask-SQLAlchemy 为每个模型类都提供了 query 对象。
Role.query.all()
