CoreData 从入门到精通（六）模型版本和数据迁移

前面几篇文章中讲的所有内容，都是在同一个模型版本上进行操作的。但在真实开发中，基本上不会一直停留在一个版本上，因为需求是不断变化的，说不定什么时候就需要往模型里添加新的字段，添加新的模型，甚至是大规模的重构；所以数据的迁移就显得尤为重要了。
CoreData 中，数据迁移本质就是把旧的 SQLite 数据库里的内容，复制到新的 SQLite 数据库里去，让新的数据库作为默认的数据存储。伴随着模型版本的变化，新旧两个数据库的实体结构当然也是不同的。这就是说在迁移过程中必须知道新旧两个数据库的模型对应关系，旧数据库里的数据该怎么复制到新的数据库中。这在 CoreData 中是由 MappingModel 映射模型来决定的。我们所需要做的就是创建 MappingModel 文件，指定好实体不同版本间的映射，CoreData 就会自动帮我们完成数据迁移。当然如果模型版本的变化比较小，CoreData 是可以自动推断出映射模型的。下面就来详细的介绍一下 CoreData 里常用的几种迁移。

创建模型版本

在介绍数据迁移之前，先来看如何创建新的模型版本，在 Xcode 里模型是通过 .xcdatamodeld 文件来创建的，实际上这个文件就是一个包，里面可以包含不同的模型版本。选中这个文件，然后点击 Editor->Add Model Version… 就可以添加一个新的模型版本。

然后会弹出下面这个对话框，默认的新的模型会在原来的基础上增加一个数字，来标识不同的模型版本。这个数字也是可以更改的，你可以按照自己的喜好更改成 v2 或者其他的。

点击 finish 后就会看到现在的 LearnCoreData.xcdatamodeld文件可以展开了，里面包含了所有的模型版本文件，它们是 xcdatamodel 格式的。在右侧的 File Inspector 面板中可以指定当前的模型版本,然后程序打包后就会把选中的模型版本作为当前的默认版本。

自动推断映射模型

上面说到对于一些较小的变化，CoreData 是可以自动推断映射模型的，从而帮助我们自动地完成数据迁移。针对下面这些改动，CoreData 都可以自动的进行推断：
* 添加一个属性
* 移除一个属性
* 非空的属性变成可以为空的
* 可以为空的属性变成非空属性并设置一个默认值
* 重命名实体或者属性（需要设置 renaming identifier）
* 添加/删除 RelationShip
* 重命名 RelationShip（需要设置 renaming identifier）
* 把一个 RelationShip 从 对一改成对多，或者把非排序的改成排序的。（反过来也是可以的）

上面说到的 renaming identifier 可以在 Model Inspector 进行设置，对不同版本的对应实体/属性设置相同的 Renaming ID，CoreData 就可以自动推断出对应的映射模型。

除此之外，在向 persistentStoreCoordinator 调用 addPersistentStoreWithType:configuration:URL:options:error: 添加 persistentStore时，需要将 options 的 NSMigratePersistentStoresAutomaticallyOption 和 NSInferMappingModelAutomaticallyOption 两个 key 设置为 YES，CoreData 才会自动推断。

下面我们来看一下，怎么使用自动推断。这是初始版本的 StudentEntity 实体的结构：

下面我们再创建一个 Model Version，把原来的 StudentEntity、ClassEntity、CourseEntity 的 EntityName 分别修改成 Student、Clazz、Course；Student 里面的字段修改成 name、id 和 age，另外再添加一个 BOOL 字段 sex，表示性别，默认值设置为 YES。

然后为两个版本中修改过的实体名字和属性字段名字设置相同的 renaming identifier。以 Student 的 name 字段为例，旧版的模型中：

然后新版本的模型中：

修改好后，暂时我们先不切换到新版本的模型中，先用旧的数据库生成一些测试数据，然后在沙盒的 Library/Application Support/ 目录里复制出里边的三个文件，然后用 SQLite 工具打开 .sqlite 的数据库文件查看数据库的的结构，和刚存进去的内容。

这是打开后的 StudentEntity 表，里面随机插入了 300 条数据，注意到现在由我们创建的几个字段分别是 ZSTUDENTID、ZSTUDENTCLASS、ZSTUDENTNAME。

现在我们把数据库切换到新版中，然后再运行一次程序，重新打开新生成的数据库文件，就会看到新版的数据库的结构：

现在 StudentEntity 已经变成了 Student，每个字段也都变成了新的字段名，而且里面也多了我们添加的 sex 字段。这就说明 CoreData 的自动推断成功了。

自定义映射模型

大多数情况下自动推断就能帮我们完成数据的迁移，但当数据的变化更复杂时，例如如果我们把 Student 里的一个字段提取出来放到一个新的字段中去。就得靠我们手动创建 mapping model 了。例如我们现在想把上面 Clazz 表删除，原来的 Student 中的 clazz 字段用 clazzName 字段来代替。那么这种情况下就需要手动来创建 mapping model 了。
在这之前我们先用旧版的数据模型插入一些示例的数据，这是插入的 Student 数据：

Clazz 数据：

Course 数据：

因为 Course 和 Student 是多对多的关系，所以还会有一张关联表：

这是插入示例数据的代码：

- (void)insertManyStudents {
    NSSet *science = [self scienceCourses];
    NSSet *art = [self artCourses];
    Clazz *clazz1 = [[Clazz alloc] initWithContext:self.persistentContainer.viewContext];
    clazz1.clazzName = @"文科一班";
    clazz1.classId = 1;

    Clazz *clazz2 = [[Clazz alloc] initWithContext:self.persistentContainer.viewContext];
    clazz2.clazzName = @"理科一班";
    clazz2.classId = 2;
    for (NSUInteger i = 0; i < 300; i++) {
   
        NSString *name = [NSString stringWithFormat:@"student-%u", arc4random_uniform(100000)];
        int16_t age = (int16_t)arc4random_uniform(10) + 10;
        int16_t stuId = (int16_t)arc4random_uniform(INT16_MAX);
        Student *student = [NSEntityDescription insertNewObjectForEntityForName:@"Student" inManagedObjectContext:self.persistentContainer.viewContext];
        student.name = name;
        student.age = age;
        student.id = stuId;
        if (i % 2 == 0) {
            student.clazz = clazz1;
            student