使用 Sequelize 迁移添加新列的步骤-js教程-、刘德华、刘亦菲、谌洪

使用 sequelize 迁移添加新列的步骤

为了提升博客平台的视觉效果和用户体验，我添加了一个缩略图列到数据库中，以便在每个文章页面显示文章缩略图。此更新与博客文章显示方式的改变相辅相成：从在一个页面显示所有文章，转变为每个文章拥有独立页面，从而改善了文章数量增多后的导航体验。

缩略图列存储图像链接字符串，这种方式保持了数据库的轻量级，并通过将图像存储处理与数据库分离，实现了关注点分离。

模型更新与迁移

首先，我更新了 blogposts 模型，添加了 thumbnail 列：

thumbnail: {
    type: DataTypes.STRING,
    allowNull: true, // 允许旧文章没有缩略图
},

登录后复制

仅仅修改模型是不够的，PostgreSQL 数据库并不会自动识别新的列。我尝试访问数据库时收到了错误提示：“缩略图”列不存在。这是因为 Sequelize 模型定义了应用与数据库的交互方式，但不会自动修改数据库架构。因此，我需要使用 Sequelize 迁移来解决这个问题。

Sequelize 迁移配置

在创建迁移之前，我确保 Sequelize CLI 已在项目中初始化。执行 npm install sequelize-cli 后，运行 npx sequelize-cli init （这会创建 config/ 文件夹和相关配置文件）。

我选择使用 config.js 而不是 config.json，并利用 dotenv 加载环境变量：

require('dotenv').config();

module.exports = {
    development: {
        username: process.env.db_user,
        password: process.env.db_password,
        database: process.env.db_name,
        host: process.env.db_host,
        dialect: "postgres",
    },
    production: {
        username: process.env.db_user,
        password: process.env.db_password,
        database: process.env.db_name,
        host: process.env.db_host,
        dialect: "postgres",
    },
};

登录后复制

然后我删除了 config.json 文件避免冲突。

生成迁移文件

接下来，我使用以下命令生成迁移文件：

npx sequelize-cli migration:generate --name add-thumbnail-to-blogposts

这会在 migrations/ 文件夹中创建一个名为 20241206232526-add-thumbnail-to-blogposts.js 的文件（时间戳可能不同）。我修改了此文件：

module.exports = {
  up: async (queryInterface, Sequelize) => {
      await queryInterface.addColumn('blogposts', 'thumbnail', {
          type: Sequelize.STRING,
          allowNull: true,
      });
  },

  down: async (queryInterface) => {
      await queryInterface.removeColumn('blogposts', 'thumbnail');
  },
};

登录后复制

应用迁移

为了更新开发数据库，我运行：

npx sequelize-cli db:migrate

这成功地将 thumbnail 列添加到 blogposts 表中。

生产环境迁移

在生产环境中，我遵循以下步骤：