一、安装以及使用

1、安装

　　安装 flask-sqlalchemy

　　　　pip install flask-sqlalchemy

　　如果连接的是 mysql 数据库，需要安装 mysqldb

　　　　pip install flask-mysqldb

2、连接配置

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)

if __name__ == '__main__':

    app.run(debug=True)

SQLalchemy

3、SQLalchemy模型类设置

　　常见SQLalchemy字段类型

　　常用SQLalchemy列选项

　　常用SQLalchemy关系选项

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)

model.py

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

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

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

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

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

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

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

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

一对多

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

多对多

class Comment(db.Model):

    """评论"""

    __tablename__ = "comments"

    id = db.Column(db.Integer, primary_key=True)

    # 评论内容

    content = db.Column(db.Text, nullable=False)

    # 父评论id

    parent_id = db.Column(db.Integer, db.ForeignKey("comments.id"))

    # 父评论(也是评论模型)

    parent = db.relationship("Comment", remote_side=[id],

                             backref=db.backref('childs', lazy='dynamic'))

# 测试代码

if __name__ == '__main__':

    db.drop_all()

    db.create_all()

    com1 = Comment(content='我是主评论1')

    com2 = Comment(content='我是主评论2')

    com11 = Comment(content='我是回复主评论1的子评论1')

    com11.parent = com1

    com12 = Comment(content='我是回复主评论1的子评论2')

    com12.parent = com1

    db.session.add_all([com1, com2, com11, com12])

    db.session.commit()

    app.run(debug=True)

自关联一对多

tb_user_follows = db.Table(

    "tb_user_follows",

    db.Column('follower_id', db.Integer, db.ForeignKey('info_user.id'), primary_key=True),  # 粉丝id

    db.Column('followed_id', db.Integer, db.ForeignKey('info_user.id'), primary_key=True)  # 被关注人的id

)

class User(db.Model):

    """用户表"""

    __tablename__ = "info_user"

    id = db.Column(db.Integer, primary_key=True)

    name = db.Column(db.String(32), unique=True, nullable=False)

    # 用户所有的粉丝，添加了反向引用followed，代表用户都关注了哪些人

    followers = db.relationship('User',

                                secondary=tb_user_follows,

                                primaryjoin=id == tb_user_follows.c.followed_id,

                                secondaryjoin=id == tb_user_follows.c.follower_id,

                                backref=db.backref('followed', lazy='dynamic'),

                                lazy='dynamic')

自关联多对多

4、数据库操作

　　创建表

　　　　db.create_all()

　　删除表

　　　　db.drop_all()

　　增

　　　　增加一条数据

ro1 = Role(name='admin')

db.session.add(ro1)

db.session.commit()

　　　　增加多条数据

us1 = User(name='wang',email='wang@163.com',password='123456',role_id=ro1.id)

us2 = User(name='zhang',email='zhang@189.com',password='201512',role_id=ro2.id)

us3 = User(name='chen',email='chen@126.com',password='987654',role_id=ro2.id)

us4 = User(name='zhou',email='zhou@163.com',password='456789',role_id=ro1.id)

us5 = User(name='tang',email='tang@itheima.com',password='158104',role_id=ro2.id)

us6 = User(name='wu',email='wu@gmail.com',password='5623514',role_id=ro2.id)

us7 = User(name='qian',email='qian@gmail.com',password='1543567',role_id=ro1.id)

us8 = User(name='liu',email='liu@itheima.com',password='867322',role_id=ro1.id)

us9 = User(name='li',email='li@163.com',password='4526342',role_id=ro2.id)

us10 = User(name='sun',email='sun@163.com',password='235523',role_id=ro2.id)

db.session.add_all([us1,us2,us3,us4,us5,us6,us7,us8,us9,us10])

db.session.commit()

　　删

user = User.query.first()

db.session.delete(user)

db.session.commit()

　　改

user = User.query.first()

user.name = 'dong'

db.session.commit()

　　查

#filter_by()精确查询

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

#分页

#从get方法中取得页码

page = request.args.get('page', 1, type = int)

#获取pagination对象

    pagination = Post.query.paginate(page, per_page=10, error_out = False)

#第一个参数表示当前页,第二个参数代表每页显示的数量,error_out=True的情况下如果指定页没有内容将出现404错误,否则返回空的列表

#pagination对象的items方法返回当前页的内容列表

    posts = pagination.items

#pagination对象常用方法:

#has_next :是否还有下一页

#has_prev :是否还有上一页

#items : 返回当前页的所有内容

#next(error_out=False) : 返回下一页的Pagination对象

#prev(error_out=False) : 返回上一页的Pagination对象

#page : 当前页的页码(从1开始)

#pages : 总页数

#per_page : 每页显示的数量

#prev_num : 上一页页码数

#next_num :下一页页码数

#query :返回 创建这个Pagination对象的查询对象

#total :查询返回的记录总数

#iter_pages(left_edge=2, left_current=2, right_current=5, right_edge=2)

5、数据库迁移：flask-migrate

　　sqlalchemy修改数据库表结构需要删除表，这样会造成数据的丢失。flask-migrate：为了方便数据库的修改，并且追踪每次修改的记录。

　　安装Flask-Migrate

　　　　pip install flask-migrate

#coding=utf-8

from flask import Flask

from flask_sqlalchemy import SQLAlchemy

from flask_migrate import Migrate,MigrateCommand

from flask_script import Shell,Manager

app = Flask(__name__)

manager = Manager(app)

app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql://root:mysql@127.0.0.1:3306/Flask_test'

app.config['SQLALCHEMY_COMMIT_ON_TEARDOWN'] = True

app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = True

db = SQLAlchemy(app)

#第一个参数是Flask的实例，第二个参数是Sqlalchemy数据库实例

migrate = Migrate(app,db) 

#manager是Flask-Script的实例，这条语句在flask-Script中添加一个db命令

manager.add_command('db',MigrateCommand)

#定义模型Role

class Role(db.Model):

    # 定义表名

    __tablename__ = 'roles'

    # 定义列对象

    id = db.Column(db.Integer, primary_key=True)

    name = db.Column(db.String(64), unique=True)

    user = db.relationship('User', backref='role')

    #repr()方法显示一个可读字符串，

    def __repr__(self):

        return 'Role:'.format(self.name)

#定义用户

class User(db.Model):

    __talbe__ = 'users'

    id = db.Column(db.Integer, primary_key=True)

    username = db.Column(db.String(64), unique=True, index=True)

    #设置外键

    role_id = db.Column(db.Integer, db.ForeignKey('roles.id'))

    def __repr__(self):

        return 'User:'.format(self.username)

if __name__ == '__main__':

    manager.run()

database.py

　　数据库初始化（创建migrations文件夹）

　　　　python database.py db init

　　数据库migrations

　　　　python database.py db migrate -m "注释"

　　数据库migrate

　　　　python database.py db upgrade

　　查询以前的版本

　　　　python database.py db history

　　回滚到指定版本

　　　　python database.py db downgrade 版本号

巴特西

数据库：Flask-SQLAlchemy