數據庫版本如何單獨升級，并且將原有數據遷移過去

作者：Android架構師 2019-07-18 14:09:33

在我們開發的應用中，一般都會涉及到數據庫，使用數據的時候會涉及到數據庫的升級、數據的遷移、增加行的字段等。比如，用戶定制數據的保存，文件的端點續傳信息的保存等都會涉及到數據庫。

我們應用***個版本是V1.0，在迭代版本V1.1 時，我們在數據庫中增加了一個字段。因此V1.0的數據庫在V1.1版本需要升級，V1.0版本升級到V1.1時原來數據庫中的數據不能丟失，

那么在V1.1中就要有地方能夠檢測出來版本的差異，并且把V1.0軟件的數據庫升級到V1.1軟件能夠使用的數據庫。也就是說，要在V1.0軟件的數據庫的那個表中增加那個字段，并賦予這個字段默認值。應用中怎么檢測數據庫需要升級呢? SQLiteOpenHelper 類中有一個方法：

public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {}

當我們創建對象的時候如果傳入的版本號大于之前的版本號，該方法就會被調用，通過判斷oldVersion 和 newVersion 就可以決定如何升級數據庫。在這個函數中把老版本數據庫的相應表中增加字段，并給每條記錄增加默認值即可。新版本號和老版本號都會作為onUpgrade函數的參數傳進來，便于開發者知道數據庫應該從哪個版本升級到哪個版本。升級完成后，數據庫會自動存儲***的版本號為當前數據庫版本號。

數據庫升級

SQLite提供了ALTER TABLE命令，允許用戶重命名或添加新的字段到已有表中，但是不能從表中刪除字段。并且只能在表的末尾添加字段，比如,為Orders 表中添加一個字段：”ALTER TABLE Order ADDCOLUMN Country”

代碼如下：

