ORM 模型生成

在筑表师中生成 ORM 模型。还没有表结构时，先按快速开始建表，或导入已有 SQL。涉及跨表引用时，先核对外键配置与 ER 图。

SQLite / D1 目前提供 Drizzle 输出，跨表外键请使用整组导出。类型映射与初始化限制见查询设计与业务建模。

本指南介绍如何使用筑表师将表结构一键转换为主流 ORM 框架的模型代码，打通数据库设计到后端工程开发的最后一公里。

示例：将 MySQL 用户表转换为 Prisma 模型

本例只生成一张表的模型，不包含跨表关系。打开筑表师，选择 MySQL，按SQL 导入步骤导入以下结构：

sql

CREATE TABLE users (
  id INT NOT NULL,
  name VARCHAR(100) NOT NULL,
  PRIMARY KEY (id ASC)
);

选中 users，切换右侧 ORM 标签，选择 Prisma。生成结果如下（对齐空格可能不同）：

prisma

model Users {
  id             Int        @id
  name           String
  @@map("users")
}

id 的主键约束映射为 @id，name 映射为必填的 String，@@map("users") 保留数据库表名。本例没有自增或默认值，插入记录时需要提供 id 和 name。

这是模型片段，使用前还需在自己的 Prisma 项目中配置 MySQL 数据源和客户端生成器，再校验模型并按项目流程生成客户端或迁移。生成模型不会连接或修改数据库。需要建模用户与订单的关联时，继续阅读外键配置与 ER 图。

适用于在表结构设计完成后，无需手动编写重复繁琐的模型类与注解，直接生成类型完备、映射精准的代码并无缝粘贴至项目工程中。

点击面板中的复制ORM按钮，一键将生成代码存入剪贴板，直接粘贴到项目的实体/模型文件中即可。

ORM 框架	文件格式	典型类型与注解映射
Prisma	`.prisma` schema	`@id`, `@default()`, `@map()`, `@unique`, `@@index`, `@@schema`
TypeORM	TypeScript 实体类	`@Entity()`, `@PrimaryGeneratedColumn()`, `@Column({ type, precision })`, `@Index()`
SQLAlchemy	Python 类（Declarative）	`Column()`, `Integer()`, `String()`, `DECIMAL()`, `__table_args__`
GORM	Go 结构体	`gorm.Model`, `gorm:"column:xxx;type:xxx;primaryKey;uniqueIndex"`
JPA	Java 实体类	`@Entity`, `@Table(name, schema)`, `@Id`, `@Column(name, nullable)`, `@Index`

类型安全与精度防丢失

大整数与高精度小数：TypeORM 映射中，bigint 及精确小数（decimal/numeric）默认映射为 string 属性类型，防止 JavaScript 原生 Number 浮点数精度溢出。
Schema 命名空间：
- Prisma：在 PostgreSQL/SQL Server 下自动生成 @@schema("schemaName")。
- SQLAlchemy：在 __table_args__ 中声明 schema='schemaName'。
- JPA：在 @Table(schema = "schemaName") 中指定命名空间。
- GORM：直接生成带有限定名的 TableName() 绑定方法。