當 SQLiteOpenHelper 建構子傳入的 newVersion 大於現有資料庫版本時,框架會自動呼叫 onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion)。此處即為執行結構遷移、資料轉換的最佳時機。
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
// 依版本號執行對應遷移邏輯
if (oldVersion < 2) {
// 例:新增欄位
db.execSQL("ALTER TABLE " + TABLE_NAME + " ADD COLUMN new_col INTEGER DEFAULT 0");
}
if (oldVersion < 3) {
// 例:建立新表、遷移資料
db.execSQL("CREATE TABLE new_table (...);");
db.execSQL("INSERT INTO new_table SELECT ... FROM old_table;");
db.execSQL("DROP TABLE old_table;");
}
// 更多版本遷移...
}
if (oldVersion < N) 連續判斷,確保從任意舊版本升級都能依序執行所有遷移。db.beginTransaction())保證原子性。VACUUM 整理空間。直接在 onUpgrade 中 DROP TABLE 重建會導致使用者資料遺失,除非確定資料可重新同步,否則應採用 ALTER TABLE 或建立新表遷移資料策略。