[JPA] 필드와 컬럼 매핑 - @Column

 

 

 

🧐 @Column

@Column은 객체 필드를 테이블의 컬럼에 매핑시켜주는 어노테이션입니다.

 

 

 

 

 

 

 

 

속성

속성	기능	기본값
name	필드와 매핑할 테이블의 컬럼 이름을 지정한다.	객체의 필드 이름
insertable (거의 사용하지 않음)	엔티티 저장 시 이 필드도 같이 저장한다. false로 설정하면 이 필드는 데이터베이스에 저장하지 않는다. false 옵션은 읽기 전용일 때 사용한다	true
updateable	엔티티 수정 시 이 필드도 같이 수정한다. false로 설정하면 데이터베이스에 수정하지 않는다. false 옵션은 읽기 전용일 때 사용한다	true
table (거의 사용하지 않음)	하나의 엔티티를 두 개 이상의 테이블에 매필할 때 사용한다.(@SecondaryTable 사용) 지정한 필드를 다른 테이블에 매핑할 수 있다.	현재 클래스가 매핑된 테이블
nullable (DDL)	DDL 생성 시 null 값의 허용 여부를 설정한다. false로 설정하면 not null 제약조건이 붙는다.	true
unique (DDL)	@Table의 uniqueConstraints와 같으나 한 컬럼에 간단히 유니크 제약조건을 걸 때 사용한다.	false
columnDefinition (DDL)	데이터베이스 컬럼 정보를 직접 줄 수 있다.	자바 필드의 타입과, 데이터베이스 방언 설정 정보를 사용해 적절히 생성
length (DDL)	문자 길이 제약조건, String 타입에만 사용한다.	255
precision, scale (DDL)	BigDecimal 타입(혹은 BigInteger)에서 사용한다.  precision은 소수점을 포함한 전체 자리수를,  scale은 소수의 자리수다.	precision = 0, scale = 0

 

 

 

 

 

 

 

 

 

예시

name

@Column(name = "MEMBER_NAME")
private String name;

 

생성되는 DDL

 

 

columnDefinition

@Column(columnDefinition = "varchar (100) default 'EMPTY'")
private String data;

 

생성되는 DDL

 

 

 

 

 

 

 

 

 

 

 

⭐️ [참고] @Column의 unique 속성 사용 시

@Column의 unique 속성을 true로 사용할 경우 유니크 제약조건의 이름을 다음과 같이 생성합니다.

UK_dqwjdiowqfnjoiwqfejwqe34912mdqw 

실제 예시입니다.

위와 같이 임의의 랜덤한 이름을 사용하므로 알아보기 힘듭니다.

 

 

따라서 @Column의 unique 속성보다는 @Table의 uniqueConstraints 속성을 사용하여, 제약조건의 이름을 걸어주는 방법을 사용하는 것이 바람직합니다.

 

다음은 코틀린을 사용한 예시입니다.

@Entity
@Table(name = "member", uniqueConstraints = [
    UniqueConstraint(columnNames = ["member_data"], name = "unique_data")
])
class Member(
    @Id @Column(name = "member_id")
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    var id: Long = 0,
    
    @Column(name = "member_data")
    var data: String,
) {
}

 

생성되는 ddl

 

 

 

 

 

 

 

 

 

 

 

⭐️ [참고] @Column의 생략

@Column을 생략한다면 대부분의 @Column 속성이 기본으로 적용되어집니다.

 

그러나 자바 기본 타입(int, double 등)일 때는 nullable 속성에 예외가 있습니다.

 

 

다음 예시 코드를 보면서 확인하겠습니다.

int data1; //@Column생략, 자바 기본 타입

Integer data2; //@Column생략, 자바 객체 타입

@Column
int data1; //@Column사용, 자바 기본 타입

 

 

우선 @Column을 생략한 자바 기본 타입의 경우, DDL 생성시 다음과 같이 생성됩니다.

data1 integer not null

 

 

@Column을 생략한 자바 객체 타입은 다음과 같습니다.

data2 integer

 

 

마지막으로 @Column을 사용한 자바 기본 타입은 다음과 같습니다.

data3 integer

 

int data1 과 같은 자바 기본 타입에는 null을 입력할 수 없습니다.

객체 타입인 경우에만 null값이 허용됩니다.

 

따라서 자바 기본 타입은 not null 제약조건을 붙여주는 것이 안전합니다.

 

JPA는 이를 고려하여 DDL 생성 기능 사용 시, 자바의 기본 타입에는 not null 제약조건을 추가해줍니다

 

그러나 @Column을 사용해버리면, 기본값이 nullable = true이므로 not null 제약조건을 설정하지 않습니다

 

따라서 자바 기본 타입에 @Column을 사용한다면, nullable = false로 지정하는 것이 안전합니다.

 

 

 

 

 

 

 

 

 

 

Reference

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

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