android sqlite数据库升级

随着我们系统的升级，数据库一般也要跟着一起变化。Android 中的 SQLite数据库根据数据库版本号来判断是否进行了升级。当数据库版本号发生变化后，Android 系统会调用 SQLiteOpenHelper 的
ouUpgrade 函数，然后我们在该函数中对版本号进行判断，再根据版本号执行对应的升级数据库的 SQL 语句。

数据库升级主要是调用SQLiteOpenHelper 中的onUpgrade方法

/**
 * Created by : xiaoyehai
 * Create date : 2019/9/11 20:33
 * description :数据库管理类,负责管理数据库的创建、升级工作
 */
public class MyDbHelper extends SQLiteOpenHelper {

    //数据库名字
    public static final String DB_NAME = "my.db";

    //数据库版本
    public static final int DB_VERSION = 1;

    public MyDbHelper(Context context) {
        super(context, DB_NAME, null, DB_VERSION);
    }

    /**
     * 在数据库首次创建的时候调用，创建表以及可以进行一些表数据的初始化
     *
     * @param db
     */
    @Override
    public void onCreate(SQLiteDatabase db) {
        //创建表
        //_id为主键并且自增长一般命名为_id
        String sql = "create table person(_id integer primary key autoincrement,name text)";
        db.execSQL(sql);

        //可以给表初始化一些数据
        //db.execSQL("insert into person(name) values('小米')");
    }

    /**
     * 数据库升级的时候回调该方法，在数据库版本号DB_VERSION升级的时候才会调用
     *
     * @param db
     * @param oldVersion
     * @param newVersion
     */
    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {

        //给表添加一个字段
        //db.execSQL("alter table person add age integer");
    }

    /**
     * 数据库打开的时候回调该方法
     *
     * @param db
     */
    @Override
    public void onOpen(SQLiteDatabase db) {
        super.onOpen(db);
        Log.e("xyh", "onOpen: ");
    }
}

在版本迭代的过程中，我们难免不了要去改变我们数据库的内容，此时就要考虑我们的数据库升级问题了，假如此时我们有个需求，要在新的版本中在数据库表中新加一个字段，首先我们要把DB_VERSION提升到加1，那么安装新版本APK的时候就会执行onUpdate()操作去执行更新操作，我们要考虑各个版本的情况，比如用户没有安装过1.0版本，直接安装的2.0版本，那么这种情况是不会执行onUpdate()方法的。

注意：数据库的版本号只能升级，不能降级，例如不能将数据库版本号从2降到1。

用户直接安装2.0版本（新用户）：只走onCreat()；不走onUpgrade()。

1.0 更新到2.0版本（老用户）：只走onUpgrade()，不走onCreat()。

先看下这时的处理有几种情况要考虑：

1. 在老表基础上新增字段

SQLite提供了ALTER TABLE命令，允许用户重命名或添加新的字段到已有表中，但是不能从表中删除字段。并且只能在表的末尾添加字段

新用户会直接走onCreate执行新表的创建sql，老用户走onUpgrade新增字段。

/**
     * 直接安装2.0版本,会走该方法
     * <p>
     * 要执行新表的创建sql(针对新用户)
     *
     * @param db
     */
    @Override
    public void onCreate(SQLiteDatabase db) {
        String sql = "create table person(_id integer primary key autoincrement,name text,age integer)";
        db.execSQL(sql);

    }

    /**
     * 1.0 更新到2.0版本,会走该方法
     *
     * @param db
     * @param oldVersion
     * @param newVersion
     */
    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        db.execSQL("alter table person add age integer");
    }

还有一种方式：

1. 将老表A改名变为临时表temp_A

2. 创建新表命名为A

3. 临时表temp_A数据导入新表

4. 删除临时表

当然，如果遇到减少字段的情况，也可以通过创建临时表的方式来实现。

