Flask-SQLAlchemy 是一个 Flask 扩展,简化了在 Flask 程序中使用 SQLAlchemy 的操作。
SQLAlchemy 是一个很强大的关系型数据库框架,支持多种数据库后台。SQLAlchemy 提
供了高层 ORM,也提供了使用数据库原生 SQL 的低层功能。
pip install flask-sqlalchemy
from flask_sqlalchemy import SQLAlchemy
basedir = os.path.abspath(os.path.dirname(__file__))
app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] =\
'sqlite:///' + os.path.join(basedir, 'data.sqlite')
# sqlchemy将会追踪对象的修改并且发送信号
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False
db = SQLAlchemy(app)
import pymysql
pymysql.install_as_MySQLdb()
app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql://root:redhat@localhost/UserTest'
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False
# 实例化对象
db = SQLAlchemy(app)
class User(db.Model):
# 默认情况下表名为类的名称, 如果想要重新设置表名, __tablename__
# 类变量 __tablename__ 定义在数据库中使用的表名.
__tablename__ = "用户信息"
# db.Column 类构造函数的第一个参数是数据库列和模型属性的类型。
# db.Column 中其余的参数指定属性的配置选项。
id = db.Column(db.Integer, primary_key=True)
username = db.Column(db.String(30), unique=True, nullable=Flase) # unique=True用户名不能重复
password = db.Column(db.String(20), nullable=Flase)
email = db.Column(db.String(20), unique=True)
首先,安装 pip install flask-sqlalchemy
flask-sqlalchemy入门
新建一个flask项目,先实现一些基本功能:
from flask import Flask
from flask_sqlalchemy import SQLAlchemy
import pymysql
pymysql.install_as_MySQLdb() #解决报错
app = Flask(__name__)
db = SQLAlchemy(app)
# 实例化对象
app.config['SQLALCHEMY_DATABASE_URI']='mysql://root:redhat@localhost/UserTest'
app.config['SQLALCHEMY_TRACK_MODIFICATIONS']=True
class User(db.Model):
__tablename__='用户信息'
id = db.Column(db.Integer,primary_key=True)
# primary_key主键
username = db.Column(db.String(30),unique=True)
# unique=True不重复
password = db.Column(db.String(20))
email = db.Column(db.String(20),unique=True)
if __name__ == '__main__':
# 删除所有的表
db.drop_all()
# 创建所有的表
db.create_all()
# 插入数据
u1 = User(username='粉条',password='westos',email='[email protected]')
u2 = User(username='粉丝',password='westos',email='[email protected]')
# 提交给缓存
db.session.add(u1)
db.session.add(u2)
# 缓存提交给数据库
db.session.commit()
#查看数据
user = User.query.all()
print(user)
在这里,需要提前新建一个数据库:UserTest
默认utf8,否则中文无法现实.
这个程序需要在终端进行,否则一直报错:python app.py
出现这个错误,要在程序中添加
import pymysql
pymysql.install_as_MySQLdb() #解决报错
# 删除数据(delete)
delete_u = User.query.filter_by(username='粉条').first()
db.session.delete(delete_u)
db.session.commit()
#更新数据(update)
update_user=User.query.filter_by(username='粉丝').first()
print(update_user.username)
print(update_user.password)
print(update_user.email)
print(update_user.id)
update_user.email = '[email protected]'
db.session.add(update_user)
db.session.commit()
from flask import Flask
from flask_sqlalchemy import SQLAlchemy
from datetime import datetime
# **************************1. python3中MySQLdb报错解决方法*************************
import pymysql
pymysql.install_as_MySQLdb()
app = Flask(__name__)
# *************************2. 数据库的配置与实例化**********************************
# 对数据库操作(mysql, redis)
app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql://root:redhat@localhost/UserTest'
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False
# 实例化对象
db = SQLAlchemy(app)
# ***********************3. 定义数据库模型************************************
# user ==== (id, username, password, email)
class User(db.Model):
# 默认情况下表名为类的名称, 如果想要重新设置表名, __tablename__
__tablename__ = "用户信息"
id = db.Column(db.Integer, primary_key=True)
username = db.Column(db.String(30), unique=True, index=True, nullable=False) # unique=True用户名不能重复
password = db.Column(db.String(20), nullable=False)
email = db.Column(db.String(20), unique=True, index=True)
# 设置默认值, 位当前用户的创建时间;
add_time = db.Column(db.DateTime, default=datetime.now() )
if __name__ == '__main__':
# 创建所有的表
db.drop_all()
db.create_all()
# 插入数据(insert)
u1 = User(username="粉条", password="westos", email="[email protected]")
u2 = User(username="粉丝", password="westos", email="[email protected]")
db.session.add(u1)
db.session.add(u2)
db.session.commit()
# 删除数据(delete)
delete_user = User.query.filter_by(username="粉条").first()
db.session.delete(delete_user)
db.session.commit()
# 更新数据(update)
update_user = User.query.filter_by(username="粉丝").first()
print(update_user.username)
print(update_user.password)
print(update_user.email)
print(update_user.id)
print("正在更新邮箱地址.......")
update_user.email = '[email protected]'
db.session.add(update_user)
db.session.commit()
print(update_user.email)
# 查看数据(select)
users = User.query.all()
print(users)
# 删除所有的表;
#db.drop_all()
关联用户角色与网站用户:
三个用户角色,对应网站里用户
from datetime import datetime
from flask import Flask
from flask_sqlalchemy import SQLAlchemy
import pymysql
pymysql.install_as_MySQLdb() #解决报错
app = Flask(__name__)
db = SQLAlchemy(app)
# 实例化对象
app.config['SQLALCHEMY_DATABASE_URI']='mysql://root:redhat@localhost/UserTest'
app.config['SQLALCHEMY_TRACK_MODIFICATIONS']=True
class Role(db.Model):
__tablename__='用户角色'
id = db.Column(db.Integer,primary_key=True,autoincrement=True)
name=db.Column(db.String(20))
class User(db.Model):
__tablename__='网站用户'
id = db.Column(db.Integer,primary_key=True)
# primary_key主键
username = db.Column(db.String(30),unique=True,index=True,nullable=False)
# unique=True不重复
password = db.Column(db.String(20),nullable=False)
email = db.Column(db.String(20),unique=True,index=True)
# 设置默认值为当前用户创建时间
add_time=db.Column(db.DateTime,default=datetime.now())
# 用户id不能随便设置,要从Role中查询,(外键关联)
role_id = db.Column(db.Integer,db.ForeignKey('用户角色.id'))
if __name__ == '__main__':
db.create_all()
# 1添加角色
role1 = Role(name='普通用户')
role2 = Role(name='会员')
role3=Role(name='管理员')
db.session.add_all([role1,role2,role3])
db.session.commit()
user1 = User(username='westos1',password='westos1',email='[email protected]',role_id=1)
db.session.add(user1)
db.session.commit()
刚才的代码不太友好,我们修改有好些:
from datetime import datetime
from flask import Flask
from flask_sqlalchemy import SQLAlchemy
import pymysql
pymysql.install_as_MySQLdb() #解决报错
app = Flask(__name__)
db = SQLAlchemy(app)
# 实例化对象
app.config['SQLALCHEMY_DATABASE_URI']='mysql://root:redhat@localhost/UserTest'
app.config['SQLALCHEMY_TRACK_MODIFICATIONS']=True
class Role(db.Model):
__tablename__='用户角色'
id = db.Column(db.Integer,primary_key=True,autoincrement=True)
name=db.Column(db.String(20))
# 反向引用, Role表中有属性users, User类中有role这个属性;
users = db.relationship('User', backref='role')
def __repr__(self):
return '' %(self.name)
class User(db.Model):
__tablename__='网站用户'
id = db.Column(db.Integer,primary_key=True)
# primary_key主键
username = db.Column(db.String(30),unique=True,index=True,nullable=False)
# unique=True不重复
password = db.Column(db.String(20),nullable=False)
email = db.Column(db.String(20),unique=True,index=True)
# 设置默认值为当前用户创建时间
add_time=db.Column(db.DateTime,default=datetime.now())
# 用户id不能随便设置,要从Role中查询,(外键关联)
role_id = db.Column(db.Integer,db.ForeignKey('用户角色.id'))
def __repr__(self):
return '' %(self.username)
if __name__ == '__main__':
db.drop_all() # 第一次运行时注释掉
db.create_all()
# 1添加角色
role1 = Role(name='普通用户')
role2 = Role(name='会员')
role3=Role(name='管理员')
db.session.add_all([role1,role2,role3])
db.session.commit()
# 2添加用户
user1 = User(username='westos1',password='westos1',email='[email protected]',role_id=1)
db.session.add(user1)
db.session.commit()
# 查看数据信息
print(User.query.all())
print(Role.query.all())
批量添加用户
from datetime import datetime
from flask import Flask, render_template
from flask_sqlalchemy import SQLAlchemy, Pagination
from flask_bootstrap import Bootstrap
import pymysql
from sqlalchemy import desc, func
pymysql.install_as_MySQLdb()
app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql://root:redhat@localhost/UserTest'
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False
db = SQLAlchemy(app)
### 用户和角色是什么关系?
# - 一对一
# - 一对多: 角色是一, 用户是多, 外键写在多的一端
# - 多对多
class Role(db.Model):
__tablename__ = "用户角色"
# id号递增autoincrement=True
id = db.Column(db.Integer, primary_key=True, autoincrement=True)
name = db.Column(db.String(20))
# 反向引用, Role表中有属性users, User类中有role这个属性;
users = db.relationship('User', backref='role')
def __repr__(self):
return "" % (self.name)
class User(db.Model):
__tablename__ = "网站用户"
id = db.Column(db.Integer, primary_key=True)
username = db.Column(db.String(30), unique=True, index=True, nullable=False) # unique=True用户名不能重复
password = db.Column(db.String(20), nullable=False)
email = db.Column(db.String(20), unique=True, index=True)
# 设置默认值, 位当前用户的创建时间;
add_time = db.Column(db.DateTime, default=datetime.now())
#### 重要的: 用户角色id不能随便设置, 需要从Role中查询, (外键关联)
role_id = db.Column(db.Integer, db.ForeignKey('用户角色.id'))
# 定义了 __repr()__ 方法,返回一个具有可读性的字符串表示模型,可在调试和测试时使用。
def __repr__(self):
return "" % (self.username)
if __name__ == '__main__':
db.drop_all()
db.create_all()
# ***********************1. 添加数据
# 1). 添加角色
role1 = Role(name="普通用户")
role2 = Role(name="会员")
role3 = Role(name="管理员")
db.session.add_all([role1, role2, role3])
db.session.commit()
# 2). 添加用户
user1 = User(username="westos1", password="westos1",
email="[email protected]", role_id=1)
db.session.add(user1)
db.session.commit()
# **********************2. 查看数据信息
print(User.query.all())
print(Role.query.all())
# 批量添加用户100个是普通用户, 50个是VIP用户, 10个管理员
for item in range(100):
user = User(
username="fentiao%s" % (item),
password="fentiao",
email="fentiao%s" % (item),
role_id=1
)
db.session.add(user)
for item in range(50):
user = User(
username="vip%s" % (item),
password="vip",
email="vip%s" % (item),
role_id=2
)
db.session.add(user)
for item in range(10):
user = User(
username="admin%s" % (item),
password="admin",
email="admin%s" % (item),
role_id=3
)
db.session.add(user)
# 将批量添加的用户提交到数据库中.
db.session.commit()
# 获取所有的普通用户
common_users = User.query.filter_by(role_id='1').all()
print(common_users)
vip_users = User.query.filter_by(role_id='2').all()
print(vip_users)
# 获取所有的普通用户转化成的sql语句查看;
print(User.query.filter_by(role_id='1'))
# 获取所有的普通用户转化成的sql语句查看;
print(User.query.filter_by(role_id='1'))
print(User.query)
# filter过滤器的使用(更偏向于SQL语句)
common_users = User.query.filter(User.role_id == 1).all()
print(common_users)
# limit过滤器, 只显示返回结果的前几条数据;
common_users_limit = User.query.filter(User.role_id == 1).limit(5).all()
print(common_users_limit)
# offset过滤器: 偏移显示
common_users_offset = User.query.filter(User.role_id == 1).offset(2).limit(3).all()
print(common_users_offset)
# order_by排序过滤器, 默认是升序的, 如果要降序desc(属性名)
common_users_order = User.query.order_by(User.role_id).all()
print(common_users_order)
# 降序
common_users_desc_order = User.query.order_by(desc(User.role_id)).all()
print(common_users_desc_order)
# group_by, 分组统计
users_analysis=User.query.add_columns(func.count(User.role_id)).group_by(User.role_id).all()
print(users_analysis)
# get方法
print(User.query.get(1))
print(User.query.get_or_404(1000))
# count
print(User.query.filter_by(role_id=1).count())
print(User.query.filter_by(role_id=2).count())
print(User.query.filter_by(role_id=3).count())
# paginate分页的对象
# page=2: 要显示第2页的数据, per_page=5: 每页显示数据的条数
# 101+50+10
usersPageObj = User.query.paginate(page=2, per_page=5)
print("当前页面的记录数:", usersPageObj.items)
print("分页查询的源sql语句:", usersPageObj.query)
print("当前显示的页数:", usersPageObj.page)
print("上一页的页数:", usersPageObj.prev_num)
print("下一页的页数:", usersPageObj.next_num)
print("是否包含上一页:", usersPageObj.has_prev)
print("是否包含下一页:", usersPageObj.has_next)
print("总页数:", usersPageObj.pages)
print("每页记录的数量:", usersPageObj.per_page)
print("记录总数:", usersPageObj.total)
print("页码显示:", list(usersPageObj.iter_pages()))
print("上一页的数据:", usersPageObj.prev().items)
print("下一页的数据:", usersPageObj.next().items)
# Role表反向引用
admin_role = Role.query.filter_by(name="管理员").first()
print(admin_role.id)
print(admin_role.name)
print(admin_role.users)
# User表中
admin_user = User.query.filter_by(username='admin1').first()
admin_user_id = admin_user.role_id
print(Role.query.filter_by(id=admin_user_id).first().name)
admin_user = User.query.filter_by(username='admin1').first()
print(admin_user.role.name)
新建一个flask文件
app.py文件中:
from datetime import datetime
from flask import Flask, render_template
from flask_sqlalchemy import SQLAlchemy, Pagination
from flask_bootstrap import Bootstrap
import pymysql
from sqlalchemy import desc, func
pymysql.install_as_MySQLdb()
app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql://root:redhat@localhost/UserTest'
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False
db = SQLAlchemy(app)
bt = Bootstrap(app)
### 用户和角色是什么关系?
# - 一对一
# - 一对多: 角色是一, 用户是多, 外键写在多的一端
# - 多对多
class Role(db.Model):
__tablename__ = "用户角色"
# id号递增autoincrement=True
id = db.Column(db.Integer, primary_key=True, autoincrement=True)
name = db.Column(db.String(20))
# 反向引用, Role表中有属性users, User类中有role这个属性;
users = db.relationship('User', backref='role')
def __repr__(self):
return "" % (self.name)
class User(db.Model):
__tablename__ = "网站用户"
id = db.Column(db.Integer, primary_key=True)
username = db.Column(db.String(30), unique=True, index=True, nullable=False) # unique=True用户名不能重复
password = db.Column(db.String(20), nullable=False)
email = db.Column(db.String(20), unique=True, index=True)
# 设置默认值, 位当前用户的创建时间;
add_time = db.Column(db.DateTime, default=datetime.now())
#### 重要的: 用户角色id不能随便设置, 需要从Role中查询, (外键关联)
role_id = db.Column(db.Integer, db.ForeignKey('用户角色.id'))
# 定义了 __repr()__ 方法,返回一个具有可读性的字符串表示模型,可在调试和测试时使用。
def __repr__(self):
return "" % (self.username)
# http://www.csdn.net/list/
# http://www.csdn.net/list/1/
# http://www.csdn.net/list/2/
@app.route('/list/')
@app.route('/list//')
def list(page=1):
# 每页显示的数据
per_page = 10
# 返回的是 Pagination对象
userPageObj = User.query.paginate(page=page, per_page=per_page)
return render_template('list.html',
userPageObj=userPageObj
)
if __name__ == '__main__':
app.run(port=5005)
list.html
{% extends 'bootstrap/base.html' %}
{% block title %}
用户显示
{% endblock %}
{% block content %}
用户信息
编号
姓名
邮箱
创建时间
用户角色
{% for user in userPageObj.items %}
{{ user.id }}
{{ user.username }}
{{ user.email }}
{{ user.add_time }}
{{ user.role.name }}
{% endfor %}
{% endblock %}
这里用了bootstrap分页框架
结构:注意app.py和config.py要写在和app目录同等级别的位置
.
├── app
│ ├── forms.py 无表单内容所以为空
│ ├── init.py
│ ├── models.py 与数据库相关内容
│ ├── pycache
│ │ ├── init.cpython-36.pyc 导入包的内容
│ │ ├── models.cpython-36.pyc
│ │ └── views.cpython-36.pyc
│ ├── static
│ ├── templates
│ │ └── list.html
│ └── views.py 视图函数相关内容
├── app.py
├── config.py 数据库状态相关内容
init.py
from flask import Flask
from flask_sqlalchemy import SQLAlchemy
from flask_bootstrap import Bootstrap
import pymysql
pymysql.install_as_MySQLdb()
app = Flask(__name__)
# 将配置信息独立成一个文件, 便于将来修改;
app.config.from_pyfile('config.py')
db = SQLAlchemy(app)
bt = Bootstrap(app)
app.py
from app import app
from app.views import *
if __name__=='__main__':
app.run()
config.py
SQLALCHEMY_DATABASE_URI = 'mysql://root:redhat@localhost/UserTest'
SQLALCHEMY_TRACK_MODIFICATIONS = True
PER_PAGE = 10
models.py
from . import db
from datetime import datetime
### 用户和角色是什么关系?
# - 一对一
# - 一对多: 角色是一, 用户是多, 外键写在多的一端
# - 多对多
class Role(db.Model):
__tablename__ = "用户角色"
# id号递增autoincrement=True
id = db.Column(db.Integer, primary_key=True, autoincrement=True)
name = db.Column(db.String(20))
# 反向引用, Role表中有属性users, User类中有role这个属性;
users = db.relationship('User', backref='role')
def __repr__(self):
return "" % (self.name)
class User(db.Model):
__tablename__ = "网站用户"
id = db.Column(db.Integer, primary_key=True)
username = db.Column(db.String(30), unique=True, index=True, nullable=False) # unique=True用户名不能重复
password = db.Column(db.String(20), nullable=False)
email = db.Column(db.String(20), unique=True, index=True)
# 设置默认值, 位当前用户的创建时间;
add_time = db.Column(db.DateTime, default=datetime.now())
#### 重要的: 用户角色id不能随便设置, 需要从Role中查询, (外键关联)
role_id = db.Column(db.Integer, db.ForeignKey('用户角色.id'))
# 定义了 __repr()__ 方法,返回一个具有可读性的字符串表示模型,可在调试和测试时使用。
def __repr__(self):
return "" % (self.username)
views.py
"""
文件名: $NAME.py
日期: 10
作者: lvah
联系: [email protected]
代码描述:
# 存储视图函数的部分
"""
# http://www.csdn.net/list/
# http://www.csdn.net/list/1/
# http://www.csdn.net/list/2/
from flask import render_template
from app import app
from app.models import User
@app.route('/list/')
@app.route('/list//')
def list(page=1):
# 每页显示的数据
per_page = 10
# 返回的是 Pagination对象
userPageObj = User.query.paginate(page=page, per_page=per_page)
return render_template('list.html',
userPageObj=userPageObj
)
list.html
{% extends 'bootstrap/base.html' %}
{% block title %}
用户显示
{% endblock %}
{% block content %}
用户信息
编号
姓名
邮箱
创建时间
用户角色
{% for user in userPageObj.items %}
{{ user.id }}
{{ user.username }}
{{ user.email }}
{{ user.add_time }}
{{ user.role.name }}
{% endfor %}
{% endblock %}