Sanic二十二:Sanic + tortoise-orm 之使用aerich执行数据库迁移

 

在定义了模型,或者对模型进行了一些修改过后,是不会直接映射到数据库,并修改表的,这个时候就需要使用数据看迁移工具,tortoise-orm匹配的数据库迁移工具为aerich

aerich没有官网,只能在GitHub上找到源码,源码上有简略的使用方法:https://github.com/tortoise/aerich

 

安装:pip install aerich

 

准备在不同的两个python脚本中,分别准备多个模型

 

准备好配置:setting.py

TORTOISE_ORM = {
"connections": {"default": "mysql://root:123456@localhost:3306/test?charset=utf8mb4"}, # MySQL
# "connections": {"default": "sqlite://db.sqlite3"}, # sqlite
"apps": {
# 模型分组名字,当需要使用此app下的模型的时候,需使用 此名字.模型名称
"test_models": {
# 须添加"aerich.models", 此时,会在数据库中生成一个名为aerich的表用于存模型信息,以便以后做脚本迁移
"models": ["aerich.models", "user", "project"], # 模型所在的py文件
"default_connection": "default"
}
}
}

 

1、执行aerich初始化:aerich init -t 指定配置
aerich init -t settings.TORTOISE_ORM

将会在目录下生成空的 migrations 文件夹和 aerich.ini 文件

 

2、将模型映射到数据库中:aerich init-db

此时数据库中就会生成对应的表

migrations 下将会生成SQL语句

aerich表下会存每个模型的内容

 

如果修改了模型则需要重新生成SQL语句,并推送到数据库

现有表

修改模型

 

3、重新生成SQL语句:aerich migrate 

 

4、把新生成的SQL推送到数据库:aerich upgrade

表信息

 

5、如果要回到上一个版本:aerich downgrade

 

6、查看历史迁移记录:aerich history

 

7、查看形成当前版本的迁移记录文件:aerich heads

 

8、aerich 除了提供命令行之外,还提供了代码内执行的办法,从aerich引入 Command类即可,提供的方法与命令行一样

 

注:根据实测,在MySQL5.7上使用会报错:

 

换成MySQL8以后使用正常 

 

posted @ 2021-08-23 22:54  向前走。  阅读(1443)  评论(0编辑  收藏  举报