데이터베이스 마이그레이션 with Room 라이브러리

데이터베이스 스키마가 변경되면 데이터베이스 마이그레이션을 수행해야 합니다. Room 라이브러리를 사용하면 데이터베이스 마이그레이션을 비교적 쉽게 수행할 수 있습니다.

1. 마이그레이션 클래스 작성

Room 라이브러리에서는 Migration이라는 클래스를 사용하여 데이터베이스 마이그레이션을 수행합니다. 마이그레이션은 이전 버전의 스키마와 새로운 버전의 스키마 간의 변경 사항을 정의합니다.

아래는 Migration 클래스를 작성하는 예제입니다.

val MIGRATION_1_2: Migration = object : Migration(1, 2) {
    override fun migrate(database: SupportSQLiteDatabase) {
        // 이전 버전에서 새로운 버전으로 데이터베이스 마이그레이션 수행
        database.execSQL("ALTER TABLE tableName ADD COLUMN newColumn TEXT")
    }
}

2. 데이터베이스 빌더에 마이그레이션 적용

마이그레이션을 적용하려면 데이터베이스 빌더에 addMigrations 메서드를 사용하여 마이그레이션을 지정해야 합니다.

아래는 데이터베이스 빌더에 마이그레이션을 적용하는 예제입니다.

val migrationDatabase = Room.databaseBuilder(context, AppDatabase::class.java, "database-name")
    .addMigrations(MIGRATION_1_2)
    .build()

3. 데이터베이스 버전 업데이트

마이그레이션 클래스를 정의하고 데이터베이스 빌더에 적용한 후, 데이터베이스 버전을 업데이트해야 합니다.

아래는 데이터베이스 버전을 업데이트하는 코드 예제입니다.

@Database(entities = [Entity::class], version = 2)
abstract class AppDatabase : RoomDatabase() {
    // 데이터베이스와 관련된 코드
}

이제 마이그레이션을 구현하고 Room 라이브러리를 사용하여 안드로이드 앱에서 데이터베이스 마이그레이션을 수행하는 방법에 대해 알아보았습니다. 원하는 경우에는 Migration 클래스 내부에서 실제 데이터베이스 스키마 변경에 대한 SQL 쿼리를 수행할 수 있습니다.

더 많은 자세한 내용은 Room 라이브러리 문서를 참고해 주세요.