iOS數(shù)據(jù)庫的遷移(CoreData偿凭,Realm产弹,SQLite)

一、前言

以前寫過一篇關(guān)于CoreData弯囊,Realm取视,SQLite的文章(文章鏈接),里面大概就是介紹了一下它們的用法和推薦的三方庫常挚,建議再看這篇文章之前可以瀏覽一下之前的那篇文章。今天在這里我就來說一下關(guān)于它們的數(shù)據(jù)庫遷移問題稽物,數(shù)據(jù)庫的遷移都是非嵌套的遷移方式奄毡,這樣就可以避免有的用戶沒有及時(shí)更新帶來的隱患。

二贝或、CoreData

CoreData需要遷移的時(shí)候需要在
- (nullable __kindof NSPersistentStore *)addPersistentStoreWithType:(NSString *)storeType configuration:(nullable NSString *)configuration URL:(nullable NSURL *)storeURL options:(nullable NSDictionary *)options error:(NSError **)error
這個(gè)方法里面的options參數(shù)添加兩個(gè)key-value
NSDictionary *options = @{NSMigratePersistentStoresAutomaticallyOption:@(YES), NSInferMappingModelAutomaticallyOption:@(YES)};

NSMigratePersistentStoresAutomaticallyOption = YES吼过,那么Core Data會(huì)試著把之前低版本的出現(xiàn)不兼容的持久化存儲(chǔ)區(qū)遷移到新的模型中,這里的例子里咪奖,Core Data就能識(shí)別出是新表
NSInferMappingModelAutomaticallyOption = YES,這個(gè)參數(shù)的意義是Core Data會(huì)根據(jù)自己認(rèn)為最合理的方式去嘗試MappingModel盗忱,從源模型實(shí)體的某個(gè)屬性,映射到目標(biāo)模型實(shí)體的某個(gè)屬性羊赵。

CoreData的遷移方式分為三種:

  • 輕量級(jí)的遷移
  • 默認(rèn)的遷移方式
  • 遷移管理器

    2.1.輕量級(jí)遷移方式過程

    1.選中.xcdatamodeld文件趟佃,然后選擇Editor-->add Model Version

2.在新的.xcdatamodel中新增一個(gè)字段,author字段


3.然后選擇.xcdatamodeld 選擇Model Version


4.現(xiàn)在我們還需要將原來Book的表結(jié)構(gòu)生成的Book.h昧捷、 Book.m闲昭、Book+CoreDataProperties.h、Book+CoreDataProperties.m替換成新的靡挥,Student同樣序矩。 將原來的這四個(gè)文件直接刪除,然后再創(chuàng)建新的就可以了

xcode8 以后創(chuàng)建NSManagedObject

xcode8 創(chuàng)建的以后的文件格式會(huì)變成這樣跋破,把原先的Book.h變成了Book+CoreDataClass.h文件簸淀,原先使用的Book.h現(xiàn)在全部改成Book+CoreDataClass.h瓶蝴。
我在原來的基礎(chǔ)上有插入100個(gè)數(shù)據(jù),插入代碼:

NSManagedObjectContext *context = self.appDelegate.managedObjectContext;
    NSLog(@"save start");
    for (int i = 0; i < 100; i++) {
        NSEntityDescription *entity = [NSEntityDescription entityForName:@"Student" inManagedObjectContext:context];
        //創(chuàng)建學(xué)生對(duì)象
        Student *stu = [[Student alloc] initWithEntity:entity insertIntoManagedObjectContext:context];
        stu.name = [NSString stringWithFormat:@"張三%d", i];
        NSEntityDescription *bEntity = [NSEntityDescription entityForName:@"Book" inManagedObjectContext:context];
        //創(chuàng)建Book對(duì)象
        Book *book = [[Book alloc] initWithEntity:bEntity insertIntoManagedObjectContext:context];
        book.title = @"紅樓夢(mèng)";
        book.author = @"曹雪芹";
        //添加Book對(duì)象
        [stu addBooksObject:book];
        
        //保存Student對(duì)象
        [_appDelegate saveContext];
    }
    NSLog(@"save end");

5.前后數(shù)據(jù)庫對(duì)比

遷移之前
遷移之后

2.2默認(rèn)遷移

