Когда нужна миграция базы данных?

Когда нужна миграция базы данных?

Миграция базы данных — это процесс изменения структуры существующей базы данных, который необходим для синхронизации схемы данных с новыми требованиями приложения. В контексте Android-разработки, где чаще всего используется SQLite через Room Persistence Library, миграция становится критически важным механизмом для обеспечения бесперебойной работы приложения при обновлениях. Вот ключевые сценарии, когда миграция необходима.

Основные сценарии для миграции базы данных

1. Изменение схемы таблицы:

   • Добавление новых столбцов: Например, если в таблице User нужно добавить поле phoneNumber.
   • Удаление столбцов: Хотя в Room это не рекомендуется (лучше использовать аннотацию @Ignore), иногда требуется физическое удаление.
   • Переименование столбцов или таблиц: Важно использовать миграцию, чтобы не потерять данные.
   • Изменение типов данных столбцов: Например, изменение с INTEGER на STRING.

2. Добавление или удаление таблиц:

   • Введение новых сущностей, таких как добавление таблицы Order для приложения электронной коммерции.
   • Удаление устаревших таблиц, если они больше не нужны.

3. Изменение связей и индексов:

   • Добавление внешних ключей (Foreign Keys) для обеспечения целостности данных.
   • Создание или удаление индексов для оптимизации запросов.

4. Сложные структурные изменения:

   • Нормализация или денормализация схемы данных.
   • Разделение таблицы на несколько или объединение таблиц.

Пример миграции в Room

Предположим, у нас есть база данных версии 1 с таблицей User. В версии 2 мы добавляем новый столбец phoneNumber.

Версия 1: Исходная сущность

@Entity(tableName = "users")
data class User(
    @PrimaryKey val id: Int,
    val name: String,
    val email: String
)

Версия 2: Обновленная сущность с новым полем

@Entity(tableName = "users")
data class User(
    @PrimaryKey val id: Int,
    val name: String,
    val email: String,
    val phoneNumber: String? // Новый столбец
)

Миграция с версии 1 на 2

val MIGRATION_1_2 = object : Migration(1, 2) {
    override fun migrate(database: SupportSQLiteDatabase) {
        database.execSQL("ALTER TABLE users ADD COLUMN phoneNumber TEXT DEFAULT NULL")
    }
}

Добавление миграции в RoomDatabase

@Database(entities = [User::class], version = 2)
abstract class AppDatabase : RoomDatabase() {
    abstract fun userDao(): UserDao

    companion object {
        private var instance: AppDatabase? = null

        fun getInstance(context: Context): AppDatabase {
            return instance ?: synchronized(this) {
                instance ?: Room.databaseBuilder(
                    context.applicationContext,
                    AppDatabase::class.java, "app_database"
                ).addMigrations(MIGRATION_1_2).build().also { instance = it }
            }
        }
    }
}

Почему миграция обязательна?

Без миграции при изменении версии базы данных Room по умолчанию уничтожит старую базу и создаст новую, что приведет к потере всех пользовательских данных. Это неприемлемо для производственных приложений. Миграция позволяет:

• Сохранить целостность данных при обновлениях.
• Обеспечить обратную совместимость для пользователей со старыми версиями приложения.
• Выполнять сложные преобразования данных при необходимости (например, перенос данных в новую таблицу).

Лучшие практики для миграций

• Всегда увеличивайте версию базы данных при любом изменении схемы.
• Тестируйте миграции на реальных данных, используя инструменты Room, такие как androidx.room:room-testing.
• Для сложных миграций используйте поэтапные изменения через промежуточные версии.
• Избегайте удаления столбцов без необходимости — лучше помечать их как устаревшие.
• Используйте fallbackToDestructiveMigration() только в отладочных целях, но не в production-сборках.

Вывод

Миграция базы данных нужна всякий раз, когда вы изменяете схему базы данных в новой версии приложения. Это важнейший механизм для поддержания целостности данных и обеспечения плавного обновления для пользователей. Игнорирование миграций приводит к потере данных и негативному пользовательскому опыту, поэтому каждый Android-разработчик должен владеть этим инструментом в совершенстве.