TypeORM のメリットとデメリットは何ですか？

Question

IT Interview Practice · Accepted Answer

**TypeORM** は Node.js 向けの TypeScript ファーストな ORM です。decorator に頼ってクラスをテーブルにマッピングし、**Active Record** と **Data Mapper** の両パターンをサポートします。最大の魅力は TypeScript との深い統合であり、最大のリスクはクエリ層の粗さと、むらのあるメンテナンス履歴です。

## メリット

- **TypeScript ネイティブ。** エンティティは decorator 付きクラスなので、モデル・リレーション・（注意すれば）クエリまで端から端まで型付けされます。
- **2 つのパターン。** 小規模アプリには Active Record（`user.save()`）を、テスト可能で疎結合なコードには Data Mapper（`repository.save(user)`）を使えます。
- **decorator 駆動のスキーマ。** カラム、リレーション、インデックス、cascade をエンティティ上にインラインで宣言します。

```ts
@Entity()
class User {
  @PrimaryGeneratedColumn() id: number;
  @Column({ unique: true }) email: string;
  @OneToMany(() => Post, (p) => p.author) posts: Post[];
}

const users = await dataSource
  .getRepository(User)
  .find({ where: { email: "a@b.com" }, relations: { posts: true } });
```

- スキーマの進化のための **migration と CLI**、そして複雑な SQL のための流麗な **QueryBuilder**。
- Postgres、MySQL、SQLite、SQL Server などで動作します。

## デメリット

- **クエリの端で型安全性が漏れる。** `find` のオプションや QueryBuilder は部分的にしか型付けされず、カラム名の誤りはコンパイル時ではなく実行時に失敗することが多いです。
- **複雑なクエリが扱いにくくなる。** 深い join、サブクエリ、集約はしばしば生の SQL に押し戻されます。
- **メンテナンスと安定性。** プロジェクトには停滞期やバージョン間の破壊的変更があり、一部のバグは長く残ります。
- **migration の摩擦。** 自動生成された migration はノイズが多く、手で編集する必要があることがあります。
- **lazy リレーションと性能の地雷** — リレーションを意図的にロードしないと N+1 クエリを簡単に引き起こします。

## 適する場面

新規（greenfield）の TypeScript バックエンド（**NestJS** と自然に組み合わさります）、decorator ベースのモデルを重んじ型付きエンティティを求めるチーム、そしてクエリがほぼ CRUD で時折 QueryBuilder を使うアプリ。

## なぜ重要なのか

ORM を選ぶことは、あらゆる機能がどのようにデータベースに触れるかを形づくる長期的なコミットメントです。TypeORM の TypeScript ファーストな設計は型付きコードベースにとって本物の生産性の利点ですが、面接官はあなたがその限界——部分的なクエリ型付け、複雑なクエリの痛み、でこぼこなリリース履歴——も理解していることを聞きたがります。それにより、hype で採用するのではなく、いつその使い勝手が粗さを上回るかを判断できるからです。

メリット

デメリット

適する場面

なぜ重要なのか

関連する質問