多文档表元数据统一管理的SQL最优数据库设计方案咨询

针对你当前的场景（10-20个独立文档表、需统一元数据、使用TypeORM），以下是两种经过验证的最优设计方案，可根据业务需求选择：

方案1：单表继承（TPH，Table Per Hierarchy） #

这是TypeORM原生支持的轻量化继承策略，适合追求操作简便、不在意少量NULL字段的场景。

设计思路 #

将所有文档的统一元数据和各类型专属字段合并到同一张主表，用docType字段区分文档类型，专属字段允许为NULL。

表结构示例 #

CREATE TABLE Document (
  docId INT PRIMARY KEY AUTO_INCREMENT,
  status INT NOT NULL,
  docType INT NOT NULL, -- 用数值标记类型：1=车辆文档，2=员工文档...
  -- 车辆文档专属字段
  carName VARCHAR(255) NULL,
  carMake VARCHAR(255) NULL,
  -- 员工文档专属字段
  empName VARCHAR(255) NULL,
  empAge INT NULL
);

TypeORM实现 #

通过基类+子类的继承结构，TypeORM会自动处理类型区分和数据存储：

import { Entity, PrimaryGeneratedColumn, Column, DiscriminatorColumn, DiscriminatorValue } from "typeorm";

@Entity()
@DiscriminatorColumn({ name: "docType", type: "int" })
export abstract class Document {
  @PrimaryGeneratedColumn()
  docId: number;

  @Column()
  status: number;
}

@Entity()
@DiscriminatorValue("1")
export class CarDocument extends Document {
  @Column({ nullable: true })
  carName: string;

  @Column({ nullable: true })
  carMake: string;
}

@Entity()
@DiscriminatorValue("2")
export class EmployeeDocument extends Document {
  @Column({ nullable: true })
  empName: string;

  @Column({ nullable: true })
  empAge: number;
}

优缺点 #

• 优势：创建文档只需一次插入操作，无需分步处理；元数据与业务数据同表，避免关联查询；TypeORM完全封装，无需手动维护关联。
• 劣势：表字段会随文档类型增加而膨胀，存在大量NULL字段；若不同类型有重名字段（如name），需重命名区分。

方案2：类表继承（TPT，Table Per Type） #

这是你当前方案的优化版，适合需要严格字段隔离、避免NULL冗余的场景，TypeORM的级联操作可解决分步插入的繁琐问题。

设计思路 #

保留主表存储统一元数据，各子表仅存储对应类型的专属字段，子表主键同时作为主表的外键。通过TypeORM的级联配置，实现一次保存自动插入主表和子表。

表结构示例 #

主表（可重命名为Document，替代原RegisterTable）：

CREATE TABLE Document (
  docId INT PRIMARY KEY AUTO_INCREMENT,
  status INT NOT NULL,
  docType INT NOT NULL
);

车辆文档表：

CREATE TABLE CarDocument (
  docId INT PRIMARY KEY,
  name VARCHAR(255) NOT NULL,
  carMake VARCHAR(255) NOT NULL,
  FOREIGN KEY (docId) REFERENCES Document(docId)
);

员工文档表：

CREATE TABLE EmployeeDocument (
  docId INT PRIMARY KEY,
  name VARCHAR(255) NOT NULL,
  age INT NOT NULL,
  FOREIGN KEY (docId) REFERENCES Document(docId)
);

TypeORM实现 #

通过@OneToOne关联+级联配置，简化创建流程：

import { Entity, PrimaryGeneratedColumn, Column, OneToOne, JoinColumn } from "typeorm";

@Entity()
export class Document {
  @PrimaryGeneratedColumn()
  docId: number;

  @Column()
  status: number;

  @Column()
  docType: number;
}

@Entity()
export class CarDocument {
  @PrimaryColumn()
  docId: number;

  @OneToOne(() => Document, { cascade: true })
  @JoinColumn({ name: "docId" })
  document: Document;

  @Column()
  name: string;

  @Column()
  carMake: string;
}

创建文档时只需保存子类实例，TypeORM自动完成主表+子表的插入：

const carDoc = new CarDocument();
carDoc.document = new Document();
carDoc.document.status = 1;
carDoc.document.docType = 1;
carDoc.name = "车辆登记证";
carDoc.carMake = "丰田";

await repository.save(carDoc);

优缺点 #

• 优势：字段隔离清晰，无冗余NULL；主表仅存必要元数据，避免冗余；级联操作彻底解决分步插入的繁琐问题。
• 劣势：查询时需关联主表和子表，但TypeORM可通过relations参数自动处理，在10-20个表的规模下性能影响可忽略。

最终推荐 #

• 若追求开发效率、不在意少量NULL字段，优先选择单表继承（TPH）；
• 若需要严格的数据隔离、避免字段膨胀，选择类表继承（TPT）。

内容的提问来源于stack exchange，提问作者Jordan Walker