콘텐츠로 이동

데이터베이스 문서

데이터베이스 설치, Redis 캐싱, JPA/QueryDSL 활용에 관한 가이드입니다.

Databases

설치부터 캐싱, ORM 활용까지 데이터베이스 문서 모음

RDBMS 선택, Redis 활용, JPA 및 QueryDSL 설계 포인트를 실제 애플리케이션 개발 흐름에 맞춰 빠르게 찾을 수 있도록 정리했습니다.

Installation Redis JPA QueryDSL

설치 가이드 Redis 개요 JPA 개요

핵심 데이터 영역

데이터베이스 선택 가이드

flowchart TD
    A[요구사항 분석] --> B{데이터 특성?}

    B -->|정형 데이터<br/>ACID 필요| C[RDBMS]
    B -->|캐시/세션<br/>빠른 응답| D[Redis]
    B -->|비정형 문서<br/>유연한 스키마| E[MongoDB]
    B -->|시계열 데이터<br/>메트릭| F[InfluxDB]
    B -->|검색/분석<br/>전문 검색| G[Elasticsearch]

    C --> C1[MySQL]
    C --> C2[PostgreSQL]
    C --> C3[MariaDB]

    D --> D1[단독 사용]
    D --> D2[캐시 레이어]

    style C fill:#e3f2fd
    style D fill:#ffebee
    style E fill:#e8f5e9

RDBMS 비교

특성 MySQL PostgreSQL MariaDB
라이선스 GPL + 상용 BSD GPL
JSON 지원 ⭐⭐ ⭐⭐⭐ ⭐⭐
복제 비동기/반동기 동기/비동기 비동기/반동기
파티셔닝 Range, Hash 다양 Range, Hash
Full-text InnoDB, MyISAM GIN, GiST InnoDB
추천 용도 웹 서비스, OLTP 복잡한 쿼리, GIS MySQL 대체

Redis 아키텍처

데이터 구조

flowchart LR
    subgraph Redis["Redis Data Types"]
        A[String] --> A1["SET key value"]
        B[Hash] --> B1["HSET user name 'John'"]
        C[List] --> C1["LPUSH queue task"]
        D[Set] --> D1["SADD tags 'java'"]
        E[Sorted Set] --> E1["ZADD rank 100 'user1'"]
    end

캐싱 패턴

패턴 설명 사용 사례
Cache Aside 애플리케이션이 캐시 관리 일반적인 캐싱
Read Through 캐시가 DB 조회 읽기 중심
Write Through 캐시와 DB 동시 쓰기 일관성 중요
Write Behind 캐시만 쓰고 비동기 DB 저장 성능 중요

JPA 관계 매핑

관계 유형

erDiagram
    USER ||--o{ ORDER : places
    ORDER ||--|{ ORDER_ITEM : contains
    PRODUCT ||--o{ ORDER_ITEM : included_in
    CATEGORY ||--o{ PRODUCT : has

    USER {
        Long id PK
        String email
        String name
    }
    ORDER {
        Long id PK
        Long userId FK
        LocalDateTime createdAt
    }
    ORDER_ITEM {
        Long id PK
        Long orderId FK
        Long productId FK
        Integer quantity
    }
    PRODUCT {
        Long id PK
        Long categoryId FK
        String name
        BigDecimal price
    }
    CATEGORY {
        Long id PK
        String name
    }

어노테이션 요약

관계 어노테이션 예시
1:1 @OneToOne User ↔ Profile
1:N @OneToMany User → Orders
N:1 @ManyToOne Order → User
N:M @ManyToMany Student ↔ Course

성능 최적화

쿼리 최적화

-- 인덱스 생성
CREATE INDEX idx_user_email ON users(email);
CREATE INDEX idx_order_user_created ON orders(user_id, created_at);

-- 실행 계획 확인
EXPLAIN ANALYZE SELECT * FROM orders WHERE user_id = 1;

N+1 문제 해결

// ❌ N+1 문제 발생
List<User> users = userRepository.findAll();
users.forEach(u -> u.getOrders().size()); // 각 user마다 쿼리

// ✅ 페치 조인으로 해결
@Query("SELECT u FROM User u JOIN FETCH u.orders")
List<User> findAllWithOrders();

인덱스 전략

인덱스 유형 사용 사례 주의점
B-Tree 범위 검색, 정렬 기본값
Hash 등값 비교 범위 검색 불가
Full-text 전문 검색 대용량 텍스트
Composite 다중 컬럼 검색 컬럼 순서 중요

관리 도구

도구 지원 DB 특징
DBeaver 다중 무료, 범용
DataGrip 다중 JetBrains, 유료
pgAdmin PostgreSQL 공식 도구
MySQL Workbench MySQL 공식 도구
Redis Insight Redis GUI 관리

관련 문서

참고 자료