[Spring][JAP] 엔티티 클래스에 쓰이는 @Table란 무엇일까?

 

 

Entity를 작성하면서
DB의 테이블과 연결시키기 위해
@Table을 사용했다.
@Table이 정확히 어떤 역할을 하는걸까?

 

 

 

 

 

@Table

• 엔티티 클래스가 데이터베이스의 어떤 테이블과 매핑되는지를 명시하는 역할을 한다.
• 이 어노테이션을 생략하면, 기본적으로 엔티티 클래스의 이름을 테이블 이름으로 사용하게 된다.
  → 예시) @Table이 코드에 없고 @Entity(name = "abc")만 존재하는 경우, @Entity의 name 속성에 의해 Entity와 Table 이름이 모두 결정된다.

 

 

---

 

 

 

 

@Table의 속성

• name 
  : 매핑할 테이블의 이름을 지정한다.
• uniqueConstraints
  : 테이블 생성 시 유니크(Unique) 제약 조건을 설정한다.
• indexes
  : 테이블에 인덱스를 생성할 때 사용한다.
• catalog / schema
  : DB의 카탈로그나 스키마를 지정해야 할 때 사용한다. (DB 구조에 따라 선택)

 

 

 

---

 

 

 

 

@Table을 이용한 간단한 코드 예시

import javax.persistence.*;

@Entity
@Table(
    name = "users", // DB에는 'users'라는 이름의 테이블로 생성됨
    uniqueConstraints = {
        @UniqueConstraint(
            name = "unique_email_constraint",
            columnNames = {"email"} // 이메일 컬럼에 중복 방지 제약 추가함
        )
    }
)
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(nullable = false)
    private String username;

    @Column(nullable = false)
    private String email;
}

위의 코드는 사용자의 정보를 담은 User 엔티티에 @Table을 적용한 예시이다. 테이블 이름을 users로 바꾸고, 이메일에 유니크 제약 조건을 걸었다. 만약에 MySQL로 DB를 생성했다면 위의 설정이 SQL의 어떤 구문으로 변환될까?

CREATE TABLE users (
    id BIGINT NOT NULL AUTO_INCREMENT,
    username VARCHAR(10) NOT NULL,
    email VARCHAR(100) NOT NULL,
    PRIMARY KEY (id),
    CONSTRAINT unique_email_constraint UNIQUE (email)
)

테이블 이름은 users가 되고, 이메일 컬럼에 중복 방지 제약을 추가했다. CONSTRAINT 제약조건의이름  UNIQUE(A) 구문을 추가하면 동일한 A가 중복 저장되는 것을 DB레벨에서 차단한다.

그 외 코드들을 간단하게 설명하겠다. id는 컬럼의 이름이고, BIGINT는 Java의 Long 타입에 대응하는 대용량 정수 타입이다. NOTNULL은 이 컬럼 내에 절대 빈 값이 들어올 수 없다는 걸 의미한다. AUTO_INCREMENT는 새 데이터가 삽입될 때마다 값을 1,2,3... 순서대로 자동 증가시켜 저장한다.

아래 코드도 비슷하다. VARCHAR(100)은 최대 100자까지 저장 가능하도록 한다. PRIMARY KEY(id)를 추가하여 id 칼럼이 이 테이블의 기본키로 설정시켰다.

 

 

 

 

---

 

 

- @Table

[JPA] 엔티티와 매핑. @Entity, @Table, @Id, @Column..