Flask-SQLAlchemy安装及设置

sqlALchemy 实际上是对数据库的抽象，让开发者不用直接和 sql 语句打交道，而是通过 Python 对象来操作数据库，在舍弃一些性能开销的同时，换来的是开发效率的较大提升

sqlAlchemy是一个关系型数据库框架，它提供了高层的 ORM 和底层的原生数据库的操作。

flask-sqlalchemy 是一个简化了 sqlAlchemy 操作的flask扩展。

文档地址：http://docs.jinkan.org/docs/flask-sqlalchemy

 

安装

安装 flask-sqlalchemy
pip install flask-sqlalchemy
如果连接的是 MysqL 数据库，需要安装 MysqLdb
pip install flask-MysqLdb
数据库连接设置
在 Flask-sqlAlchemy 中，数据库使用URL指定，而且程序使用的数据库必须保存到Flask配置对象的 sqlALCHEMY_DATABASE_URI 键中
app.config['sqlALCHEMY_DATABASE_URI'] = 'MysqL://root:MysqL@127.0.0.1:3306/test'
其他设置：
# 动态追踪修改设置，如未设置只会提示警告
app.config['sqlALCHEMY_TRACK_MODIFICATIONS'] = True
#查询时会显示原始sql语句
app.config['sqlALCHEMY_ECHO'] = True
配置完成需要去 MysqL 中创建项目所使用的数据库
$ MysqL -uroot -pMysqL
$ create database test charset utf8;

@H_502_14@其它配制

名字                         　　  备注
sqlALCHEMY_DATABASE_URI    　　   用于连接的数据库 URI 。例如:sqlite:////tmp/test.dbMysqL://username:password@server/db
sqlALCHEMY_ECHO    　　　　　　　　 如果设置为Ture， sqlAlchemy 会记录所有 发给 stderr 的语句，这对调试有用。(打印sql语句)
sqlALCHEMY_RECORD_QUERIES        可以用于显式地禁用或启用查询记录。查询记录 在调试或测试模式自动启用。更多信息见get_debug_queries()。
sqlALCHEMY_POOL_SIZE             数据库连接池的大小。默认是引擎默认值（通常 是 5 ）
sqlALCHEMY_POOL_TIMEOUT          设定连接池的连接超时时间。默认是 10 。
sqlALCHEMY_COMMIT_ON_TEARDOWN    数据库内容发送改变之后,自动提交

常用的sqlAlchemy字段类型

常用的sqlAlchemy列选项

常用的sqlAlchemy关系选项

数据库基本操作

在Flask-sqlAlchemy中，插入、修改、删除操作，均由数据库会话管理。

会话用 db.session 表示。在准备把数据写入数据库前，要先将数据添加到会话中然后调用 commit() 方法提交会话。

在 Flask-sqlAlchemy 中，查询操作是通过 query 对象操作数据。最基本的查询是返回表中所有数据，可以通过过滤器进行更精确的数据库查询。

 

在视图函数中定义模型类

from flask import Flask
from flask_sqlalchemy import sqlAlchemy

app = Flask(__name__)

#设置连接数据库的URL
app.config['sqlALCHEMY_DATABASE_URI'] = 'MysqL://root:MysqL@127.0.0.1:3306/test'

app.config['sqlALCHEMY_TRACK_MODIFICATIONS'] = True
#查询时会显示原始sql语句
app.config['sqlALCHEMY_ECHO'] = True
db = sqlAlchemy(app)

class Role(db.Model):
    # 定义表名
    __tablename__ = 'roles'
    # 定义列对象
    id = db.Column(db.Integer, primary_key=True)
    name = db.Column(db.String(64), unique=True)
    us = db.relationship('User', backref='role')

    #repr()方法显示一个可读字符串
    def __repr__(self):
        return 'Role:%s'% self.name

class User(db.Model):
    __tablename__ = 'users'
    id = db.Column(db.Integer, primary_key=True)
    name = db.Column(db.String(64), unique=True, index=True)
    email = db.Column(db.String(64),unique=True)
    password = db.Column(db.String(64))
    role_id = db.Column(db.Integer, db.ForeignKey('roles.id'))

    def __repr__(self):
        return 'User:%s'%self.name
