Atlas

핵심 개념

Declarative Schema

최종 스키마 상태를 HCL이나 SQL로 선언하면, Atlas가 현재 상태와 비교해 필요한 변경 작업을 자동으로 계산합니다.

Schema Inspection

실행 중인 데이터베이스에 연결해 현재 스키마 구조를 읽어오고 분석하는 기능입니다.

Migration Directory

스키마 변경 히스토리를 순서대로 담은 마이그레이션 파일들의 모음으로, 버전 관리 시스템에 커밋해 변경 이력을 추적합니다.

Diff & Apply

선언한 스키마와 실제 데이터베이스를 비교(diff)해 차이를 파악하고, 그 차이를 반영(apply)하는 핵심 워크플로우입니다.

HCL Schema

Atlas가 제공하는 HCL 기반 스키마 정의 언어로, 테이블·컬럼·인덱스·제약 조건 등을 구조적으로 표현할 수 있습니다.

HCL로 스키마 정의 후 마이그레이션 생성

HCL로 users 테이블 구조를 선언하고, atlas migrate diff 명령으로 현재 DB와 비교해 마이그레이션 SQL 파일을 자동 생성합니다.

# schema.hcl
table "users" {
  schema = schema.public
  column "id" {
    type = int
    auto_increment = true
  }
  column "email" {
    type = varchar(255)
    null = false
  }
  primary_key {
    columns = [column.id]
  }
  index "email_idx" {
    columns = [column.email]
    unique = true
  }
}

# 마이그레이션 생성
# atlas migrate diff --env local