How to add a new column to an existing entity with typeorm

当使用TypeORM进行数据库管理时，向现有的实体添加新列是一种常见的需求。此操作可以通过以下几个步骤完成：

1. 修改实体文件

首先需要在实体的类定义中添加新的列。假设我们有一个名为User的实体，并且我们想要为这个实体添加一个名为email的新列。我们可以在User实体类中添加一个新的属性，并使用装饰器@Column()来标记它：

typescript
import { Entity, PrimaryGeneratedColumn, Column } from "typeorm";

@Entity()
export class User {
    @PrimaryGeneratedColumn()
    id: number;

    @Column()
    name: string;

    // 新添加的邮箱列
    @Column({ type: "varchar", length: 200, unique: true, nullable: false })
    email: string;
}

2. 迁移数据库

在开发过程中，当模型发生变化时，为了同步数据库结构，我们需要进行数据库迁移。TypeORM 提供了强大的迁移工具来帮助我们管理数据库结构的变化。

a) 生成迁移文件

首先，你需要生成一个迁移文件，这可以通过 TypeORM CLI 工具完成。假设你已经全局安装了 TypeORM，可以使用以下命令生成迁移文件：

bash
typeorm migration:generate -n AddEmailToUser

这个命令会比较实体和数据库的当前状态，然后生成一个新的迁移文件，这个文件包含了添加email列的SQL语句。

b) 运行迁移

生成迁移文件后，下一步是应用这个迁移到你的数据库。使用下面的命令来运行迁移：

bash
typeorm migration:run

这个命令会执行迁移文件中的 SQL 语句，将新的email列添加到User表中。

3. 更新业务逻辑

添加新列后，你可能还需要更新应用中与用户相关的业务逻辑。例如，如果添加了邮箱地址，你可能需要在用户注册和用户信息更新的功能中加入邮箱地址的处理逻辑。

4. 测试

在完成以上步骤后，确保进行充分的测试来验证新添加的列是否按预期工作，包括：

• 数据库迁移是否成功。
• 应用能否正确读写新列的数据。
• 验证数据完整性和约束（如unique和nullable）是否生效。

通过以上步骤，你可以有效地向TypeORM的现有实体添加新列，并确保应用与数据库的一致性和数据的完整性。在实际操作中，根据项目的具体需求和配置，上述步骤可能会有所不同。