涉及表映射到另外一張表(實(shí)體)使用默認(rèn)遷移
1.同輕量級(jí)遷移步驟1
2.在新的.xcdatamodel中將Book實(shí)體租幕,修改兩個(gè)屬性名舷手,增刪屬性

修改屬性名,新增一個(gè)字段并添加默認(rèn)值

3.同輕量級(jí)遷移步驟3
4.同輕量級(jí)遷移步驟4
5.創(chuàng)建MappingModel令蛉,將之前的CoreData.xcdatamodel選作為Source聚霜,后面創(chuàng)建的CoreData2.xcdatamodel作為Target,前后不能選錯(cuò)珠叔。

Source
Target

之后會(huì)生成一個(gè).xcmappingmodel文件:

Mapping文件說明

運(yùn)行新增100個(gè)遷移前后數(shù)據(jù)對(duì)比


遷移之前
遷移之后

2.2遷移管理器遷移

前面的兩種操作都是需要對(duì)表進(jìn)行一次操作才能完成數(shù)據(jù)庫的遷移蝎宇,包括插入數(shù)據(jù),查詢數(shù)據(jù)都可以完成數(shù)據(jù)庫的遷移工作祷安。這里的管理器遷移姥芥,不需要對(duì)表進(jìn)行一次操作。
遷移管理器操作的前5個(gè)步驟和默認(rèn)遷移的步驟一樣汇鞭,只是不需要對(duì)表進(jìn)行一次操作凉唐,我們需要做的是使用遷移器進(jìn)行操作,操作的基本步驟就是先判斷是否需要遷移霍骄,這個(gè)里面有兩部分台囱,一部分是本地是否有這個(gè)數(shù)據(jù)庫,一部分是在有數(shù)據(jù)庫的基礎(chǔ)上判斷存儲(chǔ)數(shù)據(jù)的元數(shù)據(jù)(NSManagedObjectModel)读整,具體操作的代碼如下:
1.是否需要遷移

- (BOOL)judgeDataMigrationIsNeed {
    //是否存在文件
    NSURL *storeURL = [[[[NSFileManager defaultManager] URLsForDirectory:NSDocumentDirectory inDomains:NSUserDomainMask] lastObject] URLByAppendingPathComponent:@"CoreDataTest.sqlite"];
    if (![[NSFileManager defaultManager] fileExistsAtPath:storeURL.path]) {
        return NO;
    }
    NSError *error = nil;
    
    //比較存儲(chǔ)模型的元數(shù)據(jù)簿训。
    NSDictionary *sourceMataData = [NSPersistentStoreCoordinator metadataForPersistentStoreOfType:NSSQLiteStoreType URL:storeURL error:&error];
    NSManagedObjectModel *destinationModel = _appDelegate.managedObjectModel;
    if ([destinationModel isConfiguration:nil compatibleWithStoreMetadata:sourceMataData]) {
        return NO;
    }
    return YES;
}

2.遷移器遷移數(shù)據(jù)具體代碼

