PostgreSQLPrismaTypeScriptDatabase

การออกแบบ Database Schema ด้วย Prisma และ PostgreSQL ให้รองรับการขยายตัว

Designing Scalable PostgreSQL Schemas with Prisma ORM in TypeScript

ผู้เขียน: ปฏิภาณ พลยิ่ง (Patipan Plonying)···อ่านประมาณ 5 นาที

หลักการออกแบบ Schema ที่ชัดเจนและตรวจสอบได้ตั้งแต่ตอนเขียนโค้ด

ข้อดีสำคัญของการใช้ Prisma คู่กับ PostgreSQL ในโปรเจกต์ TypeScript คือการที่ Schema ของฐานข้อมูลกลายเป็นแหล่งความจริงเดียว (Single Source of Truth) ที่สร้าง Type ให้โค้ดฝั่ง Backend อัตโนมัติ ลดความผิดพลาดจากการพิมพ์ชื่อคอลัมน์ผิดหรือการแปลงชนิดข้อมูลไม่ตรงกัน

จากการทำงานจริงของ ปฏิภาณ พลยิ่ง (Patipan Plonying) สิ่งที่ควรกำหนดตั้งแต่วันแรกคือการใส่เวลาสร้างและแก้ไข (`createdAt`, `updatedAt`), การใช้ Enum สำหรับสถานะที่มีขอบเขตชัดเจน และการสร้าง Composite Index ในคอลัมน์ที่ใช้กรองและเรียงลำดับข้อมูลบ่อยๆ

prisma/schema.prismaprisma
datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}

generator client {
  provider = "prisma-client-js"
}

enum InquiryStatus {
  PENDING
  REPLIED
  ARCHIVED
}

model ContactInquiry {
  id        String        @id @default(cuid())
  name      String
  email     String
  message   String        @db.Text
  status    InquiryStatus @default(PENDING)
  createdAt DateTime      @default(now()) @map("created_at")
  updatedAt DateTime      @updatedAt @map("updated_at")

  @@index([status, createdAt(sort: Desc)])
  @@map("contact_inquiries")
}

การป้องกันปัญหา Connection เต็มในสภาพแวดล้อม Next.js

ในระหว่างการพัฒนาด้วย Next.js ระบบ Hot Reload อาจสร้างอินสแตนซ์ของ PrismaClient ซ้ำซ้อนทุกครั้งที่บันทึกไฟล์จนทำให้ PostgreSQL แจ้งเตือนเรื่องจำนวน Connection เกินกำหนด การใช้รูปแบบ Singleton ผูกไว้กับตัวแปร globalThis จะช่วยแก้ปัญหานี้ได้อย่างสมบูรณ์

src/lib/prisma.tstypescript
import { PrismaClient } from "@prisma/client";

const globalForPrisma = globalThis as unknown as {
  prisma: PrismaClient | undefined;
};

export const prisma =
  globalForPrisma.prisma ??
  new PrismaClient({
    log: process.env.NODE_ENV === "development" ? ["query", "error", "warn"] : ["error"],
  });

if (process.env.NODE_ENV !== "production") {
  globalForPrisma.prisma = prisma;
}