在之前的文章里,我们看到了 EF Core 2.0 的新特性和槽点。今天,我们来看一看EF Core 的突破性变更。
不支持EF Core 1.x 数据库驱动器
EF 通过数据库驱动器为 SQL Server、MySQL 等数据库生成 SQL。EF 没有通用的 OleDB 或 ODBC 驱动器,所以只能使用专门为它创建的数据库驱动器。
为了简化数据库驱动器的开发,EF Core 更改了驱动器 API,不再提供向后兼容的能力。这意味着 EF Core 1.0 和 1.1 的驱动器不再受 EF Core 2.0 的支持,如果要继续使用它们,必须基于 EF Core 2.0 的 API 对它们进行重写。
根据微软所述,“ SQL Compact 、 PostgreSQL 和 MySQL 的第三方开源数据库驱动器正在升级到 2.0”。如果使用了其他数据库,需要自行联系驱动器开发者。
IDbContextFactory 被重命名为 IDesignTimeDBContextFactory
IDbContextFactory 类不应该被作为 DbContext 工厂类来使用,虽然它的名字看起来有这个意味。实际上,这个类本应被用在设计工具里,设计工具在生成数据库迁移脚本时需要用到 DbContext 对象。
为了避免混淆,IDbContextFactory 被标记为“过时”的,设计工具可以改为调用 IDesignTimeDBContextFactory。
与此相关的另一个变更是停止对 DbContextFactoryOptions 的支持,这个类不适用于设计时上下文的生成。
日志和诊断事件的变更
EF Core 的日志和诊断事件变更包括:
- 发送给 ILogger 的消息事件 ID 发生了变化。事件 ID 在整个 EF Core 里是唯一的,而且消息遵循了 MVC 所使用的结构化日志标准模式。
- 日志类别也发生了变化。现在可以通过 DbLoggerCategory 访问到各种日志类别。
- DiagnosticSource 使用了与相应 ILogger 消息相同的事件 ID。事件内容均为派生自 EventData 的标准类型。
虽说上面列出的都算得上是突破性的变更,但微软希望它们不会对现有的应用程序造成太大的影响。
内存数据库必须指定名字
在进行性能测试时,创建内存数据库是非常重要的一个辅助手段。虽然这并不能反映应用程序在生产环境的真实行为,但在诊断业务逻辑时还是很有用的。
EF Core 之前可以支持一个全局的匿名内存数据库,但现在要求开发人员必须为创建的每一个内存数据库命名。不过,同一个内存数据库仍然可以被多个上下文实例所共享。
只读 API 的变更
EF Core 停止支持由 IProperty 接口暴露出来的 IsReadOnlyBeforeSave、IsReadOnlyAfterSave 和 IsStoreGeneratedAlways。它们被 IProperty 的 BeforeSaveBehavior 和 AfterSaveBehavior 所取代。文档里写道:
被标记为 ValueGenerated.OnAddOrUpdate 的属性默认会忽略当前设定的值。也就是说,不管被追踪实体的属性是否发生了变化,比如被设定初始值或者被修改为其他值,它们都只使用 store-generated 的值。要想让改变生效,可以通过设置 BeforeSaveBehavior 或 AfterSaveBehavior 来实现。
因为添加了新的字段,所以对于 IProperty 来说,这也算是一个突破性的变更。
ClientSetNull 成为默认的删除行为
之前,EF Core 有三种可能的级联删除行为:
- Cascade:依赖的实体也一并被删除。这种级联行为只对被上下文跟踪到的实体有效。数据库里也需要设置相应的级联,确保没有被上下文跟踪到的数据也具备同样的行为。如果你通过 EF 来创建数据库,那么 EF 会为你设置好数据库的级联。
- Restrict:删除操作不会作用在依赖实体上,依赖实体保持不变。
- SetNull:依赖实体的外键被设为 null。这种级联行为只对被上下文跟踪到的实体有效。数据库里也需要设置相应的级联,确保没有被上下文跟踪到的数据也具备同样的行为。如果你通过 EF 来创建数据库,那么 EF 会为你设置好数据库的级联。
EF Core 2.0 新增了一种默认行为,叫作 ClientSetNull。
EF Core 2.0 引入了一种叫作 ClientSetNull 的默认行为。它具有 SetNull 的语义,兼有 Restrict 的行为。从我们的经验来看,对于被跟踪的实体和数据库来说,它是最被期待也是最有用的一种行为。
在为被跟踪的实体设置级联关系时,DeleteBehavior.Restrict 已经成为历史。
设计时工具包的合并
Microsoft.EntityFrameworkCore.Relational.Design 包被弃用,原先的内容被合并到 Microsoft.EntityFrameworkCore.Relational 和 Microsoft.EntityFrameworkCore.Design 当中。这样做的好处是现在可以少引入一个包。
在后续的文章中,我们将会看到 EF Core 的路线图。
查看英文原文: Breaking Changes in EF Core 2.0
评论