- (BOOL)executeMigration {
    BOOL success = NO;
    NSError *error = nil;
    
    NSURL *sourceStore = [[[[NSFileManager defaultManager] URLsForDirectory:NSDocumentDirectory inDomains:NSUserDomainMask] lastObject] URLByAppendingPathComponent:@"CoreDataTest.sqlite"];
    
    //原來的數(shù)據(jù)模型的原信息
    NSDictionary *sourceMetadata = [NSPersistentStoreCoordinator metadataForPersistentStoreOfType:NSSQLiteStoreType URL:sourceStore error:&error];
    //原數(shù)據(jù)模型
    NSManagedObjectModel *sourceModel = [NSManagedObjectModel mergedModelFromBundles:nil forStoreMetadata:sourceMetadata];
    
    //最新版數(shù)據(jù)模型
    NSManagedObjectModel *destinModel = _appDelegate.managedObjectModel;
    
    //數(shù)據(jù)遷移的映射模型
    NSMappingModel *mappingModel = [NSMappingModel mappingModelFromBundles:nil
                                                            forSourceModel:sourceModel
                                                          destinationModel:destinModel];
    if (mappingModel) {
        NSError *error = nil;
        
        //遷移管理器
        NSMigrationManager *migrationManager = [[NSMigrationManager alloc]initWithSourceModel:sourceModel
                                                                             destinationModel:destinModel];
        
        //這里可以注冊(cè)監(jiān)聽  NSMigrationManager 的 migrationProgress來查看進(jìn)度
        [migrationManager addObserver:self forKeyPath:@"migrationProgress" options:NSKeyValueObservingOptionNew context:nil];
        
        //先把模型存錯(cuò)到Temp.sqlite
        NSURL *destinStore = [[[[NSFileManager defaultManager] URLsForDirectory:NSDocumentDirectory inDomains:NSUserDomainMask] lastObject] URLByAppendingPathComponent:@"Temp.sqlite"];
        success = [migrationManager migrateStoreFromURL:sourceStore
                                                    type:NSSQLiteStoreType
                                                 options:nil
                                        withMappingModel:mappingModel
                                        toDestinationURL:destinStore
                                         destinationType:NSSQLiteStoreType
                                      destinationOptions:nil
                                                   error:&error];
        if (success) {
            //替換掉原來的舊的文件
            success = [[NSFileManager defaultManager] replaceItemAtURL:sourceStore withItemAtURL:destinStore backupItemName:@"backup.sqlite" options:NSFileManagerItemReplacementUsingNewMetadataOnly | NSFileManagerItemReplacementWithoutDeletingBackupItem resultingItemURL:nil error:nil];
            if (success) {
                //                這里移除監(jiān)聽就可以了值桩。
                [migrationManager removeObserver:self forKeyPath:@"migrationProgress"];
            }
        }
    }
    return success;
}
遷移之前
遷移之后

Realm

其實(shí)這里不用說的太啰嗦犯建,遷移的方法github的例子里面有關(guān)于遷移的部分注祖。這里有一點(diǎn)說明一下据块,在沒有完成遷移之前向挖,只要對(duì)realm進(jìn)行訪問都會(huì)崩潰蔬蕊,包括訪問數(shù)據(jù)庫的位置晰筛。我這里就簡(jiǎn)單的做一下演示和說明:
1.我用之前的默認(rèn)的realm創(chuàng)建了一個(gè)default.realm谨究,打開文件逻锐,查看Student
表如下圖:

遷移之前

2.遷移代碼

  • 2.1刪除一個(gè)字段
