Drizzle ORM 실무 활용 팁

Drizzle ORM의 실무 활용을 위한 고급 패턴과 최적화 기법을 소개합니다. 타입 안정성, 성능 최적화, 트랜잭션 처리 등 실전에서 바로 사용할 수 있는 팁들을 다룹니다.

---

---

들어가며

이 글에서는 Drizzle ORM 실무 활용 팁에 대해 상세히 알아보겠습니다. 총 10가지 주요 개념을 다루며, 각각의 개념에 대한 설명과 실제 코드 예제를 함께 제공합니다.

목차

1. 스키마_정의와_타입_추론
2. 관계형_쿼리_최적화
3. 트랜잭션_처리_패턴
4. 동적_쿼리_빌더
5. Prepared_Statements_활용
6. 배치_삽입_최적화
7. 서브쿼리_활용
8. 부분_업데이트와_반환값
9. 집계_함수_활용
10. 마이그레이션_자동화

---

1. 스키마 정의와 타입 추론

개요

Drizzle의 강력한 타입 추론 기능을 활용하여 타입 안정성을 확보하는 방법입니다.

코드 예제

```typescript
import { pgTable, serial, text, timestamp } from 'drizzle-orm/pg-core';
import { InferModel } from 'drizzle-orm';

export const users = pgTable('users', {
  id: serial('id').primaryKey(),
  name: text('name').notNull(),
  email: text('email').notNull().unique(),
  createdAt: timestamp('created_at').defaultNow()
});

export type User = InferModel<typeof users>;
export type NewUser = InferModel<typeof users, 'insert'>;

### 설명

InferModel을 사용하면 스키마로부터 타입을 자동으로 추론하여 타입 안정성을 확보할 수 있습니다.

---

## 2. 관계형_쿼리_최적화

### 개요

relations를 활용하여 조인 쿼리를 타입 안전하게 작성하는 방법입니다.

### 코드 예제

```typescript
```typescript
import { relations } from 'drizzle-orm';
import { users, posts } from './schema';

export const usersRelations = relations(users, ({ many }) => ({
  posts: many(posts)
}));

// 사용 예시
const result = await db.query.users.findMany({
  with: { posts: true }
});

### 설명

relations를 정의하면 복잡한 조인 없이도 관계형 데이터를 쉽게 조회할 수 있습니다.

---

## 3. 트랜잭션_처리_패턴

### 개요

여러 작업을 원자적으로 처리하는 트랜잭션 패턴입니다.

### 코드 예제

```typescript
```typescript
import { db } from './db';

await db.transaction(async (tx) => {
  const user = await tx.insert(users).values({
    name: 'John', email: 'john@email.com'
  }).returning();

  await tx.insert(posts).values({
    userId: user[0].id,
    title: 'First Post'
  });
});

### 설명

transaction 메서드를 사용하면 모든 작업이 성공하거나 모두 롤백되어 데이터 일관성을 보장합니다.

---

## 4. 동적_쿼리_빌더

### 개요

조건부 필터링을 위한 동적 쿼리 구성 방법입니다.

### 코드 예제

```typescript
```typescript
import { eq, and, like } from 'drizzle-orm';

const filters = [];
if (searchName) filters.push(like(users.name, `%${searchName}%`));
if (email) filters.push(eq(users.email, email));

const result = await db.select()
  .from(users)
  .where(filters.length > 0 ? and(...filters) : undefined);

### 설명

조건에 따라 필터를 동적으로 추가하여 유연한 쿼리를 작성할 수 있습니다.

---

## 5. Prepared_Statements_활용

### 개요

반복되는 쿼리의 성능을 최적화하는 Prepared Statement 패턴입니다.

### 코드 예제

```typescript
```typescript
import { placeholder } from 'drizzle-orm/pg-core';

const preparedQuery = db.select()
  .from(users)
  .where(eq(users.id, placeholder('id')))
  .prepare('get_user_by_id');

const user1 = await preparedQuery.execute({ id: 1 });
const user2 = await preparedQuery.execute({ id: 2 });

### 설명

prepare를 사용하면 쿼리가 한 번만 파싱되어 반복 실행 시 성능이 크게 향상됩니다.

---

## 6. 배치_삽입_최적화

### 개요

대량의 데이터를 효율적으로 삽입하는 방법입니다.

### 코드 예제

```typescript
```typescript
const newUsers = [
  { name: 'User1', email: 'user1@email.com' },
  { name: 'User2', email: 'user2@email.com' },
  { name: 'User3', email: 'user3@email.com' }
];

await db.insert(users).values(newUsers);

### 설명

배열을 values에 전달하면 단일 쿼리로 여러 레코드를 삽입하여 성능을 최적화할 수 있습니다.

---

## 7. 서브쿼리_활용

### 개요

복잡한 조건을 서브쿼리로 처리하는 패턴입니다.

### 코드 예제

```typescript
```typescript
import { sql } from 'drizzle-orm';

const activeUserIds = db.select({ id: users.id })
  .from(users)
  .where(eq(users.status, 'active'));

const posts = await db.select()
  .from(posts)
  .where(sql`${posts.userId} in ${activeUserIds}`);

### 설명

서브쿼리를 사용하면 복잡한 필터링 로직을 명확하게 표현할 수 있습니다.

---

## 8. 부분_업데이트와_반환값

### 개요

특정 필드만 업데이트하고 결과를 즉시 받는 방법입니다.

### 코드 예제

```typescript
```typescript
const updated = await db.update(users)
  .set({ name: 'Updated Name' })
  .where(eq(users.id, 1))
  .returning({
    id: users.id,
    name: users.name,
    updatedAt: users.updatedAt
  });

### 설명

returning을 사용하면 업데이트된 데이터를 즉시 조회하여 추가 쿼리를 줄일 수 있습니다.

---

## 9. 집계_함수_활용

### 개요

count, sum 등의 집계 함수를 타입 안전하게 사용하는 방법입니다.

### 코드 예제

```typescript
```typescript
import { count, sum, avg } from 'drizzle-orm';

const stats = await db.select({
  totalUsers: count(users.id),
  avgAge: avg(users.age),
  totalPosts: sum(posts.likes)
})
.from(users)
.leftJoin(posts, eq(users.id, posts.userId));

### 설명

Drizzle의 집계 함수를 사용하면 타입 안정성을 유지하면서 통계 데이터를 쉽게 조회할 수 있습니다.

---

## 10. 마이그레이션_자동화

### 개요

스키마 변경을 자동으로 마이그레이션 파일로 생성하는 방법입니다.

### 코드 예제

```typescript
```typescript
// drizzle.config.ts
import { defineConfig } from 'drizzle-kit';

export default defineConfig({
  schema: './src/schema.ts',
  out: './drizzle/migrations',
  driver: 'pg',
  dbCredentials: {
    connectionString: process.env.DATABASE_URL!
  }
});

### 설명

drizzle-kit을 설정하면 스키마 변경 시 자동으로 마이그레이션 파일이 생성되어 버전 관리가 쉬워집니다.

---

## 마치며

이번 글에서는 Drizzle ORM 실무 활용 팁에 대해 알아보았습니다.
총 10가지 개념을 다루었으며, 각각의 사용법과 예제를 살펴보았습니다.

### 관련 태그

#Drizzle #ORM #TypeScript #Database #PostgreSQL