Spring/JPA
JPA - 엔티티 매핑
jddng
2022. 3. 8. 14:26
728x90
반응형
엔티티 매핑
- 데이터베이스 스키마 자동 생성
- 객체와 테이블 매핑
- 필드와 컬럼 매핑
- 기본 키 매핑 - 직접 할당, 자동할당(@GeneratedValue)
- @GeneratedValue의 identity 전략
데이터베이스 스키마 자동 생성
- DDL을 애플리케이션 실행 시점에 자동 생성
- 객체 중심으로 개발이 가능
- 각 데이터베이스에 맞는 적절한 DDL 생성
- 생성된 DDL은 개발 장비에서만 사용하는게 좋다.
(운영서버에서 사용하기 위해서는 적절히 다듬은 후 사용해야한다)
spring.jpa.hibernate.ddl-auto
| 옵션 | 설명 | 사용 시점 |
| create | 기존 테이블 삭제 후 다시 생성 (DROP + CREATE) | 개발 초기 단계 |
| create-drop | 테이블 생성 후 종료 시점에 테이블 DROP (CREATE + DROP) | 개발 초기 단계 |
| update | 변경분만 반영 | 테스트 서버 |
| validate | 엔티티와 테이블이 정상 매핑되었는지만 확인 | 테스트 서버, 운영 서버 |
| none | 옵션 사용 X | 운영 서버 |
※ 운영 장비에는 절대 create, create-drop, update 사용하면 안된다.
객체와 테이블 매핑
@Entity
- JPA가 관리하는 엔티티
- JPA를 사용해서 테이블과 매핑할 클래스는 @Entity가 필수
- 기본 생성자가 필수
- final 클래스, enum, interface, inner 클래스에 사용 X
- 저장할 필드에 final 사용 X
- 속성 : name
- JPA에서 사용할 엔티티 이름을 지정
- 기본값 : 클래스 명
- 같은 클래스 이름이 없으면 기본값을 사용
@Table
- @Table은 엔티티와 매핑할 테이블 지정
| 속성 | 기능 | 기본값 |
| name | 매핑할 테이블 이름 | 엔티티 명 |
| catalog | 데이터베이스 catalog 매핑 | |
| schema | 데이터베이스 schema 매핑 | |
| uniqueConstraints(DDL) | DDL 생성 시에 유니크 제약 조건 생성 |
필드와 컬럼 매핑
| 어노테이션 | 설명 |
| @Column | 컬럼 매핑 |
| @Temporal | 날짜 타입 매핑 |
| @Enumerated | enum 타입 매핑 |
| @Lob | BLOB, CLOB 매핑 |
| @Transient | 특정 필드를 컬럼에 매핑하지 않음(매핑 무시) |
@Column
| 속성 | 설명 | 기본값 |
| name | 필드와 매핑할 테이블의 컬럼 이름 | 객체의 필드 이름 |
| insertable updatable |
등록, 변경 가능 여부 | TRUE |
| nullable(DDL) | null 값의 허용 여부를 설정 false 설정 시 not null 제약조건이 붙는다 |
TRUE |
| unique(DDL) | @Table의 uniqueConstraints와 같지만 한 컬럼에 간단히 유니크 제약조건을 걸 때 사용 (유니크 제약조건 명이 랜덤문자열이 나오므로 사용안한다) |
|
| columnDefinition(DDL) | 데이터베이스 컬럼 정보를 직접 줄 수 있다. EX) varchar(100) default 'EMPTY' |
필드의 자바 타입과 방언 정보 사용 |
| length(DDL) | 문자 길이 제약조건, String 타입에만 적용 | 255 |
| precision scale(DDL) |
BigDecimal 타입에서 사용한다(BigInteger도 사용할 수 있다.) precision은 소수점을 포함한 전체 자리수 scale은 소수의 자리수이다. (double, float 타입에는 적용되지 않는다) |
precision=19 scale=2 |
@Enumerated
- 자바 enum 타입을 매핑할 때 사용한다
- ORDINAL은 사용안하는게 좋다.
| 속성 | 설명 | 기본값 |
| value | EnumType.ORDINAL: enum 순서를 데이터베이스에 저장 (Integer타입) EnumType.STRING: enum 이름을 데이터베이스에 저장 (String타입) |
EnumType.ORDINAL |
@Temporal
- 날짜 타입을 매핑할 때 사용
- LocalDate, LocalDateTime을 사용할 때는 생략이 가능
| 속성 | 설명 |
| value | TemporalType.DATE: 날짜, 데이터베이스 date 타입과 매핑 (예: 2013–10–11) TemporalType.TIME: 시간, 데이터베이스 time 타입과 매핑 (예: 11:11:11) TemporalType.TIMESTAMP: 날짜와 시간, 데이터베이 스 timestamp 타입과 매핑(예: 2013–10–11 11:11:11) |
@Lob
- 데이터베이스 BLOB, CLOB 타입과 매핑
- 지정할 수 있는 속성이 없다
- 매핑하는 필드 타입이 문자면 CLOB 매핑, 나머지는 BLOB 매핑
- CLOB : String, char[], java.sql.CLOB
- BLOB : byte[], java.sql.BLOB
@Transient
- 칼럼과 매핑하지 않는 필드
- 데이터베이스에 저장X, 조회X
- 주로 메모리상에서 임시로 값을 보관하고 싶을 때 사용한다.
기본 키 매핑
- @Id : 직접 할당
- @GeneratedValue : 자동 할당
자동 할당(@GeneratedValue)
- @GeneratedValue(strategy = "속성값")
| 속성값 | 설명 |
| IDENTITY | 데이터베이스에 위임, MYSQL |
| SEQUENCE | 데이터베이스 시퀀스 오브젝트 사용, ORACLE @SequenceGenerator 필요 |
| TABLE | 키 생성용 테이블 사용, 모든 DB에서 사용 @TableGenerator 필요 |
| AUTO | 방언에 따라 자동 지정, 기본값 |
@SequenceGenerator
| 속성 | 설명 | 기본값 |
| name | 식별자 생성기 이름 | 필수 |
| sequenceName | 데이터베이스에 등록되어 있는 시퀀스 이름 | hibernate_sequence |
| initialValue | DDL 생성 시에만 사용, 시퀀스 DDL을 생성할 때 처음 시작하는 수를 지정 |
1 |
| allocationSize | 시퀀스 한 번 호출에 증가하는 수(성능 최적화에 사용) | 50 |
| catalog, schema | 데이터베이스 catalog, schema 이름 |
@Entity
@SequenceGenerator(
name = "MEMBER_SEQ_GENERATOR",
sequenceName = "MEMBER_SEQ", //매핑할 데이터베이스 시퀀스 이름
initialValue = 1, allocationSize = 1)
public class Member {
@Id
@GeneratedValue(strategy = GenerationType.SEQUENCE,
generator = "MEMBER_SEQ_GENERATOR")
private Long id;
...
}
@TableGenerator
| 속성 | 설명 | 기본값 |
| name | 식별자 생성기 이름 | 필수 |
| table | 키생성 테이블명 | hibernate_sequence |
| pkColumnName | 시퀀스 컬럼명 | sequence_name |
| valueColumnNa | 시퀀스 값 컬럼명 | 엔티티 이름 |
| pkColumnValue | 키로 사용할 값 이름 | 엔티티 이름 |
| initialValue | 초기 값, 마지막으로 생성된 값이 기준 | 0 |
| allocationSize | 시퀀스 한 번 호출에 증가하는 수(성능 최적화에 사용) | 50 |
| catalog, schema | 데이터베이스 catalog, schema 이름 | |
| uniqueConstraints(DDL) | 유니크 제약 조건을 지정할 수 있다. |
@Entity
@TableGenerator(
name = "MEMBER_SEQ_GENERATOR",
table = "MY_SEQUENCES",
pkColumnValue = "MEMBER_SEQ", allocationSize = 1)
public class Member {
@Id
@GeneratedValue(strategy = GenerationType.TABLE,
generator = "MEMBER_SEQ_GENERATOR")
private Long id;
...
}
@GeneratedValue의 IDENTITY 전략과 SEQUENCE 전략
JPA는 보통 트랜잭션 커밋 시점에 INSERT SQL가 실행되지만 IDENTITY 전략일 경우에는 KEY 값을 알 수 없기 때문에 em.persist() 시점에 즉시 INSERT SQL을 전달한다.
@Test
@Transactional
@Rollback(false)
void identityStrategy() {
Member member = new Member();
member.setName("테스트");
System.out.println("================");
em.persist(member);
System.out.println("================");
}
IDENTITY와 SEQUENCE의 쿼리 전달
위 로그를 보면 둘의 차이가 나타난다 IDENTITY 전략은 em.persist 시점에 INSERT SQL이 전달되지만 SEQUENCE 전략은 SEQUENCE 값을 DB에서 조회한 이후에 INSERT SQL이 전달된다.
둘의 차이를 보면 SEQUENCE 전략이 DB에 2번 접근을 하니 성능이 IDENTITY보다 성능이 안좋다. 이러한 단점을 해결하기 위해 JPA는 SEQUENCE 값들을 미리 지정한만큼 가져와서 사용하여 성능 문제를 해결한다. 다음 테스트 코드를 보자.
// Entity
@Entity
@Getter @Setter
@SequenceGenerator(
name = "MEMBER_SEQ_GENERATOR",
sequenceName = "MEMBER_SEQ", //매핑할 데이터베이스 시퀀스 이름
initialValue = 1, allocationSize = 50)
public class Member {
@Id
@GeneratedValue(strategy = GenerationType.SEQUENCE,
generator = "MEMBER_SEQ_GENERATOR")
private Long id;
...
}
// test code
@Test
@Transactional
@Rollback(false)
void sequenceStrategy2() {
Member member1 = new Member();
member1.setName("테스트1");
Member member2 = new Member();
member2.setName("테스트2");
Member member3 = new Member();
member3.setName("테스트3");
System.out.println("================");
em.persist(member1);
em.persist(member2);
em.persist(member3);
System.out.println("member1 = " + member1.getId());
System.out.println("member2 = " + member2.getId());
System.out.println("member3 = " + member3.getId());
System.out.println("================");
}
로그를 보면 시퀀스 조회를 위해 쿼리가 2번 실행된것을 볼 수있다. 처음 시퀀스 SELECT SQL은 한번에 1~50까지의 sequence값을 가져와 메모리에 저장한다. 그 다음 em.persist(member2)가 실행되면 다시 한번 SELECT SQL이 실행되어 새로 가져온 sequence 값과 메모리에 저장되어있는 sequence를 비교하여 아직 메모리의 sequence가 다 사용되지않았다면 메모리에 있는 시퀀스를 사용하게 되고, 그 이후에 em.persist가 실행되더라도 SELECT SQL이 실행되지 않고 메모리에 저장되어있는 sequence 값을 가져와 사용하게 된다.
728x90
반응형