Drizzle ORM + SQLite로 가벼운 백엔드 만들기

# 패키지 설치

npm install drizzle-orm better-sqlite3
npm install -D drizzle-kit @types/better-sqlite3

lib/db/schema.ts — 스키마 정의 예시

import { sqliteTable, text, integer } from "drizzle-orm/sqlite-core";

export const users = sqliteTable("users", {
  id: text("id").primaryKey(),
  email: text("email").notNull().unique(),
  name: text("name").notNull(),
  role: text("role").notNull().default("user"),
  createdAt: integer("created_at", { mode: "timestamp" })
    .notNull()
    .$defaultFn(() => new Date()),
});

export const posts = sqliteTable("posts", {
  id: integer("id").primaryKey({ autoIncrement: true }),
  title: text("title").notNull(),
  content: text("content").notNull(),
  authorId: text("author_id")
    .notNull()
    .references(() => users.id),
  publishedAt: integer("published_at", { mode: "timestamp" }),
});

drizzle.config.ts

import { defineConfig } from "drizzle-kit";

export default defineConfig({
  schema: "./lib/db/schema.ts",
  out: "./drizzle",
  dialect: "sqlite",
  dbCredentials: {
    url: "./data/app.db",
  },
});

# 마이그레이션 명령어

# 마이그레이션 파일 생성 (스키마 변경 감지)
npx drizzle-kit generate

# 마이그레이션 적용
npx drizzle-kit migrate

# 스키마를 DB에 직접 반영 (개발 중 빠른 적용)
npx drizzle-kit push

# Drizzle Studio로 DB 내용 확인 (GUI)
npx drizzle-kit studio

scripts/seed.ts

import { db } from "../lib/db";
import { users } from "../lib/db/schema";

async function seed() {
  console.log("시드 데이터 삽입 시작...");

  // 관리자 계정 생성
  await db.insert(users).values({
    id: "admin-001",
    email: "admin@example.com",
    name: "관리자",
    role: "admin",
  }).onConflictDoNothing();

  console.log("시드 데이터 삽입 완료");
}

seed().catch(console.error);

# 시드 실행 (tsx 사용)

# tsx로 TypeScript 직접 실행
npx tsx scripts/seed.ts

# package.json에 스크립트 추가
# "scripts": { "seed": "tsx scripts/seed.ts" }
npm run seed

lib/db/index.ts — WAL 모드 활성화

import Database from "better-sqlite3";
import { drizzle } from "drizzle-orm/better-sqlite3";
import * as schema from "./schema";

const sqlite = new Database("./data/app.db");

// WAL 모드 활성화 (한 번만 실행하면 영구 적용)
sqlite.pragma("journal_mode = WAL");

// 추가 성능 최적화
sqlite.pragma("busy_timeout = 5000");     // 잠금 대기 5초
sqlite.pragma("synchronous = NORMAL");     // 성능과 안정성 균형
sqlite.pragma("foreign_keys = ON");        // 외래 키 활성화

export const db = drizzle(sqlite, { schema });