[JPA] 기본 키(Primary Key)매핑 - @Id, @GeneratedValue

 

 

 

 

🧐 @Id

데이터베이스 테이블의 기본 키(PK)와 객체의 필드를 매핑시켜주는 어노테이션입니다.

 

 

 

적용 가능 타입

• 자바 기본형 (int, long, ...)
• 자바 래퍼형 (Integer, Long, ...)
• String
• Date (java.util)
• Date (java.sql)
• BigDecimal
• BigInteger

 

 

@Id만 사용할 경우 기본 키를 직접 할당해 주어야 합니다.

기본 키를 직접 할당하는 대신 데이터베이스가 생성해주는 값을 사용하려면 @GeneratedValue를 사용해주면 됩니다.

 

 

 

 

 

 

 

🧐 @GeneratedValue

기본 키를 자동 생성해주는 어노테이션입니다.

속성으로는 strategy가 있는데, 이를 통해 자동 생성 전략을 지정해 줄 수 있습니다.

 

이제부터 각각의 전략들을 살펴보도록 하겠습니다.

 

 

 

 

 

⭐️ IDENTITY

@GeneratedValue(strategy = GenerationType.IDENTITY)

IDENTITY 전략은 기본 키 생성을 데이터베이스에 위임하는 전략입니다.

 

주로 MySQL, PostgreSQL, SQL Server에서 사용합니다.

예를 들어 MySQL의 AUTO_INCREMENT 기능은 데이터베이스가 기본 키를 자동으로 생성해줍니다.

IDENTITY 전략은 AUTO_INCREMENT처럼 데이터베이스에 값을 저장하고 나서야 기본 키 값을 구할 수 있을 때 사용합니다.

 

 

 

 

주의점

엔티티가 영속 상태가 되기 위해서는 식별자가 필수입니다.

 

그런데 IDENTITY 전략을 사용하면 식별자를 데이터베이스에서 지정하기 전까지는 알 수 없기 때문에, em.persist()를 하는 즉시 INSERT SQL이 데이터베이스에 전달됩니다.

 

따라서 이 전략은 트랜잭션을 지원하는 쓰기 지연이 동작하지 않습니다.

 

 

 

 

 

 

 

 

 

 

 

 

⭐️ SEQUENCE 

데이터베이스 시퀀스는 유일한 값을 순서대로 생성하는 특별한 데이터베이스 오브젝트입니다.

SEQUENCE 전략은 이 시퀀스를 사용해서 기본 키를 생성합니다.

이 전략은 시퀀스를 지원하는 오라클, PostgreSQL, H2 데이터베이스에서 사용할 수 있습니다.

@Getter
@Setter
@NoArgsConstructor(access = AccessLevel.PROTECTED)
@Entity
@SequenceGenerator(
        name = "BOARD_SEQ_GENERATOR",
        sequenceName = "BOARD_SEQ",
        initialValue = 1,
        allocationSize = 1
)
public class Member {
    
    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE,
    generator = "BOARD_SEQ_GENERATOR")
    @Column(name = "MEMBER_ID")
    private Long id;
    

}

시퀀스 전략을 사용하기 위해서는 우선 사용할 데이터베이스 시퀀스를 매핑해야 합니다.

 

@SequenceGenerator를 사용하여 시퀀스 생성기를 등록한 후, @GeneratedValue의 generator 속성으로 시퀀스 생성기를 선택하였습니다.

 

 

 

 

 

 

 

 

@SequenceGenerator 속성

속성	기능	기본값
name	식별자 생성기 이름	필수
sequenceName	데이터베이스에 등록되어 있는 시퀀스 이름	hibernate_sequence
initialValue	DDL 생성 시에만 사용된다. 시퀀스 DDL을 생성할 때 처음 시작하는 수를 지정한다.	1
allocationSize	시퀀스를 한 번 호출할 때 증가하는 수 (성능 최적화에 사용된다.)	50
catalog, schema	식별자 생성기의 catalog, schema 이름

 

 

 

 

 

 

 

 

 

 

 

