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以后使用正常