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

在文章实战开发的过程中，我们经常会遇到一些这样那样的问题，然后要卡好半天，等问题解决了才发现原来一些细节知识点还是没有掌握好。今天golang学习网就整理分享《使用 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 表中。

生产环境迁移

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

1. 备份生产数据库: 在进行任何更改之前，我备份了生产数据库。
2. 复制迁移文件: 确保更新后的 config.js 和 add-thumbnail-to-blogposts.js 文件已上传到生产服务器的代码库。
3. 设置环境变量: 验证 dotenv 需要的生产环境变量已正确配置（例如，在 cPanel 的设置中）。
4. 运行迁移: 在生产环境终端中，导航到后端应用目录并运行：

npx sequelize-cli db:migrate --env production

这成功地将 thumbnail 列添加到生产 PostgreSQL 数据库中。

总结

通过添加缩略图列，博客文章的显示更加生动直观，提升了用户体验。 本指南提供了一个清晰的步骤，展示如何使用 Sequelize 迁移安全地向数据库添加新列，保持模型和数据库架构的一致性。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《使用 Sequelize 迁移添加新列的步骤》文章吧，也可关注golang学习网公众号了解相关技术文章。