@Override
    public void onCreate(SQLiteDatabase db) {
        String sql = "create table person(_id integer primary key autoincrement,name text,age integer)";
        db.execSQL(sql);


    }

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

        //老的表重命名
        String CREATE_TEMP_PPERSON = "alter table person rename to temp_person";

        //创建新的表，表名跟原来一样，并保留原来的字段和增加新的字段
        String CREATE_PPERSON  = "create table person(_id integer primary key autoincrement,name text,age integer)";
        
        //将重命名后的老表中的数据导入新的表中
        String INSERT_DATA = "insert into book select *,'' from _temp_book";
        
        //删除老表
        String DROP_PPERSON  = "drop table _temp_book";
        
        db.execSQL(CREATE_TEMP_PPERSON);
        db.execSQL(CREATE_PPERSON);
        db.execSQL(INSERT_DATA);
        db.execSQL(DROP_PPERSON);


    }

2. 新版本新增一张表

 @Override
    public void onCreate(SQLiteDatabase db) {
        String sql = "create table person(_id integer primary key autoincrement,name text,age integer)";
        db.execSQL(sql);
		
		//针对新用户
        String sql2 = "create table person2(_id integer primary key autoincrement,name text,age integer)";
        db.execSQL(sql2);

    }

    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        String sql = "create table person2(_id integer primary key autoincrement,name text,age integer)";
        db.execSQL(sql);

    }

3. 新表跟以前的表字段结构完全不一样

这种情况是新表跟以前字段结构完全不一样或者说有大部分的差异，老表改名为临时表，创建新表，手动查询老表的某些字段的数据然后插入的新表的对应字段，最后删除老表即可。这与上面在老表基础上新增字段的另外一种方式是一样的。

跨版本升级

前面几种情况是单级升级的时候，针对上次的版本本次的版本需要做的处理，如果是跨级升级，比如用户app很久没有更新了，这次升级数据库版本从1升到了3，应该先升级到2再升级到3这种情况，或者2升到了6，这时需要分开处理每次的版本：

 //数据库名字
    public static final String DB_NAME = "my.db";

    //数据库版本
    public static final int DB_VERSION = 3;

    public MyDbHelper(Context context) {
        super(context, DB_NAME, null, DB_VERSION);
    }

    @Override
    public void onCreate(SQLiteDatabase db) {

        //第一个版本安装，直接创建表
        //String sql = "create table person(_id integer primary key autoincrement,name text)";
        //db.execSQL(sql);

        // 若不是第一个版本安装，直接执行数据库升级
        // 请不要修改FIRST_DATABASE_VERSION的值，其为第一个数据库版本大小
        int FIRST_DB_VERSION = 1;
        onUpgrade(db, FIRST_DB_VERSION, DB_VERSION);
    }

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

        for (int i = oldVersion; i < newVersion; i++) {
            // 使用for实现跨版本升级数据库
            switch (oldVersion) {
                case 1:
                    upgradeToVersion2(db); //升级到2版本
                    break;
                case 2:
                    upgradeToVersion3(db); //升级到3版本
                    break;
                default:
                    break;
            }
        }
    }

    private void upgradeToVersion2(SQLiteDatabase db) {
        // 表新增1个字段
        db.execSQL("alter table person add age integer");
    }

    private void upgradeToVersion3(SQLiteDatabase db) {
        // student 表新增2个字段, 添加新字段只能一个字段一个字段加，sqlite有限制不予许一条语句加多个字段
    }

如果用户是从1.0升到2.0的，那么会直接执行onUpdate()，此时oldVersion是1，执行for循环中的 upgradeToVersion2(db)，如果用户没有装过1.0版本而是直接安装的2.0版本，那么会执行onCreate()方法，在onCreate()中手动调用的onUpdate()方法去执行更新操作，这样就兼容到了各种需求，同时升级到3.0、4.0版本都是可以兼容的。

但是如果版本跨级比较多，这个地方可能比较费时了，建议在可控的版本差之内强制app版本升级。