⭐️ IDENTITY와 SEQUENCE의 차이

뭔가 두 전략이 비슷해 보이지만 사실 차이가 있습니다.

 

시퀀스 전략은 em.persist()를 호출할 때 먼저 데이터베이스 시퀀스를 사용해서 식별자를 조회합니다.

그리고 조회한 식별자를 엔티티에 할당한 후, 해당 엔티티를 영속성 컨텍스트에 저장합니다.

이후 트랜잭션 커밋 시점에 플러시가 발생하면 엔티티를 데이터베이스에 저장합니다.

 

IDENTITY 전략은 먼저 엔티티를 데이터베이스에 저장한 후에 식별자를 조회하여, 엔티티의 식별자에 할당한 후, 영속성 컨텍스트에 저장합니다.

 

 

 

 

 

 

 

 

 

 

⭐️ TABLE 

TABLE 전략은 키 생성 전용 테이블을 하나 만들고, 여기에 이름과 값으로 사용할 컬럼을 만들어 데이터베이스 시퀀스를 흉내내는 전략입니다.

이 전략은 테이블을 사용하기 때문에, 시퀀스를 지원하지 않는 데이터베이스에서도 사용할 수 있습니다.

@Getter
@Setter
@NoArgsConstructor(access = AccessLevel.PROTECTED)
@Entity
@TableGenerator(
        name = "BOARD_SEQ_GENERATOR",
        table = "MY_SEQUENCE",
        pkColumnValue = "BOARD_SEQ",
        initialValue = 1,
        allocationSize = 50
)
public class Member {
    
    @Id
    @GeneratedValue(strategy = GenerationType.TABLE,
    generator = "BOARD_SEQ_GENERATOR")
    @Column(name = "MEMBER_ID")
    private Long id;


}

생성되는 테이블은 다음과 같습니다.

 

SEQUENCE 전략과 매우 흡사하여, 시퀀스 대신 테이블을 사용하는 것 이외에는 내부 동작방식이 같습니다.

 

 

 

 

@TableGenerator 속성

속성	기능	기본값
name	식별자 생성기 이름	필수
table	키생성 테이블명	hibernate_sequences
pkColumnName	시퀀스 컬럼명	sequence_name
valueColumnName	시퀀스 값 컬럼명	next_val
pkColumnValue	키로 사용할 값 이름	엔티티 이름
initialValue	초기 값. 마지막으로 생성된 값이 기준이다.	0
allocationSize	시퀀스를 한 번 호출할 때 증가하는 수 (성능 최적화에 사용된다.)	50
catalog, schema	식별자 생성기의 catalog, schema 이름
uniqueConstraints (DDL)	유니크 제약 조건을 지정할 수 있다.

 

 

 

 

 

 

 

 

 

 

⭐️ SEQUENCE , TABLE 전략의 최적화

아래 포스팅을 참고해주세요

https://ttl-blog.tistory.com/122

[JPA] 기본 키 매핑 - SEQUENCE, TABLE 전략의 최적화

 

 

 

 

 

 

 

⭐️ AUTO 

데이터베이스는 종류도 많고 기본 키를 만드는 방법도 다양합니다.

AUTO로 설정하면 데이터베이스 방언에 따라 IDENTITY, SEQUENCE, TABLE 전략 중 하나를 자동으로 선택합니다.

@GeneratedValue의 strategy의 기본값은 AUTO입니다.

만약 AUTO를 사용할 때 SEQUENCE나 TABLE 전략이 선택되면, 시퀀스나 키 생성용 테이블을 미리 만들어 두어야 합니다.

만약 스키마 자동 생성 기능(ddl-auto)을 사용한다면, 하이버네이트가 기본값을 사용해서 적절하게 만들어줍니다.

 

 

 

 

 

 

 

 

 

 

 

 

📔 Reference

자바 ORM 표준 JPA 프로그래밍 - 기본편 - 인프런 | 강의

[자바 ORM 표준 JPA 프로그래밍 - 김영한]