SQLite 数据库升级——新增字段处理总结

1、场景

在工做中，因为新需求老是不断，咱们常常会遇到项目中的一些表的结构要改变，好比最多见的就是 新增字段 了。这里我总结一下我遇到这种状况时的处理方法，SQLite 也有一些坑，但愿能帮到有一样需求的朋友们。下面我是用的 fmdb 进行的数据库操做，用原生或者其余工具的升级思想也是同样的。

2、升级操做

用户升级 app 时，当咱们判断到旧项目的版本号（或者数据库的单独版本号）小于某个版本号时，就进行咱们的升级操做。

一、新增普通字段

若是你要新增的是个普通字段，并非个 主键（后面会介绍什么状况下会新增主键），那就好办了，操做很简单，直接执行新增字段语句便可。

先复习一下 SQL 的 新增字段 语句： alter table mydownload add column 'IsFree' varchar(100) default '1' 其中的 column 能够省略，同时也能够不给 default 默认值。

下面是判断升级并进行新增操做的具体代码：

if (![dbPointer columnExists:@"LoginUserId" inTableWithName:@"mydownload"]) {
    // 若是不存在 LoginUserId 字段则执行添加 LoginUserId 语句，默认值是当前登陆的用户id
    NSString *addStr = [NSString stringWithFormat:@"alter table mydownload add column 'LoginUserId' varchar(100) default '%@'", [Global sharedGlobal].loginInfo.userId];
    if ([dbPointer executeUpdate:addStr]){
        DebugLog(@"添加 LoginUserId 字段成功！");
    } else {
        DebugLog(@"添加 LoginUserId 字段失败！");
    }
}
复制代码

⚠️ 注意： 这里要说一下，咱们的 SQLite 是个阉割的数据库，有不少数据库操做语句都是不支持的，好比不支持 批量增长字段，因此若是你要新增多个字段，那也只能一个一个的加了。

二、新增、修改主键或删除某字段

若是你新增的是个 主键。好比你想在之前的文章 id 为主键的的基础上，再新增一个用户 id，把文章 id 和用户 id 做为 联合主键，那此时就不能执行新增字段方法了，也是由于 SQLite 的限制，

⚠️ 注意： SQLite 限制了 ALTER TABLE 的部分功能，只能将列添加到表的末尾或更改表的名称。 若是要在表的结构中进行更复杂的更改，则必须 从新建立表。 您能够将现有数据保存到临时表，删除旧表，建立新表，而后从临时表中复制数据。

例如，假设您有一个名为“person”的表，其列名为“id”，“name”和“age”，而且您要今后表中删除列“age”。 如下 SQL 语句步骤说明了如何完成此操做：

BEGIN TRANSACTION;
CREATE TEMPORARY TABLE person_backup(id,name);
INSERT INTO person_backup SELECT id,name FROM person;
DROP TABLE person;
CREATE TABLE person(id,name);
INSERT INTO person SELECT id,name FROM person_backup;
DROP TABLE person_backup;
COMMIT;
复制代码

具体例子

下面再把我项目中具体的一个简略例子展现出来供你们参考： 原表状态： 原下载表 mydownload 只有两个字段 EpisodeId 和 DownloaderFilePath，主键是 EpisodeId 。下载的东西不跟随用户。 新需求： 如今要求下载的东西跟随用户走，即下载列表只展现当前用户下载的东西。这就须要新增一个 LoginUserId 用户 id 字段，把它和 EpisodeId 做为一个联合主键，这样下载的东西就能够和用户 id 绑定了。 具体代码操做：

if (![dbPointer columnExists:@"LoginUserId" inTableWithName:@"mydownload"]) {
        // 若是不存在 LoginUserId 字段则将原来的表更名
        [dbPointer beginTransaction];
        BOOL isRollBack = NO;
        @try {
            if ([dbPointer executeUpdate:@"ALTER TABLE mydownload RENAME TO temp_mydownload"]) {
                
                NSString *executeStr = @"CREATE TABLE mydownload (EpisodeId varchar(100), LoginUserId varchar(100),  DownloaderFilePath varchar(100),CONSTRAINT PK_mydownload PRIMARY KEY(EpisodeId,LoginUserId) )";
                
                if ([dbPointer executeUpdate:executeStr]) {
                    // 从旧数据表把旧数据插入新的数据表中
                    NSString *insertSql = [NSString stringWithFormat:@"INSERT INTO mydownload (EpisodeId,LoginUserId,DownloaderFilePath) select EpisodeId,'%@','1','',DownloaderFilePath from temp_mydownload", [Global sharedGlobal].loginInfo.userId];// 复制更名后的表到新建的表(注意:一列对应一列的进行复制,新增的字段能够用''来补)
                    if ([dbPointer executeUpdate:insertSql]) {
                        [dbPointer executeUpdate:@"drop table temp_mydownload"];// 删除旧表
                        
                        [[NSUserDefaults standardUserDefaults] setObject:@"YES" forKey:@"hasModifyDownloadDatabase"];// 标记已经升级过下载表
                    };
                    
                }
            }
        } @catch (NSException *exception) {
            isRollBack = YES;
            // 事务回退
            [dbPointer rollback];
        } @finally {
            if (!isRollBack) {
                // 事务提交
                [dbPointer commit];
            }
        }
        
    }
复制代码

以上的总结参考了并部分摘抄了如下文章，很是感谢如下做者的分享！：

一、《sqlite alter table添加多列》

二、《sqlite并不支持建表后修改主键，或删除列，若是要修改，请参考以下作法》

三、《FMDB数据库升级增长表字段》

转载请备注原文出处，不得用于商业传播——凡几多