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()
