Преобразует данные JSON в класс сущности TypeORM: класс @Entity() с первичным ключом, где каждый остальной ключ становится свойством @Column() с типом TypeScript, признаком nullable и декоратором class-validator.
Используйте, чтобы создать первую сущность для TypeOrmModule.forFeature([...]) в приложении на NestJS + TypeORM или когда добавляете DataSource TypeORM в проект на Express и нужны сущности, совпадающие с уже имеющимися данными.
Имя модели (по умолчанию MyModel); support ticket превращается в SupportTicket.support-ticket.entity.ts и добавьте в массив entities вашего DataSource или в TypeOrmModule.forFeature([SupportTicket]) в модуле NestJS.[
{ "subject": "Login fails on Safari", "priority": 2, "assignee": "jdoe", "closed": false, "opened_at": "2024-06-03T08:12:00Z" },
{ "subject": "Export CSV is empty", "priority": 1, "closed": true, "opened_at": "2024-06-04T14:40:00Z" }
]import { Entity, PrimaryGeneratedColumn, Column } from 'typeorm';
import { IsNotEmpty, IsOptional } from 'class-validator';
@Entity()
export class SupportTicket {
@PrimaryGeneratedColumn()
id: number;
@Column()
@IsNotEmpty()
subject: string;
@Column()
@IsNotEmpty()
priority: number;
@Column({ nullable: true })
@IsOptional()
assignee: string | null;
@Column()
@IsNotEmpty()
closed: boolean;
@Column({ name: 'opened_at' })
@IsNotEmpty()
openedAt: Date;
}У второго тикета нет assignee, поэтому эта колонка — @Column({ nullable: true }) с типом string | null. opened_at стал свойством openedAt типа Date, а name: 'opened_at' сохраняет исходное имя колонки.
id или целочисленный id → @PrimaryGeneratedColumn() id: number; id за пределами 32-битного диапазона → @PrimaryGeneratedColumn({ type: 'bigint' }) id: string; строковый id, например UUID → @PrimaryColumn() id: string.@Column() по умолчанию, дробные получают type: 'double precision', чтобы дробная часть не обрезалась, колонки bigint и date (только дата) типизируются как string (TypeORM возвращает их текстом), дата-время — Date.simple-json с типом Record<string, unknown> или типизированным массивом вроде string[]."007" остаются колонками string.@Column({ name: 'opened_at' }) добавляется всякий раз, когда ключ JSON отличается.null или отсутствовали, получают nullable: true, | null и @IsOptional(); остальные — @IsNotEmpty().Замените пустой ticket.entity.ts, созданный nest g resource tickets, этим выводом; тогда сущность совпадёт с mock-данными, которые фронтенд уже использовал, и Repository<SupportTicket> готов к работе.
После создания сущности typeorm migration:generate сравнивает её с базой данных и пишет миграцию CREATE TABLE, включая имена колонок и nullability.
simple-json хранит JSON как текст, поэтому фильтровать по значениям внутри нельзя. Если нужны запросы по ним, переключитесь на type: 'jsonb' в PostgreSQL или на type: 'json' в MySQL.double precision — тип с плавающей точкой; для цен используйте @Column('decimal', { precision: 10, scale: 2 }), который TypeORM возвращает строкой.@ManyToOne или @OneToMany.У @Entity() нет имени, поэтому стратегия именования TypeORM по умолчанию переводит имя класса в snake_case: support_ticket. Для существующей таблицы передайте имя, например @Entity('tickets').
emitDecoratorMetadata выключен?@Column() без опций читает тип из reflection-метаданных, так что TypeORM упадёт с ошибкой типа данных. Включите опцию в tsconfig или укажите каждый тип явно, например @Column('varchar').
Date?datetime в MySQL и timestamp without time zone в PostgreSQL. Если в PostgreSQL важны часовые пояса, переключитесь на @Column('timestamptz').