一、Flask的数据库设置
app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql://root:mysql@127.0.0.1:3306/test'
# 动态追踪修改设置,如未设置只会提示警告, 不建议开启
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False
# 查询时会显示原始SQL语句
app.config['SQLALCHEMY_ECHO'] = True
SQLALCHEMY_DATABASE_URI
用于连接的数据库 URI 。例如:sqlite:tmp/test.dbmysql://username:password@server/db
SQLALCHEMY_BINDS
一个映射 binds 到连接 URI 的字典。更多 binds 的信息见用 Binds 操作多个数据库。
SQLALCHEMY_ECHO
如果设置为Ture, SQLAlchemy 会记录所有 发给 stderr 的语句,这对调试有用。(打印sql语句)
SQLALCHEMY_RECORD_QUERIES
可以用于显式地禁用或启用查询记录。查询记录 在调试或测试模式自动启用。更多信息见get_debug_queries()。
SQLALCHEMY_NATIVE_UNICODE
可以用于显式禁用原生 unicode 支持。当使用 不合适的指定无编码的数据库默认值时,这对于 一些数据库适配器是必须的(比如 Ubuntu 上 某些版本的 PostgreSQL )。
SQLALCHEMY_POOL_SIZE
数据库连接池的大小。默认是引擎默认值(通常 是 5 )
SQLALCHEMY_POOL_TIMEOUT
设定连接池的连接超时时间。默认是 10 。
SQLALCHEMY_POOL_RECYCLE
多少秒后自动回收连接。这对 MySQL 是必要的, 它默认移除闲置多于 8 小时的连接。注意如果 使用了 MySQL , Flask-SQLALchemy 自动设定 这个值为 2 小时。
二、SQLAlchemy字段类型
Integer | int | 普通整数,一般是32位
SmallInteger| int| 取值范围小的整数,一般是16位
BigInteger| int或long| 不限制精度的整数
Float| float| 浮点数
Numeric| decimal.Decimal| 普通整数,一般是32位
String| str| 变长字符串
Text| str| 变长字符串,对较长或不限长度的字符串做了优化
Unicode| unicode| 变长Unicode字符串
UnicodeText| unicode| 变长Unicode字符串,对较长或不限长度的字符串做了优化
Boolean| bool| 布尔值
Date| datetime.date| 时间
Time| datetime.datetime| 日期和时间
LargeBinary| str| 二进制文件
三、SQLAlchemy列选项
primary_key | 如果为True,代表表的主键
unique | 如果为True,代表这列不允许出现重复的值
index | 如果为True,为这列创建索引,提高查询效率
nullable | 如果为True,允许有空值,如果为False,不允许有空值
default | 为这列定义默认值
四、SQLAlchemy关系选项
backref | 在关系的另一模型中添加反向引用
primary join | 明确指定两个模型之间使用的联结条件
uselist | 如果为False,不使用列表,而使用标量值
order_by | 指定关系中记录的排序方式
secondary | 指定多对多中记录的排序方式
secondary join | 在SQLAlchemy中无法自行决定时,指定多对多关系中的二级联结条件backref 在关系的另一模型中添加反向引用
primary join | 明确指定两个模型之间使用的联结条件
uselist | 如果为False,不使用列表,而使用标量值
order_by | 指定关系中记录的排序方式
secondary | 指定多对多中记录的排序方式
secondary join | 在SQLAlchemy中无法自行决定时,指定多对多关系中的二级联结条件
五、数据库增删改
db.session.add(role) 添加到数据库的session中
db.session.add_all([user1, user2]) 添加多个信息到session中
db.session.commit() 提交数据库的修改(包括增/删/改)
db.session.rollback() 数据库的回滚操作
db.session.delete(user) 删除数据库(需跟上commit)
六、查询条件
filter() | 把过滤器添加到原查询上,返回一个新查询
filter_by() | 把等值过滤器添加到原查询上,返回一个新查询
limit | 使用指定的值限定原查询返回的结果
offset() | 偏移原查询返回的结果,返回一个新查询
order_by() | 根据指定条件对原查询结果进行排序,返回一个新查询
group_by() | 根据指定条件对原查询结果进行分组,返回一个新查询
七、SQLAlchemy查询执行器
all() | 以列表形式返回查询的所有结果
first() | 返回查询的第一个结果,如果未查到,返回None
first_or_404() | 返回查询的第一个结果,如果未查到,返回404
get() | 返回指定主键对应的行,如不存在,返回None
get_or_404() | 返回指定主键对应的行,如不存在,返回404
count() | 返回查询结果的数量
paginate() | 返回一个Paginate对象,它包含指定范围内的结果