iOS數(shù)據(jù)庫的遷移（CoreData，Realm，SQLite）

一、前言

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

二、CoreData

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

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

CoreData的遷移方式分為三種：

  • 輕量級的遷移
  • 默認的遷移方式
  • 遷移管理器

    2.1.輕量級遷移方式過程

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

2.在新的.xcdatamodel中新增一個字段，author字段


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


4.現(xiàn)在我們還需要將原來Book的表結構生成的Book.h、 Book.m、Book+CoreDataProperties.h、Book+CoreDataProperties.m替換成新的，Student同樣。 將原來的這四個文件直接刪除，然后再創(chuàng)建新的就可以了

xcode8 以后創(chuàng)建NSManagedObject

xcode8 創(chuàng)建的以后的文件格式會變成這樣，把原先的Book.h變成了Book+CoreDataClass.h文件，原先使用的Book.h現(xiàn)在全部改成Book+CoreDataClass.h。
我在原來的基礎上有插入100個數(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)建學生對象
        Student *stu = [[Student alloc] initWithEntity:entity insertIntoManagedObjectContext:context];
        stu.name = [NSString stringWithFormat:@"張三%d", i];
        NSEntityDescription *bEntity = [NSEntityDescription entityForName:@"Book" inManagedObjectContext:context];
        //創(chuàng)建Book對象
        Book *book = [[Book alloc] initWithEntity:bEntity insertIntoManagedObjectContext:context];
        book.title = @"紅樓夢";
        book.author = @"曹雪芹";
        //添加Book對象
        [stu addBooksObject:book];
        
        //保存Student對象
        [_appDelegate saveContext];
    }
    NSLog(@"save end");

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

遷移之前
遷移之后

2.2默認遷移

涉及表映射到另外一張表（實體）使用默認遷移
1.同輕量級遷移步驟1
2.在新的.xcdatamodel中將Book實體，修改兩個屬性名，增刪屬性

修改屬性名，新增一個字段并添加默認值

3.同輕量級遷移步驟3
4.同輕量級遷移步驟4
5.創(chuàng)建MappingModel，將之前的CoreData.xcdatamodel選作為Source，后面創(chuàng)建的CoreData2.xcdatamodel作為Target，前后不能選錯。

Source
Target

之后會生成一個.xcmappingmodel文件：

Mapping文件說明

運行新增100個遷移前后數(shù)據(jù)對比


遷移之前
遷移之后

2.2遷移管理器遷移

