[swift] 데이터베이스 마이그레이션 전략

01 Dec 2023

swift

많은 앱이 데이터베이스를 사용하여 사용자 정보, 설정, 콘텐츠 등을 저장합니다. 하지만 앱을 업데이트하면서 데이터베이스 스키마를 변경해야 되는 경우가 발생할 수 있습니다. 이럴 때 데이터베이스 마이그레이션 전략을 수립하여 데이터의 일관성과 안정성을 유지할 수 있습니다.

1. 초기 데이터베이스 설계

마이그레이션을 위해 먼저 초기 데이터베이스 스키마를 설계해야 합니다. 이때, 데이터베이스 객체에 대한 모델을 만들고 필요한 데이터베이스 테이블과 컬럼을 나타내는 스키마를 정의해야 합니다.

// User.swift
struct User {
    let id: Int
    let name: String
    let email: String
    // Additional properties...
}

// DatabaseSchema.swift
struct DatabaseSchema {
    let usersTable = "users"
    let idColumn = "id"
    let nameColumn = "name"
    let emailColumn = "email"
    // Additional columns...
}

2. 마이그레이션 스크립트 작성

다음으로, 데이터베이스 마이그레이션 스크립트를 작성해야 합니다. 이 스크립트는 데이터베이스 버전 관리와 스키마 변경을 수행합니다. 각 버전에 대한 마이그레이션 스크립트를 작성하고, 이전 버전에서 새로운 버전으로 데이터베이스 스키마를 변경하는 코드를 포함해야 합니다.

// MigrationScript.swift
func migrateDatabase() {
    let currentVersion = // 현재 데이터베이스 버전 확인 로직
    switch currentVersion {
    case 1:
        // Version 1 -> Version 2 마이그레이션 스크립트
        // users 테이블에 새로운 컬럼 추가
    case 2:
        // Version 2 -> Version 3 마이그레이션 스크립트
        // users 테이블에서 컬럼 삭제
    // Additional migration cases...
    default:
        break
    }
}

3. 마이그레이션 프로세스 실행

마지막으로, 앱 실행 중에 마이그레이션 프로세스를 실행해야 합니다. 이를 위해 앱 시작 시에 데이터베이스 버전을 확인하고, 현재 버전보다 높은 버전의 마이그레이션 스크립트를 실행해야 합니다.

// AppDelegate.swift
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    migrateDatabase() // 마이그레이션 실행
    // Additional app setup...
    return true
}

이러한 데이터베이스 마이그레이션 전략을 따르면, 앱을 안정적으로 업데이트할 수 있고, 데이터 일관성을 유지할 수 있습니다. 따라서 앱의 데이터베이스 스키마가 변경되는 경우에도 사용자 정보와 콘텐츠가 올바르게 보존되는데 도움이 됩니다.

참고 자료

SQLite.swift: Swift용 SQLite 라이브러리
Core Data: Apple의 데이터베이스 관리 프레임워크