Flask-SQLAlchemy使用
Flask-SQLAlchemy 使用起来非常有趣，对于基本应用十分容易使用，并且对于大型项目易于扩展。
官方文档：//flask-sqlalchemy.palletsprojects.com/en/2.x/
中文文档：//www.pythondoc.com/flask-sqlalchemy/
安装
pip install flask-sqlalchemy
配置
| 配置选项 | 说明 |
|---|---|
SQLALCHEMY_DATABASE_URI |
连接数据库。示例：mysql://username:password@host/post/db?charset=utf-8 |
SQLALCHEMY_BINDS |
一个将会绑定多种数据库的字典。 更多详细信息请看官文 绑定多种数据库. |
SQLALCHEMY_ECHO |
调试设置为true |
SQLALCHEMY_POOL_SIZE |
数据库池的大小，默认值为5。 |
SQLALCHEMY_POOL_TIMEOUT |
连接超时时间 |
SQLALCHEMY_POOL_RECYCLE |
自动回收连接的秒数。 |
SQLALCHEMY_MAX_OVERFLOW |
控制在连接池达到最大值后可以创建的连接数。当这些额外的连接回收到连接池后将会被断开和抛弃。 |
SQLALCHEMY_TRACK_MODIFICATIONS |
如果设置成 True (默认情况)，Flask-SQLAlchemy 将会追踪对象的修改并且发送信号。这需要额外的内存， 如果不必要的可以禁用它。 |
创建及查询
from flask import Flask
from flask_sqlalchemy import SQLAlchemy
app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:////tmp/test.db'
db = SQLAlchemy(app)
class User(db.Model):
id = db.Column(db.Integer, primary_key=True)
username = db.Column(db.String(80), unique=True)
email = db.Column(db.String(120), unique=True)
def __init__(self, username, email):
self.username = username
self.email = email
def __repr__(self):
return '<User %r>' % self.username
if __name__ == '__main__':
# 创建初始数据
db.create_all()
# 创建一些用户
admin = User('admin', '[email protected]')
guest = User('guest', '[email protected]')
# 写入到数据库
db.session.add(admin)
db.session.add(guest)
db.session.commit()
# 访问数据库
users = User.query.all()
admin = User.query.filter_by(username='admin').first()
print(users)
print(admin)
结果：
[<User 'admin'>, <User 'guest'>]
<User 'admin'>
表关联
SQLAlchemy 连接到关系型数据库，关系型数据最擅长的东西就是关联。因此，我们将创建一个使用两张相互关联的表的应用作为例子:
from flask import Flask
from flask_sqlalchemy import SQLAlchemy
from datetime import datetime
app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:////tmp/test.db'
db = SQLAlchemy(app)
class Post(db.Model):
id = db.Column(db.Integer, primary_key=True)
title = db.Column(db.String(80), nullable=False)
body = db.Column(db.Text, nullable=False)
pub_date = db.Column(db.DateTime, nullable=False,
default=datetime.utcnow)
category_id = db.Column(db.Integer, db.ForeignKey('category.id'), # 外键
nullable=False)
# 与生成表结构无关，仅用于查询方便
# backref 标示可通过relationship反向查找，Category.posts查询Post表数据
category = db.relationship('Category',
backref=db.backref('posts', lazy=True))
def __repr__(self):
return '<Post %r>' % self.title
class Category(db.Model):
id = db.Column(db.Integer, primary_key=True)
name = db.Column(db.String(50), nullable=False)
def __repr__(self):
return '<Category %r>' % self.name
if __name__ == '__main__':
# 创建一些对象
py = Category(name='Python')
Post(title='Hello Python!', body='Python is pretty cool', category=py)
p = Post(title='Snakes', body='Ssssssss')
py.posts.append(p)
db.session.add(py)
# 现在因为我们在 backref 中声明了 posts 作为动态关系，查询显示为:
print(py.posts)
运行结果：
[<Post 'Hello Python!'>, <Post 'Snakes'>]
更多数据库的增删改查等功能参考官方文档：//flask-sqlalchemy.palletsprojects.com/en/2.x/queries/
