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

 

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

​ 我們應用第一個版本是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。對於這種情況，我們應該如何實現升級？ 用戶的選擇有：

1. V1.0 -> V3.0 DB 1 -> 2
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");
}

扣扣掃碼加入粉交流羣，可領取福利