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

在我的博客平台的更新中，我需要添加缩略图列以使文章更具视觉吸引力。此更新伴随着从在单个页面上显示所有文章到在自己的页面上显示每一篇文章的转变，随着文章数量的增长改进了导航。

缩略图列存储表示图像链接的字符串。这种方法使数据库保持轻量级，并通过在其他地方处理图像存储来分离关注点。

将新列添加到模型中

首先，我更新了 BlogPosts 模型以包含缩略图列。设置allowNull: true确保添加缩略图是可选的，并避免了尚未有缩略图的旧帖子的问题：

thumbnail: {
    type: DataTypes.STRING,
    allowNull: true, // Optional for older posts
    },

但是，仅对模型进行这种更改还不够。 Postgres 数据库无法识别新列，我遇到了错误：

错误：“缩略图”列不存在

发生这种情况是因为 Sequelize 模型定义了应用程序与数据库的交互方式，但它们不会自动修改数据库架构。为了解决这个问题，我需要使用 Sequelize 迁移。

准备 Sequelize 进行迁移

在创建迁移之前，我确保 Sequelize CLI 已在项目中初始化。在运行以下命令（这将创建 config/ 文件夹和相关设置）之前，请务必先输入 npm installsequelize-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 迁移：生成 --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

这成功地将缩略图列添加到博客文章表中，使我能够存储每篇文章的图像链接。

在生产中应用迁移

对于数据库的部署版本，我按照以下步骤操作：

Backup the Production Database: Before making changes, I downloaded a backup to safeguard against misconfigurations.
Copy the Migration Files: I ensured the updated config.js file and add-thumbnail-to-blogposts.js migration file were present in the server repository.
Set Environment Variables: I verified that the production environment variables required by dotenv were configured correctly. These were set in the Setup Node.js App section of cPanel.
Run the Migration: I navigated to the backend app directory in the production terminal and ran:

npx Sequelize-cli db:migrate --env production

这成功地将缩略图列添加到生产 Postgres 数据库。

结论

添加缩略图列可以显示每篇博客文章的图像，增强了平台的视觉吸引力和可用性。这些步骤提供了一种结构化且可重复的方法，用于使用 Sequelize 迁移向数据库添加新列，这对于维持模型和数据库之间的同步至关重要。

以上是使用 Sequelize 迁移添加新列的步骤的详细内容。更多信息请关注PHP中文网其他相关文章！