엔티티(Entity) 테이블(Table) 매핑

🧩 JPA 엔티티 매핑과 기본 키 전략 정리

정리 기준: 『자바 ORM 표준 JPA 프로그래밍』 학습 내용 기반
작성자: 백엔드 개발자용 요약 정리

---

1️⃣ 엔티티 매핑 (Entity Mapping)

JPA에서 @Entity는 해당 클래스가 JPA가 관리하는 엔티티임을 명시합니다.
DB 테이블과 매핑하기 위해 다음과 같은 어노테이션을 함께 사용합니다.

✔️ 주요 매핑 어노테이션

어노테이션설명

@Entity	해당 클래스가 엔티티임을 알림
@Table(name = "테이블명", uniqueConstraints = {...})	테이블 이름 및 유니크 제약 조건 지정
@Column	일반 컬럼 매핑
@Enumerated	Enum 타입 매핑
@Temporal	Date 타입 매핑 (예: @UpdateTimestamp로 자동 시간 설정 가능)
@Lob	CLOB, BLOB 타입 매핑

@Entity
@Table(
    name = "member",
    uniqueConstraints = {
        @UniqueConstraint(columnNames = "email", name = "UK_MEMBER_EMAIL")
    }
)
public class Member {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(nullable = false, length = 50)
    private String name;
}

---

2️⃣ 기본 키 매핑 (Primary Key Mapping)

데이터베이스마다 기본키 생성 방식이 다릅니다.
예:

• Oracle → 시퀀스 객체 (SEQUENCE)
• MySQL → AUTO_INCREMENT
  이를 통합적으로 다루기 위해 JPA는 다양한 키 생성 전략을 제공합니다.

---

🔹 직접 할당 (Manual Assignment)

엔티티를 persist() 하기 전에 애플리케이션에서 직접 기본키를 지정하는 방식입니다.

 

@Id private String id; // 직접 지정

---

🔹 자동 생성 (Generated Value)

@Id와 @GeneratedValue를 함께 사용하여 자동으로 키를 생성합니다.

1. IDENTITY 전략

• DB의 자동 증가 컬럼에 위임 (MySQL, PostgreSQL 등)
• 즉, insert 시점에 DB가 ID를 생성함

@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;

 

 

2. SEQUENCE 전략

• DB 시퀀스 객체를 사용하여 키 생성 (Oracle, PostgreSQL 등)
• 시퀀스 이름을 지정하려면 @SequenceGenerator 사용

@SequenceGenerator(
    name = "member_seq_gen",
    sequenceName = "member_seq",
    allocationSize = 1
)
@Id
@GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "member_seq_gen")
private Long id;

 

 

 

3. TABLE 전략

• 별도의 키 생성 테이블을 이용해 시퀀스처럼 관리하는 방식
• DB 독립적으로 동작 가능

 

@TableGenerator(
    name = "member_table_gen",
    table = "sequence_table",
    pkColumnValue = "member_seq",
    allocationSize = 1
)
@Id
@GeneratedValue(strategy = GenerationType.TABLE, generator = "member_table_gen")
private Long id;

 

4. AUTO 전략

• **DB 방언(Dialect)**에 따라 자동으로 적절한 전략 선택
• DB 벤더에 종속되지 않아 이식성이 높음

@Id
@GeneratedValue(strategy = GenerationType.AUTO)
private Long id;

 

 

---

⚙️ 참고 설정

Hibernate 5 이상에서는 hibernate.id.new_generator_mappings=true설정을 persistence.xml이나 application.yml에 추가해야
새로운 키 생성 전략이 적용됩니다.

---

3️⃣ 식별자(Primary Key) 선택 전략

✅ 기본 키의 필수 조건

1. NULL 값을 허용하지 않아야 한다.
2. 유일해야 한다.
3. 변하지 않아야 한다.

---

🌿 자연 키(Natural Key) vs 대리 키(Surrogate Key)

구분설명예시특징

자연 키	비즈니스 의미가 있는 값	주민등록번호, 이메일, 전화번호	변경 가능성 있음
대리 키	비즈니스와 무관한 임의 값	시퀀스, UUID 등	변경되지 않음, 관리 용이

권장: 비즈니스와 무관한 대리 키(Surrogate Key) 사용
이유: 비즈니스 로직 변화나 정책 변경에도 영향이 적기 때문입니다.

---

🏁 정리

구분전략특징주요 DB

직접 할당	@Id	애플리케이션에서 직접 설정	모든 DB
IDENTITY	@GeneratedValue(strategy = IDENTITY)	DB 자동 증가 컬럼 사용	MySQL, PostgreSQL
SEQUENCE	@GeneratedValue(strategy = SEQUENCE)	시퀀스 객체 이용	Oracle, PostgreSQL
TABLE	@GeneratedValue(strategy = TABLE)	키 생성용 테이블 사용	모든 DB
AUTO	@GeneratedValue(strategy = AUTO)	방언에 따라 자동 선택	모든 DB

---

📘 요약

• 엔티티 매핑: @Entity, @Table, @Column, @Enumerated 등을 활용
• 기본키 생성 전략: IDENTITY, SEQUENCE, TABLE, AUTO
• 추천 전략: 비즈니스와 무관한 대리 키 사용
• 설정 팁: Hibernate의 new_generator_mappings 속성 활성화 필요