JSON কে TypeORM সমাধানে রূপান্তর করুন!

JSON ইনপুট করুন এবং এটিকে TypeORM সমাধানে রূপান্তর করুন! TypeORM @Entity, @PrimaryGeneratedColumn, @Column, NestJS সমর্থিত।
JSON
ফলাফল
 

JSON কে TypeORM সমাধানে রূপান্তর করুন!

JSON ডেটাকে TypeORM entity ক্লাসে কনভার্ট করে: primary key-সহ একটি @Entity() ক্লাস, আর বাকি প্রতিটি key TypeScript type, nullability ও একটি class-validator decorator-সহ একটি @Column() প্রপার্টি।

NestJS + TypeORM অ্যাপে TypeOrmModule.forFeature([...])-এর জন্য প্রথম entity তৈরি করতে, অথবা Express প্রজেক্টে TypeORM DataSource যোগ করার সময় আপনার কাছে থাকা ডেটার সাথে মেলে এমন entity দরকার হলে এটি ব্যবহার করুন।

কীভাবে ব্যবহার করবেন

  1. সংরক্ষণ করার রেকর্ড অবজেক্ট হিসেবে, বা কয়েকটি রেকর্ড array হিসেবে পেস্ট করুন। কিছু রেকর্ডে না থাকা ফিল্ড nullable কলাম হয়।
  2. মডেলের নাম-এ entity ক্লাসের নাম দিন (ডিফল্ট MyModel); support ticket হয় SupportTicket।
  3. এটি support-ticket.entity.ts হিসেবে সেভ করে আপনার DataSource-এর entities array-তে বা NestJS মডিউলের TypeOrmModule.forFeature([SupportTicket])-এ যোগ করুন।

উদাহরণ

ইনপুট (JSON)
[
  { "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" }
]
আউটপুট (TypeORM)
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 নেই, তাই সেই কলামটি string | null type-সহ @Column({ nullable: true })। opened_at হয়েছে Date type-এর openedAt প্রপার্টি, আর name: 'opened_at' মূল কলামের নাম রেখে দেয়।

সমর্থিত বৈশিষ্ট্য

  • আপনার ডেটা থেকে primary key: id key না থাকলে বা integer id হলে → @PrimaryGeneratedColumn() id: number; 32-বিট সীমার বেশি id → @PrimaryGeneratedColumn({ type: 'bigint' }) id: string; UUID-এর মতো স্ট্রিং id → @PrimaryColumn() id: string।
  • কলামের type: integer ডিফল্ট @Column() ব্যবহার করে, দশমিক পায় type: 'double precision' যাতে ভগ্নাংশ কেটে না যায়, bigint আর শুধু-তারিখের date কলামের type string (TypeORM এগুলো টেক্সট হিসেবে ফেরত দেয়), date-time হয় Date।
  • অবজেক্ট আর array হয় Record<string, unknown> বা string[]-এর মতো টাইপড array type-এর simple-json কলাম।
  • "007"-এর মতো কোটের ভেতরের সংখ্যা string কলাম থাকে।
  • প্রপার্টি camelCase; JSON key আলাদা হলেই @Column({ name: 'opened_at' }) যোগ হয়।
  • null বা অনুপস্থিত ফিল্ড পায় nullable: true, | null আর @IsOptional(); বাকিগুলো পায় @IsNotEmpty()।

ব্যবহারের ক্ষেত্র

`nest g resource`-এর ঠিক পরে entity পূরণ করা

nest g resource tickets-এর তৈরি ফাঁকা ticket.entity.ts-কে এই আউটপুট দিয়ে বদলে দিন; তাহলে entity-টি ফ্রন্টএন্ড আগে থেকে যে mock ডেটা ব্যবহার করছিল তার সাথে মেলে, আর Repository<SupportTicket> ব্যবহারের জন্য প্রস্তুত।

জেনারেট করা migration-এর শুরুর বিন্দু

Entity তৈরির পর typeorm migration:generate সেটিকে ডাটাবেসের সাথে তুলনা করে কলামের নাম আর nullability-সহ CREATE TABLE migration লেখে।

নোট ও সীমাবদ্ধতা

  • simple-json JSON-কে টেক্সট হিসেবে রাখে, তাই এর ভেতরের ভ্যালু দিয়ে filter করা যায় না। কোয়েরি করতে হলে PostgreSQL-এ type: 'jsonb', MySQL-এ type: 'json'-এ বদলান।
  • double precision একটি floating-point type; দামের জন্য @Column('decimal', { precision: 10, scale: 2 }) ব্যবহার করুন, যা TypeORM স্ট্রিং হিসেবে ফেরত দেয়।
  • Relation অনুমান করা হয় না। যেসব nested অবজেক্ট আসলে অন্য entity, সেগুলো @ManyToOne বা @OneToMany relation হওয়া উচিত।

সাধারণ প্রশ্ন

Entity কোন টেবিলের নামে ম্যাপ হয়?

@Entity()-এ কোনো নাম নেই, তাই TypeORM-এর ডিফল্ট নামকরণ ক্লাসের নামকে snake_case-এ বদলায়: support_ticket। বিদ্যমান টেবিলের জন্য নামটি দিন, যেমন @Entity('tickets')।

emitDecoratorMetadata বন্ধ থাকলে কী হয়?

অপশন ছাড়া @Column() reflection metadata থেকে তার type পড়ে, তাই TypeORM data type error দিয়ে ব্যর্থ হয়। tsconfig-এ এটি চালু করুন বা প্রতিটি type উল্লেখ করুন, যেমন @Column('varchar')।

Date প্রপার্টি কোন ডাটাবেস type পায়?

MySQL-এ datetime আর PostgreSQL-এ timestamp without time zone। PostgreSQL-এ time zone গুরুত্বপূর্ণ হলে @Column('timestamptz')-এ বদলান।