Sequelize 마이그레이션을 통해 새 열을 추가하는 단계

내 블로그 플랫폼 업데이트에서 기사를 시각적으로 더 매력적으로 만들기 위해 썸네일 이미지 열을 추가해야 했습니다. 이번 업데이트에서는 단일 페이지에 모든 기사를 표시하는 방식에서 각 기사를 자체 페이지에 표시하는 방식으로 전환하여 기사 수가 늘어남에 따라 탐색 기능이 향상되었습니다.

썸네일 열에는 이미지 링크를 나타내는 문자열이 저장됩니다. 이 접근 방식은 데이터베이스를 가볍게 유지하고 이미지 저장을 다른 곳에서 처리하여 우려 사항을 분리합니다.

모델에 새 기둥 추가

먼저 썸네일 열을 포함하도록 BlogPosts 모델을 업데이트했습니다. AllowNull: true로 설정하면 썸네일 추가가 선택 사항이고 아직 썸네일이 없는 이전 게시물과 관련된 문제를 방지할 수 있습니다.

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

그러나 이번 모델 변경만으로는 부족했습니다. Postgres 데이터베이스가 새 열을 인식하지 못해 다음 오류가 발생했습니다.

오류: "썸네일" 열이 존재하지 않습니다

이는 Sequelize 모델이 애플리케이션이 데이터베이스와 상호 작용하는 방식을 정의하지만 데이터베이스 스키마를 자동으로 수정하지는 않기 때문에 발생합니다. 이 문제를 해결하려면 Sequelize 마이그레이션을 사용해야 했습니다.

마이그레이션을 위한 Sequize 준비

마이그레이션을 생성하기 전에 프로젝트에서 Sequelize CLI가 초기화되었는지 확인했습니다. config/ 폴더 및 관련 설정을 생성하는 다음 명령을 실행하기 전에 먼저 npm installsequelize-cli

를 입력하여 설치해야 합니다.

npx 연속화-cli 초기화

config/ 폴더 내에서 config.json 대신 config.js 파일을 사용하기로 결정했습니다. 이를 통해 구성을 위해 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 squad-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 연속화-cli db:마이그레이션

블로그 포스트 테이블에 썸네일 열이 성공적으로 추가되어 각 기사에 대한 이미지 링크를 저장할 수 있게 되었습니다.

프로덕션에 마이그레이션 적용

배포된 데이터베이스 버전의 경우 다음 단계를 따랐습니다.

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 serialize-cli db: migration --env 프로덕션

이렇게 하면 프로덕션 Postgres 데이터베이스에 썸네일 열이 성공적으로 추가되었습니다.

결론

썸네일 열을 추가하면 각 블로그 기사의 이미지를 표시할 수 있어 플랫폼의 시각적 매력과 유용성이 향상되었습니다. 이러한 단계는 모델과 데이터베이스 간의 동기화를 유지하는 데 중요한 Sequelize 마이그레이션을 사용하여 데이터베이스에 새 열을 추가하는 구조적이고 반복 가능한 접근 방식을 제공합니다.

위 내용은 Sequelize 마이그레이션을 통해 새 열을 추가하는 단계의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!