为了提升博客平台的视觉效果和用户体验，我添加了一个缩略图列到数据库中，以便在每个文章页面显示文章缩略图。此更新与博客文章显示方式的改变相辅相成：从在一个页面显示所有文章，转变为每个文章拥有独立页面，从而改善了文章数量增多后的导航体验。
缩略图列存储图像链接字符串，这种方式保持了数据库的轻量级，并通过将图像存储处理与数据库分离，实现了关注点分离。
模型更新与迁移
首先，我更新了 blogposts 模型，添加了 thumbnail 列：
1
2
3
4
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 加载环境变量：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
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 文件避免冲突。
生成迁移文件
接下来，我使用以下命令生成迁移文件：
这会在 migrations/ 文件夹中创建一个名为 20241206232526-add-thumbnail-to-blogposts.js 的文件（时间戳可能不同）。我修改了此文件：
1
2
3
4
5
6
7
8
9
10
11
12
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 表中。
生产环境迁移
在生产环境中，我遵循以下步骤：
备份生产数据库: 在进行任何更改之前，我备份了生产数据库。 复制迁移文件: 确保更新后的 config.js 和 add-thumbnail-to-blogposts.js 文件已上传到生产服务器的代码库。 设置环境变量: 验证 dotenv 需要的生产环境变量已正确配置（例如，在 cPanel 的设置中）。 运行迁移: 在生产环境终端中，导航到后端应用目录并运行：npx sequelize-cli db:migrate --env production
这成功地将 thumbnail 列添加到生产 PostgreSQL 数据库中。
总结
通过添加缩略图列，博客文章的显示更加生动直观，提升了用户体验。 本指南提供了一个清晰的步骤，展示如何使用 Sequelize 迁移安全地向数据库添加新列，保持模型和数据库架构的一致性。
以上就是使用 Sequelize 迁移添加新列的步骤的详细内容，更多请关注php中文网其它相关文章！