Database Migration

npm run migration:revert

查看遷移狀態

npm run migration:show

遷移檔案結構

import { MigrationInterface, QueryRunner } from 'typeorm';

export class DescriptiveName1234567890 implements MigrationInterface {
    name = 'DescriptiveName1234567890';

    public async up(queryRunner: QueryRunner): Promise<void> {
        // 升級操作
        await queryRunner.query(`ALTER TABLE ...`);
    }

    public async down(queryRunner: QueryRunner): Promise<void> {
        // 回滾操作
        await queryRunner.query(`ALTER TABLE ...`);
    }
}

最佳實踐

1. 命名規範: 使用描述性名稱，如 AddUserEmailIndex
2. 原子性: 每個遷移只做一件事
3. 可回滾: 確保 down() 方法正確實作
4. 測試: 在開發環境先測試遷移
5. 備份: 生產環境執行前先備份資料庫