前面的兩種操作都是需要對表進行一次操作才能完成數(shù)據(jù)庫的遷移，包括插入數(shù)據(jù)，查詢數(shù)據(jù)都可以完成數(shù)據(jù)庫的遷移工作。這里的管理器遷移，不需要對表進行一次操作。
遷移管理器操作的前5個步驟和默認遷移的步驟一樣，只是不需要對表進行一次操作，我們需要做的是使用遷移器進行操作，操作的基本步驟就是先判斷是否需要遷移，這個里面有兩部分，一部分是本地是否有這個數(shù)據(jù)庫，一部分是在有數(shù)據(jù)庫的基礎上判斷存儲數(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;
    
    //比較存儲模型的元數(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];
        
        //這里可以注冊監(jiān)聽  NSMigrationManager 的 migrationProgress來查看進度
        [migrationManager addObserver:self forKeyPath:@"migrationProgress" options:NSKeyValueObservingOptionNew context:nil];
        
        //先把模型存錯到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

其實這里不用說的太啰嗦，遷移的方法github的例子里面有關于遷移的部分。這里有一點說明一下，在沒有完成遷移之前，只要對realm進行訪問都會崩潰，包括訪問數(shù)據(jù)庫的位置。我這里就簡單的做一下演示和說明：
1.我用之前的默認的realm創(chuàng)建了一個default.realm，打開文件，查看Student
表如下圖：

遷移之前

2.遷移代碼

  • 2.1刪除一個字段
- (void)excuteMigration {
    RLMMigrationBlock migratiobBlock = ^(RLMMigration *migration, uint64_t oldSchemaVersion) {
 //        你修改那個表就對那個進行枚舉
        if (oldSchemaVersion < 1) {
            [migration enumerateObjects:Student.className  block:^(RLMObject * _Nullable oldObject, RLMObject * _Nullable newObject) {
//                刪除一個屬性值  我們不需要任何操作 只需要修改模型即可
            }];
            
        }
//    獲取默認配置
    RLMRealmConfiguration *config = [RLMRealmConfiguration defaultConfiguration];
//    修改默認配置版本和遷移block 注意版本號的變化
    config.schemaVersion = 1;
    config.migrationBlock = migratiobBlock;
    [RLMRealmConfiguration setDefaultConfiguration:config];
//    執(zhí)行打開realm，完成遷移
    [RLMRealm defaultRealm];
}
  • 2.1.1 遷移之后
刪除一個字段之后的表
  • 2.2增加一個字段
- (void)excuteMigration {
    RLMMigrationBlock migratiobBlock = ^(RLMMigration *migration, uint64_t oldSchemaVersion) {
//        你修改那個表就對那個進行枚舉
        if (oldSchemaVersion < 1) {
            [migration enumerateObjects:Student.className  block:^(RLMObject * _Nullable oldObject, RLMObject * _Nullable newObject) {
//                刪除一個屬性值  我們不需要任何操作 只需要修改模型即可
            }];
            
        }
        
        //              在前面的基礎上新增一個字段，如果不需要默認值，可不加這句話，如果一個字段需要其他字段的協(xié)助，需要自行進行操作
        if (oldSchemaVersion < 2) {
            [migration enumerateObjects:Student.className  block:^(RLMObject * _Nullable oldObject, RLMObject * _Nullable newObject) {
                //這里給新增的字段添加一個默認值
                newObject[@"sex"] = @"男";
            }];
        }
    //    獲取默認配置
    RLMRealmConfiguration *config = [RLMRealmConfiguration defaultConfiguration];
//    修改默認配置版本和遷移block 注意版本號的變化
    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) {
//        你修改那個表就對那個進行枚舉
        if (oldSchemaVersion < 1) {
            [migration enumerateObjects:Student.className  block:^(RLMObject * _Nullable oldObject, RLMObject * _Nullable newObject) {
//                刪除一個屬性值  我們不需要任何操作 只需要修改模型即可
            }];
            
        }
        
        //              在前面的基礎上新增一個字段，如果不需要默認值，可不加這句話，如果一個字段需要其他字段的協(xié)助，需要自行進行操作
        if (oldSchemaVersion < 2) {
            [migration enumerateObjects:Student.className  block:^(RLMObject * _Nullable oldObject, RLMObject * _Nullable newObject) {
                //這里給新增的字段添加一個默認值
                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"]]);
                }
            }];
        }
    
    };
    //    獲取默認配置
    RLMRealmConfiguration *config = [RLMRealmConfiguration defaultConfiguration];
    //    修改默認配置版本和遷移block 注意版本號的變化
    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;  //這里表示一對多的關系
//
//@end
RLM_ARRAY_TYPE(Student)  //宏定義  定義RLMArray<Student>這個類型

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

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

//@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;  //這里表示一對多的關系

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

SQLite

關于SQLite數(shù)據(jù)庫的遷移涉及到iOS的基本全部是FMDB相關的一個三方庫FMDBMigrationManager，其實就是利用SQLite提供的ALTER TABLE命令來進行數(shù)據(jù)庫的遷移，關于SQLite數(shù)據(jù)庫遷移大家可以自行簡書相關FMDB的遷移，我在這里就不演示了，對比前面兩種的遷移方式，我感覺自己以后不會再用FMDB這個三方庫了。

總結

除非你們的數(shù)據(jù)庫設計特別完美，完全能滿足你們以后的版本迭代需求，你不需要進行數(shù)據(jù)庫的升級，但是這種情況也極少數(shù)發(fā)生，所以數(shù)據(jù)庫升級在所難免，都提前準備好自己需要使用那種，這里為你準備了一篇關于數(shù)據(jù)庫遷移的，歡迎收藏，歡迎吐槽。

最后編輯于 ：
?著作權歸作者所有,轉載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時請結合常識與多方信息審慎甄別。
平臺聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點，簡書系信息發(fā)布平臺，僅提供信息存儲服務。

相關閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容