背景

在做后台接口开发时，我们总会遇到新增字段或者修改字段的问题。
在开发阶段我们可以删表重建，但是上线之后可不能这么搞了。所以数据迁移就很重要了。

所谓的数据迁移原理其实就是将数据复制出来然后再把表删了重新建表同时把数据再复制进去。

这里我用到的ORM是Sequelize所以下面简单介绍一下Sequelize实现数据迁移的过程。

实现

安装 sequelize/cli 依赖

npm install --save-dev sequelize-cli

初始化

在项目目录（我这里是starter）执行下面的命令

npx sequelize-cli init

会在当前目录下生成相关目录如下：

• config/config.json：包含配置文件,它告诉CLI如何连接数据库。可直接从项目的数据库配置中复制过来，内容如下：

{
   
   
  "development": {
   
   
    "username": "root",
    "password": "数据库密码",
    "database": "lin-cms",
    "host": "localhost",
    "dialect": "mysql"
  },
  "test": {
   
   
    "username": "root",
    "password": "数据库密码",
    "database": "lin-cms",
    "host": "localhost",
    "dialect": "mysql"
  },
  "production": {
   
   
    "username": "root",
    "password": "数据库密码",
    "database": "lin-cms",
    "host": "localhost",
    "dialect": "mysql"
  }
}

• migrations：包含所有迁移文件。数据迁移的主要文件，后面介绍。
• seeders：包含所有种子文件。使用样本数据或测试数据填充数据库表时可以使用seeders文件去实现。比如向用户表中插入用户：

module.exports = {
   
   
  up: (queryInterface, Sequelize) => {
   
   
    return queryInterface.bulkInsert('Users', [{
   
   
      firstName: 'John',
      lastName: 'Doe',
      email: 'example@example.com',
      createdAt: new Date(),
      updatedAt: new Date()
    }]);
  },
  down: (queryInterface, Sequelize) => {
   
   
    return queryInterface.bulkDelete('Users', null, {
   
   });
  }
};

• models：包含你的项目的所有模型。

实现数据迁移

目的是要在已经存在的 goods表中增加pay_type字段，并且不删除表中的数据。

我们先按照上面的步骤完成初始化之后，就可以创建迁移文件了。
可通过如下命令创建文件：

npx sequelize-cli migration:generate --name migration-good-add-paytype-column

• migration-good-add-paytype-column：是我们的迁移文件名称
  执行完之后会在migrations文件夹下生成文件：
  

接下来就是在该文件中编写迁移逻辑了，文件内容如下：

'use strict';

module.exports = {
   
   
  up: async (queryInterface, Sequelize) => {
   
   
    /**
     * Add altering commands here. 更新的操作
     *
     * Example:
     * await queryInterface.createTable('users', { id: Sequelize.INTEGER });
     */
    return queryInterface.sequelize.transaction(t => {
   
   
      return Promise.all([
      // 在 goods 表中增加 string 类型的 pay_type 字段
        queryInterface.addColumn('Goods', 'pay_type', {
   
   
          type: Sequelize.DataTypes.STRING
        }, {
   
    transaction: t }),
        
      ]);
    });
  },

  down: async (queryInterface, Sequelize) => {
   
   
    /**
     * Add reverting commands here. 回退的操作
     *
     * Example:
     * await queryInterface.dropTable('users');
     */
  }
};

编写完迁移逻辑之后，执行如下命令即可完成数据迁移：

npx sequelize-cli db:migrate

最后我们可以在数据库表中看到已经在现有数据的基础上增加了pay_type字段。

多表依赖可参考文档中的介绍。
Sequelize 高级专题

TIP:
在新增完字段之后，应该还需要在原有的Model对象里面添加，如这里是model/good.js需要增加pay_type否则添加商品信息该字段没有添加成功。（目前测试是这样）

import sequelize from '../lib/db';
import {
   
   
    Sequelize
} from 'sequelize';
import {
   
   
    GoodParentCategory
} from './good-category';

// 这是我们用于以下示例的模型的设置
const Good = sequelize.define('good', {
   
   
    id: {
   
   
        type: Sequelize.INTEGER,
        primaryKey: true,
        autoIncrement: true
    },
    title: {
   
   
        type: Sequelize.STRING(50),
        allowNull: false
    },
     // 新增
    brand:{
   
   
        type: Sequelize.STRING(50),
        allowNull: false
    },
    image: {
   
   
        type: Sequelize.STRING(100),
        allowNull: false
    },
    category: {
   
   
        type: Sequelize.STRING(10),
        allowNull: false
    },
    stock: {
   
   
        type: Sequelize.INTEGER,
        allowNull: false
    },
    original_price: {
   
   
        type: Sequelize.INTEGER,
        allowNull: false
    },
    price: {
   
   
        type: Sequelize.INTEGER,
        allowNull: false
    },
    // 新增
    pay_type:{
   
   
        type: Sequelize.STRING(10),
        allowNull: false
    },
    summary: {
   
   
        type: Sequelize.STRING(1000),
        allowNull: false
    },
});
GoodParentCategory.hasMany(Good);
Good.belongsTo(GoodParentCategory);

export {
   
   
    Good
};

参考

• Sequelize 迁移
• Sequelize 更新数据库表字段
• GitHub - sequelize/cli

本文同步分享在 博客“_龙衣”（CSDN）。
如有侵权，请联系 support@oschina.cn 删除。
本文参与“OSC源创计划”，欢迎正在阅读的你也加入，一起分享。