- (void)excuteMigration {
    RLMMigrationBlock migratiobBlock = ^(RLMMigration *migration, uint64_t oldSchemaVersion) {
 //        你修改那個(gè)表就對(duì)那個(gè)進(jìn)行枚舉
        if (oldSchemaVersion < 1) {
            [migration enumerateObjects:Student.className  block:^(RLMObject * _Nullable oldObject, RLMObject * _Nullable newObject) {
//                刪除一個(gè)屬性值  我們不需要任何操作 只需要修改模型即可
            }];
            
        }
//    獲取默認(rèn)配置
    RLMRealmConfiguration *config = [RLMRealmConfiguration defaultConfiguration];
//    修改默認(rèn)配置版本和遷移block 注意版本號(hào)的變化
    config.schemaVersion = 1;
    config.migrationBlock = migratiobBlock;
    [RLMRealmConfiguration setDefaultConfiguration:config];
//    執(zhí)行打開realm夫晌,完成遷移
    [RLMRealm defaultRealm];
}
  • 2.1.1 遷移之后
刪除一個(gè)字段之后的表
  • 2.2增加一個(gè)字段
- (void)excuteMigration {
    RLMMigrationBlock migratiobBlock = ^(RLMMigration *migration, uint64_t oldSchemaVersion) {
//        你修改那個(gè)表就對(duì)那個(gè)進(jìn)行枚舉
        if (oldSchemaVersion < 1) {
            [migration enumerateObjects:Student.className  block:^(RLMObject * _Nullable oldObject, RLMObject * _Nullable newObject) {
//                刪除一個(gè)屬性值  我們不需要任何操作 只需要修改模型即可
            }];
            
        }
        
        //              在前面的基礎(chǔ)上新增一個(gè)字段,如果不需要默認(rèn)值昧诱,可不加這句話慷丽,如果一個(gè)字段需要其他字段的協(xié)助,需要自行進(jìn)行操作
        if (oldSchemaVersion < 2) {
            [migration enumerateObjects:Student.className  block:^(RLMObject * _Nullable oldObject, RLMObject * _Nullable newObject) {
                //這里給新增的字段添加一個(gè)默認(rèn)值
                newObject[@"sex"] = @"男";
            }];
        }
    //    獲取默認(rèn)配置
    RLMRealmConfiguration *config = [RLMRealmConfiguration defaultConfiguration];
//    修改默認(rèn)配置版本和遷移block 注意版本號(hào)的變化
    config.schemaVersion = 2;
    config.migrationBlock = migratiobBlock;
    [RLMRealmConfiguration setDefaultConfiguration:config];
    //    執(zhí)行打開realm鳄哭,完成遷移
    [RLMRealm defaultRealm];
}
  • 2.2.1遷移之后
遷移之后
  • 2.3字段類型的變化
- (void)excuteMigration {
    RLMMigrationBlock migratiobBlock = ^(RLMMigration *migration, uint64_t oldSchemaVersion) {
//        你修改那個(gè)表就對(duì)那個(gè)進(jìn)行枚舉
        if (oldSchemaVersion < 1) {
            [migration enumerateObjects:Student.className  block:^(RLMObject * _Nullable oldObject, RLMObject * _Nullable newObject) {
//                刪除一個(gè)屬性值  我們不需要任何操作 只需要修改模型即可
            }];
            
        }
        
        //              在前面的基礎(chǔ)上新增一個(gè)字段要糊,如果不需要默認(rèn)值,可不加這句話,如果一個(gè)字段需要其他字段的協(xié)助锄俄,需要自行進(jìn)行操作
        if (oldSchemaVersion < 2) {
            [migration enumerateObjects:Student.className  block:^(RLMObject * _Nullable oldObject, RLMObject * _Nullable newObject) {
                //這里給新增的字段添加一個(gè)默認(rèn)值
                newObject[@"sex"] = @"男";
            }];
        }
        
        if (oldSchemaVersion < 3) {
            [migration enumerateObjects:Student.className  block:^(RLMObject * _Nullable oldObject, RLMObject * _Nullable newObject) {
                if (oldObject && oldObject.objectSchema[@"sex"].type == RLMPropertyTypeString) {
                    newObject[@"sex"] = @([Student sexTypeForString:oldObject[@"sex"]]);
                }
            }];
        }
    
    };
    //    獲取默認(rèn)配置
    RLMRealmConfiguration *config = [RLMRealmConfiguration defaultConfiguration];
    //    修改默認(rèn)配置版本和遷移block 注意版本號(hào)的變化
    config.schemaVersion = 3;
    config.migrationBlock = migratiobBlock;
    [RLMRealmConfiguration setDefaultConfiguration:config];
    //    執(zhí)行打開realm局劲,完成遷移
    [RLMRealm defaultRealm];
}
  • 2.3.1執(zhí)行之后
遷移之后

*3.Student模型變化

#import <Realm/Realm.h>
#import "Book.h"
// V0
//@interface Student : RLMObject
//@property int num;
//@property NSString *name;
//@property int age;
//@property RLMArray<Book *><Book> *books;  //這里表示一對(duì)多的關(guān)系
//
//@end
RLM_ARRAY_TYPE(Student)  //宏定義  定義RLMArray<Student>這個(gè)類型

//V1
//@interface Student : RLMObject
//@property int num;
//@property NSString *name;
//@property RLMArray<Book *><Book> *books;  //這里表示一對(duì)多的關(guān)系
//
//@end

//V2
//@interface Student : RLMObject
//@property int num;
//@property NSString *name;
//@property NSString *sex;
//@property RLMArray<Book *><Book> *books;  //這里表示一對(duì)多的關(guān)系

//@end


//V3
typedef NS_ENUM(NSInteger, Sex) {
    Unknow = 0,
    Male,
    Female
};

@interface Student : RLMObject
@property int num;
@property NSString *name;
@property Sex sex;
@property RLMArray<Book *><Book> *books;  //這里表示一對(duì)多的關(guān)系

+ (Sex)sexTypeForString:(NSString *)typeString;
@end

SQLite

關(guān)于SQLite數(shù)據(jù)庫的遷移涉及到iOS的基本全部是FMDB相關(guān)的一個(gè)三方庫FMDBMigrationManager,其實(shí)就是利用SQLite提供的ALTER TABLE命令來進(jìn)行數(shù)據(jù)庫的遷移奶赠,關(guān)于SQLite數(shù)據(jù)庫遷移大家可以自行簡(jiǎn)書相關(guān)FMDB的遷移鱼填,我在這里就不演示了,對(duì)比前面兩種的遷移方式毅戈,我感覺自己以后不會(huì)再用FMDB這個(gè)三方庫了苹丸。

總結(jié)

除非你們的數(shù)據(jù)庫設(shè)計(jì)特別完美,完全能滿足你們以后的版本迭代需求苇经,你不需要進(jìn)行數(shù)據(jù)庫的升級(jí)赘理,但是這種情況也極少數(shù)發(fā)生,所以數(shù)據(jù)庫升級(jí)在所難免扇单,都提前準(zhǔn)備好自己需要使用那種商模,這里為你準(zhǔn)備了一篇關(guān)于數(shù)據(jù)庫遷移的,歡迎收藏蜘澜,歡迎吐槽施流。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市鄙信,隨后出現(xiàn)的幾起案子瞪醋,更是在濱河造成了極大的恐慌,老刑警劉巖装诡,帶你破解...
    沈念sama閱讀 217,277評(píng)論 6 503
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件趟章,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡慎王,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,689評(píng)論 3 393
  • 文/潘曉璐 我一進(jìn)店門宏侍,熙熙樓的掌柜王于貴愁眉苦臉地迎上來赖淤,“玉大人,你說我怎么就攤上這事谅河≡酆担” “怎么了?”我有些...
    開封第一講書人閱讀 163,624評(píng)論 0 353
  • 文/不壞的土叔 我叫張陵绷耍,是天一觀的道長(zhǎng)吐限。 經(jīng)常有香客問我,道長(zhǎng)褂始,這世上最難降的妖魔是什么诸典? 我笑而不...
    開封第一講書人閱讀 58,356評(píng)論 1 293
  • 正文 為了忘掉前任,我火速辦了婚禮崎苗,結(jié)果婚禮上狐粱,老公的妹妹穿的比我還像新娘舀寓。我一直安慰自己,他們只是感情好肌蜻,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,402評(píng)論 6 392
  • 文/花漫 我一把揭開白布互墓。 她就那樣靜靜地躺著,像睡著了一般蒋搜。 火紅的嫁衣襯著肌膚如雪篡撵。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,292評(píng)論 1 301
  • 那天豆挽,我揣著相機(jī)與錄音育谬,去河邊找鬼。 笑死祷杈,一個(gè)胖子當(dāng)著我的面吹牛斑司,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播但汞,決...
    沈念sama閱讀 40,135評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼宿刮,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來了私蕾?” 一聲冷哼從身側(cè)響起僵缺,我...
    開封第一講書人閱讀 38,992評(píng)論 0 275
  • 序言:老撾萬榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎踩叭,沒想到半個(gè)月后磕潮,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 45,429評(píng)論 1 314
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡容贝,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,636評(píng)論 3 334
  • 正文 我和宋清朗相戀三年自脯,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片斤富。...
    茶點(diǎn)故事閱讀 39,785評(píng)論 1 348
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡膏潮,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出满力,到底是詐尸還是另有隱情焕参,我是刑警寧澤,帶...
    沈念sama閱讀 35,492評(píng)論 5 345
  • 正文 年R本政府宣布油额,位于F島的核電站叠纷,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏潦嘶。R本人自食惡果不足惜涩嚣,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,092評(píng)論 3 328
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧缓艳,春花似錦校摩、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,723評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至溪窒,卻和暖如春坤塞,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背澈蚌。 一陣腳步聲響...
    開封第一講書人閱讀 32,858評(píng)論 1 269
  • 我被黑心中介騙來泰國(guó)打工摹芙, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人宛瞄。 一個(gè)月前我還...
    沈念sama閱讀 47,891評(píng)論 2 370
  • 正文 我出身青樓浮禾,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親份汗。 傳聞我的和親對(duì)象是個(gè)殘疾皇子盈电,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,713評(píng)論 2 354

推薦閱讀更多精彩內(nèi)容