public class OrderDBHelper extends SQLiteOpenHelper { 
private static final int DB_VERSION = 1; 
private static final String DB_NAME = "Test.db"; 
public static final String TABLE_NAME = "Orders"; 
public OrderDBHelper(Context context, int version) { 
 super(context, DB_NAME, null, version); 
} 
@Override 
public void onCreate(SQLiteDatabase db) { 
 String sql = "create table if not exists " + TABLE_NAME + " (Id integer primary key, " + 
 "CustomName text, OrderPrice integer)"; 
 db.execSQL(sql); 
} 
@Override 
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { 
 Log.e("owen", "DB onUpgrade"); 
 if (newVersion == 2) { 
 db.execSQL("ALTER TABLE " + TABLE_NAME + " ADD COLUMN Country"); 
 Cursor cr = db.rawQuery("select * from " + TABLE_NAME, null); 
 while (cr.moveToNext()) { 
 String name = cr.getString(cr.getColumnIndex("CustomName")); 
 ContentValues values = new ContentValues(); 
 values.put("CustomName", name); 
 values.put("Country", "China"); 
 db.update(TABLE_NAME, values, "CustomName=?", new String[] {name}); 
 } 
 cr.close(); 
 } 
} 
OrderDBHelper orderDBHelper = new OrderDBHelper(this, 2); 
SQLiteDatabase db = orderDBHelper.getWritableDatabase(); 
ContentValues contentValues = new ContentValues(); 
contentValues.put("OrderPrice", 100); 
contentValues.put("CustomName", "OwenChan"); 
db.insert(OrderDBHelper.TABLE_NAME, null, contentValues); 
Log.e("owen", "create finish"); 
Cursor cr = db.rawQuery("select * from " + OrderDBHelper.TABLE_NAME , null); 
while (cr.moveToNext()) { 
 String name = cr.getString(cr.getColumnIndex("CustomName")); 
 Log.e("owen", "name:" + name); 
 String country = cr.getString(cr.getColumnIndex("Country")); 
 Log.e("owen", "country:" + country); 
} 
cr.close(); 
db.close();

數據庫的遷移

可以分一下幾個步驟遷移數據庫。

1、將表名改成臨時表

ALTER TABLE Order RENAME TO _Order;

2、創建新表

CREATETABLE Test(Id VARCHAR(32) PRIMARY KEY ,CustomName VARCHAR(32) NOTNULL , Country VARCHAR(16) NOTNULL);

3、導入數據

INSERTINTO Order SELECT id, “”, Age FROM _Order;

4、刪除臨時表

DROPTABLE _Order;

通過以上四個步驟，就可以完成舊數據庫結構向新數據庫結構的遷移，并且其中還可以保證數據不會因為升級而流失。當然，如果遇到減少字段的情況，也可以通過創建臨時表的方式來實現。

實現代碼如下：

@Override 
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { 
 if (newVersion == 2) { 
 char str = '"'; 
 db.beginTransaction(); 
 db.execSQL("ALTER TABLE Order RENAME TO _Order"); 
 db.execSQL("CREATE TABLE Order(Id integer primary key autoincrement , CustomName VARCHAR(20) NOT NULL," 
 + " Country VARCHAR(32) NOT NULL , OrderPrice VARCHAR(16) NOT NULL)"); 
 db.execSQL("INSERT INTO Order SELECT Id, " + str + str 
 + ", CustomName, OrderPrice FROM _Order"); 
 db.setTransactionSuccessful(); 
 db.endTransaction(); 
 } 
}

多個數據庫版本的升級

假如我們開發的程序已經發布了兩個版本：V1.0，V2.0，我們正在開發V3.0。版本號分別是1，2，3。對于這種情況，我們應該如何實現升級? 用戶的選擇有：

V1.0 -> V3.0 DB 1 -> 2
V2.0 -> V3.0 DB 2 -> 3

數據庫的每一個版本所代表的數據庫必須是定義好的，比如說V1.0的數據庫，它可能只有兩張表TableA和TableB，如果V2.0要添加一張表TableC，如果V3.0要修改TableC，數據庫結構如下：

V1.0 —> TableA, TableB V1.2 —> TableA, TableB, TableC V1.3 —> TableA, TableB, TableC (Modify)

代碼如下：

@Override 
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { 
 if (1 == oldVersion) { 
 String sql = "Create table C...."; 
 db.execSQL(sql); 
 oldVersion = 2; 
 } 
 if (2 == oldVersion) { 
 //modify C 
 oldVersion = 3; 
 } 
}

導入已有數據庫：

/** 
 * Created by Owen Chan 
 * On 2017-09-26. 
 */ 
public class DbManager { 
 public static final String PACKAGE_NAME = "com.example.sql"; 
 public static final String DB_NAME = "table.db"; 
 public static final String DB_PATH = "/data/data/" + PACKAGE_NAME; 
 private Context mContext; 
 public DbManager(Context mContext) { 
 this.mContext = mContext; 
 } 
 public SQLiteDatabase openDataBase() { 
 return SQLiteDatabase.openOrCreateDatabase(DB_PATH + "/" + DB_NAME, null); 
 } 
 public void importDB() { 
 File file = new File(DB_PATH + "/" + DB_NAME); 
 if (!file.exists()) { 
 try { 
 FileOutputStream out = new FileOutputStream(file); 
 int buffer = 1024; 
 InputStream in = mContext.getResources().openRawResource(R.raw.xxxx); 
 byte[] bts = new byte[buffer]; 
 int lenght; 
 while ((lenght = in.read(bts)) > 0) { 
 out.write(bts, 0, bts.length); 
 } 
 out.close(); 
 in.close(); 
 } catch (Exception e) { 
 e.printStackTrace(); 
 } 
 } 
 } 
}

調用方式：

@Override 
protected void onResume() { 
 super.onResume(); 
 DbManager dbManager = new DbManager(this); 
 dbManager.importDB(); 
 SQLiteDatabase db = dbManager.openDataBase(); 
 db.execSQL("do what you want"); 
}

責任編輯：武曉燕來源：今日頭條

數據庫數據遷移