萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android SQLite 資料庫版本升級偵測:onUpgrade() 方法實作指南

onUpgrade() 觸發時機

當 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) 連續判斷,確保從任意舊版本升級都能依序執行所有遷移。
  • 遷移邏輯盡量用 SQL 批次執行,避免逐筆處理導致 ANR。
  • 重要資料變更前先備份或採用交易(db.beginTransaction())保證原子性。
  • 遷移完成後可選擇性執行 VACUUM 整理空間。

常見誤區

直接在 onUpgrade 中 DROP TABLE 重建會導致使用者資料遺失,除非確定資料可重新同步,否則應採用 ALTER TABLE 或建立新表遷移資料策略。

copyright © 萬盛學電腦網 all rights reserved