if __name__ == '__main__':
    app.run(debug=True)

View Code

CRDB（增删改查）

#创建表：
db.create_all()
#删除表
db.drop_all()
#插入一条数据
ro1 = Role(name='admin')
db.session.add(ro1)
db.session.commit()
#再次插入一条数据
ro2 = Role(name='user')
db.session.add(ro2)
db.session.commit()
#插入多条记录
us1 = User(name='wang',email='[email protected]',password='123456',role_id=ro1.id)
us2 = User(name='zhang',email='[email protected]',password='201512',role_id=ro2.id)
db.session.add_all([us1,us2])
db.session.commit()

View Code

查询

常用的sqlAlchemy查询过滤器

 常用的sqlAlchemy查询执行器

user = User.query.first()
user.name = 'dong'
db.session.commit()
User.query.first()

View Code

 

#filter_by精确查询
#返回名字等于wang的所有人
User.query.filter_by(name='wang').all()
#过滤名字
#first()返回查询到的第一个对象
User.query.first()
#all()返回查询到的所有对象
User.query.all()
#查询所有对象
#filter模糊查询，返回名字结尾字符为g的所有数据。
User.query.filter(User.name.endswith('g')).all()
#模糊查询
#get():参数为主键，如果主键不存在没有返回内容
User.query.get()
#逻辑非，返回名字不等于wang的所有数据
User.query.filter(User.name!='wang').all()
#逻辑非
#not_ 相当于取反
from sqlalchemy import not_
User.query.filter(not_(User.name=='chen')).all()
#取反
#逻辑与，需要导入and，返回and()条件满足的所有数据
from sqlalchemy import and_
User.query.filter(and_(User.name!='wang',User.email.endswith('163.com'))).all()
#逻辑与
#逻辑或，需要导入or_
from sqlalchemy import or_
User.query.filter(or_(User.name!='wang',User.email.endswith('163.com'))).all()

View Code

删除

user = User.query.first()
db.session.delete(user)
db.session.commit()
User.query.all()

View Code

更新数据

模型之前的关联

一对多

class Role(db.Model):
    ...
    #关键代码
    us = db.relationship('User', backref='role', lazy='dynamic')
    ...

class User(db.Model):
    ...
    role_id = db.Column(db.Integer, db.ForeignKey('roles.id'))

View Code

其中realtionship描述了Role和User的关系。在此文中，第一个参数为对应参照的类"User"

第二个参数backref为类User申明新属性的方法

第三个参数lazy决定了什么时候sqlALchemy从数据库中加载数据

如果设置为子查询方式(subquery)，则会在加载完Role对象后，就立即加载与其关联的对象，这样会让总查询数量减少，但如果返回的条目数量很多，就会比较慢

设置为 subquery 的话，role.users 返回所有数据列表

另外,也可以设置为动态方式(dynamic)，这样关联对象会在被使用的时候再进行加载，并且在返回前进行过滤，如果返回的对象数很多，或者未来会变得很多，那最好采用这种方式

设置为 dynamic 的话，role.users 返回查询对象，并没有做真正的查询，可以利用查询对象做其他逻辑，比如：先排序再返回结果

关联查询示例：

角色和用户的关系是一对多的关系，一个角色可以有多个用户，一个用户只能属于一个角色。

#查询角色的所有用户
#查询roles表id为1的角色
ro1 = Role.query.get(1)
#查询该角色的所有用户
ro1.us.all()


#查询用户所属角色
#查询users表id为3的用户
us1 = User.query.get(3)
#查询用户属于什么角色
us1.role

View Code

多对多

registrations = db.Table('registrations',  
    db.Column('student_id', db.Integer, db.ForeignKey('students.id')),  
    db.Column('course_id', db.Integer, db.ForeignKey('courses.id'))  
)  
class Course(db.Model):
    ...
class Student(db.Model):
    ...
    courses = db.relationship('Course',secondary=registrations,  
                                    backref='students',  
                                    lazy='dynamic')

View Code