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 服務(wù)所在的主機(jī)，可以是本地主機(jī)(localhost)， 也可以是遠(yuǎn)程服務(wù)器。數(shù)據(jù)庫服務(wù)器上可以托管多個數(shù)據(jù)庫，因此 database 表示要使用的 數(shù)據(jù)庫名。如果數(shù)據(jù)庫需要進(jìn)行認(rèn)證，username 和 password 表示數(shù)據(jù)庫用戶密令。
程序使用的數(shù)據(jù)庫 URL 必須保存到 Flask 配置對象的 SQLALCHEMY_DATABASE_URI 鍵中。
3、使用
from flask_sqlalchemy import SQLAlchemy
baseURL = "mysql://root:Mysql123?!@localhost/testDB"
app.config['SQLALCHEMY_DATABASE_URI'] = baseURL #配置數(shù)據(jù)庫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 定義在數(shù)據(jù)庫中使用的表名，如果沒有定義會有一個默認(rèn)值
最常用的SQLAlchemy列類型
最常使用的SQLAlchemy列選項
關(guān)聯(lián)兩張表，上面創(chuàng)建的兩張表users和roles的關(guān)系圖如下
角色到用戶的一對多關(guān)系，因為一個角色可屬于多個用戶，而每個用戶只能有一個角色。
(思路小結(jié)：’建兩個表，一’方不動，’多’方添加一個外鍵字段)*
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 所示，關(guān)系使用 users 表中的外鍵連接了兩行。添加到 User 模型中的 role_id 列 被定義為外鍵，就是這個外鍵建立起了關(guān)系。傳給 db.ForeignKey() 的參數(shù) 'roles.id' 表 明，這列的值是 roles 表中行的 id 值。
添加到 Role 模型中的 users 屬性代表這個關(guān)系的面向?qū)ο笠暯?。對于一個 Role 類的實(shí)例， 其 users 屬性將返回與角色相關(guān)聯(lián)的用戶組成的列表。db.relationship() 的第一個參數(shù)表 明這個關(guān)系的另一端是哪個模型。如果模型類尚未定義，可使用字符串形式指定。
db.relationship() 中的 backref 參數(shù)向 User 模型中添加一個 role 屬性，從而定義反向關(guān) 系。這一屬性可替代 role_id 訪問 Role 模型，此時獲取的是模型對象，而不是外鍵的值。
大多數(shù)情況下，db.relationship() 都能自行找到關(guān)系中的外鍵，但有時卻無法決定把 哪一列作為外鍵。例如，如果 User 模型中有兩個或以上的列定義為 Role 模型的外鍵， SQLAlchemy 就不知道該使用哪列。如果無法決定外鍵，你就要為 db.relationship() 提供 額外參數(shù)，從而確定所用外鍵
5、數(shù)據(jù)庫操作
創(chuàng)建表（學(xué)習(xí)如何使用
模型的最好方法是在 Python shell 中實(shí)際操作）
創(chuàng)建表
python3 hello.py shell
from hello import db
db.drop_all() // 先刪除再創(chuàng)建
db.create_all()
插入行
下面這段代碼創(chuàng)建了一些角色和用戶:
>>> 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)
模型的構(gòu)造函數(shù)接受的參數(shù)是使用關(guān)鍵字參數(shù)指定的模型屬性初始值。注意，role 屬性也 可使用，雖然它不是真正的數(shù)據(jù)庫列，但卻是一對多關(guān)系的高級表示。這些新建對象的 id 屬性并沒有明確設(shè)定，因為主鍵是由 Flask-SQLAlchemy 管理的?，F(xiàn)在這些對象只存在于 Python 中，還未寫入數(shù)據(jù)庫。因此 id 尚未賦值:
通過數(shù)據(jù)庫會話管理對數(shù)據(jù)庫所做的改動，在 Flask-SQLAlchemy 中，會話由 db.session 表示。準(zhǔn)備把對象寫入數(shù)據(jù)庫之前，先要將其添加到會話中:
>>> 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])
為了把對象寫入數(shù)據(jù)庫，我們要調(diào)用 commit() 方法提交會話:
>>> db.session.commit()
修改行
在數(shù)據(jù)庫會話上調(diào)用 add() 方法也能更新模型。我們繼續(xù)在之前的 shell 會話中進(jìn)行操作，
下面這個例子把 "Admin" 角色重命名為 "Administrator":
>>> admin_role.name = 'Administrator'
>>> db.session.add(admin_role)
>>> db.session.commit()
刪除行
數(shù)據(jù)庫會話還有個 delete() 方法。下面這個例子把 "Moderator" 角色從數(shù)據(jù)庫中刪除:
>>> db.session.delete(mod_role)
>>> db.session.commit()
注意，刪除與插入和更新一樣，提交數(shù)據(jù)庫會話后才會執(zhí)行
查詢行
Flask-SQLAlchemy 為每個模型類都提供了 query 對象。
Role.query.all()
