从 Sequelize 迁移到 TypeORM

非官方测试版翻译

本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。发现错误？报告问题 →

配置数据源

在 Sequelize 中创建数据源的方式如下：

const sequelize = new Sequelize("database", "username", "password", {
    host: "localhost",
    dialect: "mysql",
})

sequelize
    .authenticate()
    .then(() => {
        console.log("Data Source has been initialized successfully.")
    })
    .catch((err) => {
        console.error("Error during Data Source initialization:", err)
    })

在 TypeORM 中创建数据源的方式如下：

import { DataSource } from "typeorm"

const dataSource = new DataSource({
    type: "mysql",
    host: "localhost",
    username: "username",
    password: "password",
})

dataSource
    .initialize()
    .then(() => {
        console.log("Data Source has been initialized successfully.")
    })
    .catch((err) => {
        console.error("Error during Data Source initialization:", err)
    })

之后你可以在应用任意位置使用 dataSource 实例

了解更多关于数据源的内容

模式同步

在 Sequelize 中执行模式同步的方式如下：

Project.sync({ force: true })
Task.sync({ force: true })

在 TypeORM 中只需在数据源配置中添加 synchronize: true：

const dataSource = new DataSource({
    type: "mysql",
    host: "localhost",
    username: "username",
    password: "password",
    synchronize: true,
})

创建模型

Sequelize 中定义模型的方式如下：

module.exports = function (sequelize, DataTypes) {
    const Project = sequelize.define("project", {
        title: DataTypes.STRING,
        description: DataTypes.TEXT,
    })

    return Project
}

module.exports = function (sequelize, DataTypes) {
    const Task = sequelize.define("task", {
        title: DataTypes.STRING,
        description: DataTypes.TEXT,
        deadline: DataTypes.DATE,
    })

    return Task
}

在 TypeORM 中这些模型称为实体，定义方式如下：

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

@Entity()
export class Project {
    @PrimaryGeneratedColumn()
    id: number

    @Column()
    title: string

    @Column()
    description: string
}

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

@Entity()
export class Task {
    @PrimaryGeneratedColumn()
    id: number

    @Column()
    title: string

    @Column("text")
    description: string

    @Column()
    deadline: Date
}

强烈建议每个实体类单独存放在一个文件中。 TypeORM 允许你将类作为数据库模型使用，并通过声明式语法定义模型的哪些部分会映射为数据库表。 TypeScript 的强大功能让你可以在类中使用类型提示等特性。

了解更多关于实体与列的内容

其他模型配置

Sequelize 中的以下配置：

flag: { type: Sequelize.BOOLEAN, allowNull: true, defaultValue: true },

在 TypeORM 中可这样实现：

@Column({ nullable: true, default: true })
flag: boolean;

Sequelize 中的以下配置：

flag: { type: Sequelize.DATE, defaultValue: Sequelize.NOW }

在 TypeORM 中可这样编写：

@Column({ default: () => "NOW()" })
myDate: Date;

Sequelize 中的以下配置：

someUnique: { type: Sequelize.STRING, unique: true },

在 TypeORM 中可这样实现：

@Column({ unique: true })
someUnique: string;

Sequelize 中的以下配置：

fieldWithUnderscores: { type: Sequelize.STRING, field: "field_with_underscores" },

在 TypeORM 中对应为：

@Column({ name: "field_with_underscores" })
fieldWithUnderscores: string;

Sequelize 中的以下配置：

incrementMe: { type: Sequelize.INTEGER, autoIncrement: true },

在 TypeORM 中可这样实现：

@Column()
@Generated()
incrementMe: number;

Sequelize 中的以下配置：

identifier: { type: Sequelize.STRING, primaryKey: true },

在 TypeORM 中可这样实现：

@Column({ primary: true })
identifier: string;

要创建类似 createDate 和 updateDate 的列，需要在实体中定义两个列（可自定义名称）：

@CreateDateColumn();
createDate: Date;

@UpdateDateColumn();
updateDate: Date;

模型操作

在 Sequelize 中创建并保存新模型的方式：

const employee = await Employee.create({
    name: "John Doe",
    title: "senior engineer",
})

在 TypeORM 中有多种创建并保存新模型的方式：

const employee = new Employee() // you can use constructor parameters as well
employee.name = "John Doe"
employee.title = "senior engineer"
await dataSource.getRepository(Employee).save(employee)

或使用 Active Record 模式：

const employee = Employee.create({ name: "John Doe", title: "senior engineer" })
await employee.save()

如需从数据库加载现有实体并替换部分属性，可使用以下方法：

const employee = await Employee.preload({ id: 1, name: "John Doe" })

了解更多关于 Active Record 与 Data Mapper 和 Repository API 的内容。

在 Sequelize 中访问属性的方式：

console.log(employee.get("name"))

在 TypeORM 中只需：

console.log(employee.name)

在 Sequelize 中创建索引的方式：

sequelize.define(
    "user",
    {},
    {
        indexes: [
            {
                unique: true,
                fields: ["firstName", "lastName"],
            },
        ],
    },
)

在 TypeORM 中的实现：

@Entity()
@Index(["firstName", "lastName"], { unique: true })
export class User {}

了解更多关于索引的内容

配置数据源​

模式同步​

创建模型​

其他模型配置​

模型操作​

配置数据源

模式同步

创建模型

其他模型配置

模型操作