Étapes pour ajouter une nouvelle colonne avec les migrations séquelles

Dans une mise à jour de ma plateforme de blogs, j'avais besoin d'ajouter une colonne d'images miniatures pour rendre les articles plus attrayants visuellement. Cette mise à jour a accompagné le passage de l'affichage de tous les articles sur une seule page à l'affichage de chacun sur sa propre page, améliorant ainsi la navigation à mesure que le nombre d'articles augmente.

La colonne des vignettes stocke une chaîne représentant un lien vers une image. Cette approche permet de conserver une base de données légère et de séparer les problèmes en gérant le stockage des images ailleurs.

Ajout de la nouvelle colonne au modèle

Pour commencer, j'ai mis à jour le modèle BlogPosts pour inclure la colonne des vignettes. La définition de allowNull : true garantissait que l'ajout d'une vignette était facultatif et évitait les problèmes avec les publications plus anciennes qui n'avaient pas encore de vignette :

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

Cependant, ce changement de modèle à lui seul n’était pas suffisant. La base de données Postgres n'a pas reconnu la nouvelle colonne et j'ai rencontré l'erreur :

erreur : la colonne "vignette" n'existe pas

Cela se produit parce que les modèles Sequelize définissent la manière dont l'application interagit avec la base de données, mais ils ne modifient pas automatiquement le schéma de la base de données. Pour résoudre ce problème, je devais utiliser une migration Sequelize.

Préparation de Sequelize pour les migrations

Avant de créer la migration, je me suis assuré que la CLI Sequelize était initialisée dans le projet. Avant d'exécuter la commande suivante, qui créera un dossier config/ et la configuration associée, assurez-vous de l'installer d'abord en entrant npm install sequelize-cli

npx sequelize-cli init

Dans le dossier config/, j'ai choisi d'utiliser un fichier config.js au lieu de config.json. Cela m'a permis d'utiliser des variables d'environnement avec dotenv pour la configuration :

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",
   },
};

J'ai ensuite supprimé le fichier config.json pour éviter les conflits.

Génération du fichier de migration

Ensuite, j'ai créé le fichier de migration pour ajouter la colonne de vignettes à l'aide de la commande suivante :

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

Cela a créé un nouveau fichier dans le dossier migrations/, nommé quelque chose comme :

20241206232526-ajouter-une miniature-aux-blogposts.js

J'ai modifié ce fichier pour ajouter la nouvelle colonne :

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

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

Appliquer la migration

Pour mettre à jour la base de données de développement, j'ai exécuté la commande suivante :

npx sequelize-cli db:migrate

Cela a ajouté avec succès la colonne des vignettes au tableau des articles de blog, ce qui m'a permis de stocker des liens d'images pour chaque article.

Appliquer la migration en production

Pour la version déployée de la base de données, j'ai suivi ces étapes :

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

Cela a ajouté avec succès la colonne des vignettes à la base de données Postgres de production.

Conclusion

L'ajout de la colonne des vignettes a permis d'afficher des images pour chaque article de blog, améliorant ainsi l'attrait visuel et la convivialité de la plateforme. Ces étapes fournissent une approche structurée et reproductible pour ajouter de nouvelles colonnes à la base de données à l'aide des migrations Sequelize, ce qui est essentiel pour maintenir la synchronisation entre les modèles et la base de données.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!