乐闻世界logo

TypeORM 如何设置索引@Index

前言

在数据库系统中，索引是帮助快速检索数据的一种数据结构。对于使用TypeORM来管理数据库的开发者来说，了解如何在模型中设置索引非常重要。

本教程将记录如何在TypeORM中设置索引。

什么是索引？

索引（Index）是数据库表中一种特殊的数据结构，它能够帮助我们更快地检索表中的数据。理解索引的概念可以想象一本书的目录，它能让你快速找到你想阅读的章节，而不是一页页地翻找。

索引设置方式

在TypeORM中，我们可以通过装饰器（Decorator）来设置索引。主要的装饰器有 @Index和 @Unique。

1. @Index 装饰器

@Index装饰器可以在实体类中的属性上使用，用于为表设置普通索引。

typescript
import { Entity, Index, PrimaryGeneratedColumn, Column } from 'typeorm';

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

  @Index()
  @Column()
  firstName: string;

  @Column()
  lastName: string;

  @Index()
  @Column({ unique: true })
  email: string;
}

在上面的例子中，firstName 和 email 字段上使用了 @Index，这将为这两个字段各自创建索引。

2. 复合索引

如果需要对多个字段同时设置索引，可以在 @Entity装饰器下方使用 @Index并传递一个字段数组。

typescript
@Index(['firstName', 'lastName'])
@Entity()
export class User {
  // ...其他字段
}

这将为 firstName和 lastName字段创建一个复合索引。

3. @Unique 裥饰器

@Unique装饰器用来创建唯一索引，确保字段值的唯一性。

typescript
@Unique(['username'])
@Entity()
export class User {
  // ...其他字段

  @Column()
  username: string;
}

上述代码会为 username字段创建一个唯一索引，保证每个用户的用户名都是不同的。

4. 索引选项

@Index装饰器也可以接收第二个参数，允许你设置额外的索引选项，例如索引名称、是否唯一等。

typescript
@Index('my_custom_index_name', ['email'], { unique: true })
@Entity()
export class User {
  // ...其他字段
}

在这个例子中，我们创建了一个名为 my_custom_index_name的唯一索引，仅包含 email字段。

索引同步方式

当你定义或更新了实体类中的索引，你需要同步数据库以确保这些更改生效。在TypeORM中，通常使用 synchronize选项来自动同步：

typescript
import { createConnection } from 'typeorm';

createConnection({
  // ...其他配置
  synchronize: true, // 慎用: 在开发环境可用，生产环境应通过迁移来管理
});

注意：synchronize选项在生产环境中是不推荐的，因为它可能导致数据丢失。在生产环境中，应该使用迁移（migrations）来管理数据库变更。

结论

TypeORM提供了一种便捷的方式来定义和管理数据库索引。理解如何正确地在你的应用程序中使用索引，将有助于优化性能并保持应用的响应速度。

正确使用索引可以大大提升应用程序的性能，尤其是在数据量大的场景下。但需要注意的是，索引并不是越多越好，不合理的索引会增加写入数据的负担，并占用更多的存储空间。所以，合理设计和使用索引对于数据库性能,调优是至关重要的。

在设计索引时，这里有一些最佳实践供你参考：

  1. 分析查询模式：查看应用程序中常见的查询类型，确定哪些字段经常用于WHERE子句、JOIN操作或作为ORDER BY的一部分。这些字段是创建索引的理想候选者。
  2. 考虑索引的顺序：在复合索引中，字段的顺序很重要。根据查询的频率和过滤能力排序字段。一般来说，高选择性的字段（即有许多不同值的字段）应该放在前面。
  3. 避免过度索引：虽然索引可以加速查询，但每个额外的索引都会增加插入、更新和删除操作的成本，因为索引本身也需要维护。此外，每个索引都会消耗额外的存储空间。
  4. 使用前缀索引：对于VARCHAR等字符串类型的字段，可以通过指定前缀长度来创建索引，这样可以减少索引的大小并提高效率。
  5. 监控性能：引入新索引后，应该监控应用程序的性能，确保索引带来了预期的好处。如果某个索引从未被查询使用过，应该考虑移除它。
  6. 使用分析器：大多数数据库管理系统提供了查询分析器，可以显示查询的执行计划。这些工具对于理解索引如何影响查询性能非常有用。