Flask-SQLAlchemy

一、Flask的数据库设置

app.config['SQLALCHEMY_DATABASE_URI'] = 'mysql://root:[email protected]: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对象，它包含指定范围内的结果