iOS APP新版本升级数据库

原文
iOS APP新版本升级数据库

我们常常会在APP中使用数据库，但是由于版本迭代问题，数据库的结构可能会发生变更，这时候需要对用户原始数据进行保留。这是一个很正常的需求，有人可能会简单粗暴的把数据库删除，重新创建，把数据重新插进去。如果表很多，里面只有一张表的数据结构发生变化了，这种做法真的好么？下面我会讲下我的思路，分享交流下。
简单的流程分析，共四步：
1 把要更改结构的那张表 A1 改名为 tempA1
2 创建一张当前版本需要结构的表A1
3 将tempA1 里面的有效数据 迁移到 A1中
4 删除 tempA1
以上简单的思路数据库就更改完毕了。
这时引出了第二个问题，如果用户的app没有及时更新，错过了好几个版本的数据库更改，以上数据库更改不可能会一步到位了。化简为繁，一步一步的更改数据库表结构，直到更改到最后一次。下面看代码。

typedef NS_ENUM(NSInteger, DBVersion) {
    DBVersionV1,
    DBVersionV2,    //历史版本
    DBVersionV3,    //当前版本
};

static NSString *const DBVersionNum  = @"DBVersionNum";
static NSString *const dbPath = @"\tmp\tmp.db";     //数据库地址

static NSString *const createTable = @"create table if not exists  t1("
"id  integer PRIMARY KEY AUTOINCREMENT NOT NULL,"
"name char(50),"
"sex char(4),"
"recordDate  TIMESTAMP default (datetime('now', 'localtime')))";

首先定义了一个枚举，标识着当前一共有多少数据库版本变更。（客户端数据库结构更改不会太频繁，如果更改太快，可能意味着初期表设计不合理），此次模拟共三个版本的数据库。

- (instancetype)init{
    if (self = [super init]) {
        _queue = [FMDatabaseQueue databaseQueueWithPath:dbPath];
    }
    return self;
}

采用FMDatabaseQueue 进行数据库操作的管理。

/*
 *  需要初始化表结构时，调用此方法
 */
- (void)newDBVersionInit{
    if (![[NSUserDefaults standardUserDefaults] objectForKey:DBVersionNum]) {
        //系统之前没有数据库 新建立表。
        [self createTables];
    }else{
        DBVersion ver = [[[NSUserDefaults standardUserDefaults] objectForKey:DBVersionNum] integerValue];
        switch (ver) {
            case DBVersionV1:{
                [self v1ToV2];
            }
            case DBVersionV2:{
                [self v2Tov3];
            }
            case DBVersionV3:{
                
            }
                break;
            default:
                break;
        }
    }
}

在这里判断DBVersionNum系统之前是否存储过，
没有存储说明是第一次安装，则进行首次创建表处理。
有说明之前数据库存在，进行数据库表结构更改。如果是v1版本的数据库 先从v1升级到v2，在从v2升级到v3，以此类推。

/*
 *  创建新表
 */
- (void)createTables{
    [_queue inTransaction:^(FMDatabase *db, BOOL *rollback) {
        @try {
            [db executeUpdate:createTable];
        }
        @catch (NSException *exception) {
            *rollback = YES;
        }
    }];
    [[NSUserDefaults standardUserDefaults] setObject:[NSNumber numberWithInteger:DBVersionV3] forKey:DBVersionNum];
}

把 DBVersionNum的值写为V3版本 方便下次对比。

/*
 *  版本1 向 版本2 数据迁移
 */
- (void)v1ToV2{
    
    [_queue inTransaction:^(FMDatabase *db, BOOL *rollback) {
        @try {
            
            //将原始表名T1 修改为 tempT1
            NSString *renameString = @"alter table t1 rename to tempT1";
            [db executeUpdate:renameString];
            
            //创建新表T1（V2版本的新表创建）
            [db executeUpdate:createTable];
            
            //迁移数据
            NSString *toString = @"insert into t1(name,sex)  select name,sex from tempT1";
            [db executeUpdate:toString];
            
            //删除tempT1临时表
            NSString *dropTableStr1 = @"drop table tempT1";
            [db executeUpdate:dropTableStr1];
        }
        @catch (NSException *exception) {
            *rollback = YES;
        }
    }] ;

    
    [[NSUserDefaults standardUserDefaults] setObject:[NSNumber numberWithInteger:DBVersionV2] forKey:DBVersionNum];
}


- (void)v2Tov3{
 [_queue inTransaction:^(FMDatabase *db, BOOL *rollback) {
//和 v1ToV2 流程一样
 }] ;
 [[NSUserDefaults standardUserDefaults] setObject:[NSNumber numberWithInteger:DBVersionV3] forKey:DBVersionNum];
}

上文提到的数据迁移流程就是如此。

参考文章：
iOS APP新版本升级数据库
iOS数据库版本升级问题