在Oracle中使用Entity Framework 6 CodeFirst

项目中需要将系统从SQLServer数据库迁移到Oracle上。由于原大部分数据访问操作都是通过包装了Entity Framework的统一访问入口实现的,所以需要研究Entity Framework从SQLServer转移到Oracle的实现方式。

自从EF4.X起,Oracle就为EF提供了驱动支持,但是很可惜的是不支持CodeFirst模式。庆幸的是从ODP.NET 11.2.0.3.0开始,Oracle官方提供了支持CodeFirst的纯托管代码的EF驱动。但是有以下几点是需要知道的;

  1. ODP.NET for .NET Framework 4.0支持Entity Framework和LINQ to Entities,但ODP.NET for .NET Framework 2.0并不支持。
  2. Code First的特性只能在Entity Framework 6 以上的版本才能使用。
  3. ODP.NET和Entity Framework支持标量参数绑定。Entity Framework支持通过名称的参数绑定,不支持通过位置的参数绑定。
  4. 只支持访问Oracle 10g release2及以后版本
  5. 使用可升级和分布式事务需要Oracle Service for Microsoft Transaction Server 12.1。ODP.NET在分布式事务中只支持读级别的隔离。

如何使用CodeFirst

接下来才是我们真正需要关心的,如何在项目中使用CodeFirst(本篇默认你已经了解CodeFirst的概念和使用方法)。

有两种方式能找到我们需要的dll:通过Oracle官网下载(在\odp.net4\odp.net\managed\common中),通过NuGet安装。这里我推荐使用NuGet安装。在程序包管理控制台输入:

install-package Oracle.ManagedDataAccess.EntityFramework

修改app.config配置如下:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <configSections>
    <section name="entityFramework"
      type="System.Data.Entity.Internal.ConfigFile.EntityFrameworkSection, EntityFramework, Version=6.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
      requirePermission="false"/>
  </configSections>
  <connectionStrings>
    <add name="SampleDataSource" providerName="Oracle.ManagedDataAccess.Client"
    connectionString="Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVER=DEDICATED)(SERVICE_NAME=**SERVICE_NAME**)));Persist Security Info=True;User ID=**User ID**;Password=**Password**"/>
  </connectionStrings>
  <entityFramework>
    <defaultConnectionFactory
      type="Oracle.ManagedDataAccess.EntityFramework.OracleConnectionFactory, Oracle.ManagedDataAccess.EntityFramework, Version=6.121.2.0, Culture=neutral, PublicKeyToken=89b483f429c47342"/>
    <providers>
      <provider invariantName="Oracle.ManagedDataAccess.Client"
        type="Oracle.ManagedDataAccess.EntityFramework.EFOracleProviderServices, Oracle.ManagedDataAccess.EntityFramework, Version=6.121.2.0, Culture=neutral, PublicKeyToken=89b483f429c47342"/>
    </providers>
  </entityFramework>
  <system.data>
    <DbProviderFactories>
      <remove invariant="Oracle.ManagedDataAccess.Client"/>
      <add name="ODP.NET, Managed Driver" invariant="Oracle.ManagedDataAccess.Client" description="Oracle Data Provider for .NET, Managed Driver"
      type="Oracle.ManagedDataAccess.Client.OracleClientFactory, Oracle.ManagedDataAccess, Version=4.121.2.0, Culture=neutral, PublicKeyToken=89b483f429c47342"/>
    </DbProviderFactories>
  </system.data>
  <runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <dependentAssembly>
        <publisherPolicy apply="no"/>
        <assemblyIdentity name="Oracle.ManagedDataAccess" publicKeyToken="89b483f429c47342" culture="neutral"/>
        <bindingRedirect oldVersion="4.121.0.0 - 4.65535.65535.65535" newVersion="4.121.2.0"/>
      </dependentAssembly>
    </assemblyBinding>
  </runtime>
</configuration>

定义一个实体对象:

    public class SomeInfo
    {
        public Guid Id { get; set; }
        public DateTime DateTimeField { get; set; }
        public bool BooleanField { get; set; }
        public decimal DecimalField { get; set; }
        public int IntField { get; set; }
        public string StringField { get; set; }
    }

定义数据上下文:

    public class TestDbContext : DbContext
    {
        public TestDbContext()
            : base("name=SampleDataSource")
        {
            Database.SetInitializer(new DropCreateDatabaseIfModelChanges<TestDbContext>());
        }

        public DbSet<SomeInfo> SomeInfos { get; set; }

        protected override void OnModelCreating(DbModelBuilder modelBuilder)
        {
            //这里需要指定schema,默认是sqlserver的dbo
            modelBuilder.HasDefaultSchema("YOURSCHEMA");
            base.OnModelCreating(modelBuilder);
        }
    }

在确保连接字符串是正确的情况下就可以写一段测试代码来验证了。验证的代码这里就不介绍了。

.NET类型到Oracle类型的映射

由于Oracle和SQLServer的数据类型有些不同所以这里需要介绍下.NET的数据类型和Oracle数据类型的映射。

.NET数据类型 Oracle数据类型 映射方法
Boolean number(1, 0) 使用EDM映射,注意:需要使用EDM映射配置,参考附加信息文档EDM映射节 。
Byte number(3, 0) 使用EDM映射,注意:需要使用EDM映射配置,参考附加信息文档EDM映射节 。
Byte[] blob 默认
Int16 number(5, 0) 默认,注意:需要使用EDM映射配置,参考附加信息文档EDM映射节 。
Int32 number(10, 0) 默认,注意:需要使用EDM映射配置,参考附加信息文档EDM映射节 。
Int64 number(19, 0) 默认,注意:需要使用EDM映射配置,参考附加信息文档EDM映射节 。
Decimal number(18, 2) 默认
Single binary_float 默认
Double binary_double 默认
Guid raw(16) 默认
DateTime date 默认
DateTimeOffset timestamp withtime zone 默认
String nclob 默认
String clob 使用IsUnicode() fluent API设置Unicode为false
String nvarchar2 使用HasMaxLength() fluent API或MaxLength标记设置MaxLength不大于2000
String varchar2 使用HasMaxLength() fluent API或MaxLength标记设置MaxLength不大于4000,使用IsUnicode() fluent API设置Unicode为false
String nchar 使用HasMaxLength() fluent API或MaxLength标记设置MaxLength不大于1000,使用HasColumnType() fluent API或Column标记设置Column Type为NCHAR
String char 使用HasMaxLength() fluent API或MaxLength标记设置MaxLength不大于2000,使用HasColumnType() fluent API或Column标记设置Column Type为NCHAR
String Long 使用HasColumnType() fluent API或Column标记设置Column Type为LONG,注意: 不推荐使用Long数据类型。
String rowid 使用HasColumnType() fluent API或Column标记设置Column Type为ROWID
String urowid 使用HasColumnType() fluent API或Column标记设置Column Type为UROWID

注意:

基于字符的列,即:CHAR,NCHAR,VARCHAR2,NVARCHAR2可以存储指定(MaxLength)的字符。但是受限于Oracle的设计,这些列只能存储最多4000 byte。存储的数据和数据库字符集的设定会使有些字符可能需要多个byte,所以尽管这些类型的列被配置为4000(MaxLength)但是可能存储不了这么多字符。如果待存储的数据超过4000byte可以使用CLOB或NCLOB类型的列。

Oracle数据类型的特性配置

接下来的表格里将列出Oracle所支持的Data Annotation和Fluent API:

Data Annotation Fluent API 目的 应用于
Key HasKey 设置主键. All Scalar Types
Required IsRequired 设置列为NOT NULL. All
MaxLength HasMaxLength 设置列最大长度 String
NotMapped Ignore 无需映射该属性 All
ConcurrencyCheck IsConcurrencyToken 该列需要被用作为乐观并发检查

注意:不要使用无长度上限的string属性,因为这会被映射为LOB类型。使用LOB类型的列最为并发检查会导致ORA-00932: inconsistent datatypes error.错误。

All
TimeStamp IsRowVersion 并发控制字段 Not Supported
Column HasColumnType 指定对应数据库数据列类型。

注意:必须是合法的兼容类型。例如一个Date属性是不能映射到number列的。

All
N/A IsUnicode 表示映射到一个N-type类型(nvarchar2或nclob),默认为true。 String
N/A HasPrecision 表示设置decimal的精度。 Decimal

Code First数据迁移

数据迁移的方式和使用SQLServer是一致的,但是需要注意以下两点:

  1. 唯一能自定义的是更改表的user schema
  2. Code First自动迁移只能使用dbo schema。所以需要显示的使用Add-Migration命令进行基于代码的数据迁移。

Code First数据库初始化

ODP.NET支持一下几种数据库初始化方式:

  • CreateDatabaseIfNotExists (默认)
  • DropCreateDatabaseAlways
  • DropCreateDatabaseIfModelChanges
  • NullDatabaseInitializer
  • MigrateDatabaseToLatestVersion

由于Oracle和SQL Server对数据库(database)的定义不同,数据库初始化动作作用于模型中所有Oracle对象。Oracle数据库没有新建或删除,而构成该模型的对象被认为是对数据库的一种操作。

Oracle数据库对象创建

为了支持客户端应用程序,ODP.NET创建和维护所需的数据库对象。下面列举了provider提供的可创建和维护的数据库对象:

  • Table
  • Table Column
  • Primary Key
  • Foreign Key
  • Index
  • Sequence
  • Trigger

注意:

Sequence和Trigger在Oracle 11g R2之后的版本中创建,早期版本的数据库支持标识列。

直接和客户端相关的对象,即:一个表对应一个类,一个列对应一个属性,这些对象的命名都是由客户端提供的,对象的命名必须满足Oracle数据库中对对象标识长度的限制。如果类名的长度超长了,那么在创建这个对象时就会报ORA-00972: identifier is too long的异常。

对于剩余的对象,如果提供的命名长度大于数据库标识长度显示,那么ODP.NET回利用命名生成算法。如果提供的命名未超长那就直接使用。在所有情况下,对象名称会被创建为带引号的标识符一方面是为了保持大小写,另一方面任何特殊字符都可以作为标识符的一部分。

命名算法会按照下面两种方式工作:

  • 从头开始截取原始名称中的一段
  • 从原名称计算出一个数字后缀

下面例子演示一个类对象名称是如何被截取的:

public class LongSamplePocoTestClassName
{
  [Key]
  public int Id { get; set; }

  [MaxLength(64)]
  public string Name { get; set; }
}

默认生成的主键名称为:

PK_LongSamplePocoTestClassNames

这个名称包含31(最多支持30个字符)个字符,超出了限制。将对其做截取操作,最后生成:

PK_LongSamplePocoTes_730795129

算法被设计为尽可能的保留更多的原始名称。

原创文章,转载请注明: 转载自xdlysk的博客

本文链接地址: 在Oracle中使用Entity Framework 6 CodeFirst

时间: 2024-12-06 20:34:31

在Oracle中使用Entity Framework 6 CodeFirst的相关文章

Oracle中使用Entity Framework 6.x Code-First

Oracle中使用Entity Framework 6.x Code-First方式开发 去年写过一篇EF的简单学习笔记,当时EF还不支持Oracle的Code-First开发模式,今天无意又看了下Oracle官网,发现EF6.X已经支持了,并且给出了二篇教程(英文版): 1.Using NuGet to Install and Configure Oracle Data Provider for .NET 2.Entity Framework Code First and Code First

如何在ASP.NET Core中应用Entity Framework

注:本文提到的代码示例下载地址> How to using Entity Framework DB first in ASP.NET Core 如何在ASP.NET Core中应用Entity Framework 首先为大家提醒一点,.NET Core和经典.NET Framework的Library是不通用的,包括Entity Framework! 哪怎么办? 别急,微软为.NET Core发布了.NET Core版本的Entity Framework,具体配置方法与经典.NET Framew

[UWP小白日记-11]在UWP中使用Entity Framework Core(Entity Framework 7)操作SQLite数据库(一)

前言 本文中,您将创建一个通用应用程序(UWP),使用Entity Framework Core(Entity Framework 7)框架在SQLite数据库上执行基本的数据访问. 准备: Entity Framework Core(Entity Framework 7)下文将简称:EF 1.在UWP中使用EF需要更新Microsoft.NETCore.UniversalWindowsPlatform到大于“5.2.2”的版本. 2.直接在“程序包管理器控制台”输入命令来更新:Update-P

Entity Framework - PostgresQL CodeFirst

经过几年的更新及业界对Entity Framework 的认同. 现在 EF 可以支持的数据库越来越多了.而PostgresQL 数据库现在也可以使用code first的方式来创建数据库了. 不多说了,下面直接上过程. 首先要安装必要的库 直接在VS的程序包管理控制台里执行 Install-Package Npgsql.EntityFramework 或者右键点引用到 nuget的管理工具里去搜  Npgsql.EntityFramework 安装时会自动解决依赖,安装EF 6.0  和 Np

在服务器中使用 Entity Framework 的 Migration 更新数据库

在开发环境中,每次我们对要对数据库进行更改,比如增加修改表字段等.改好Entity类后,我们只需在Nuget程序包管理控制台运行 update-database 脚本却可: update-database Entity Framework提供的这个Migration功能非常方便,基本上不用再打开Sql Server Management Studio了.那么如何在发布环境(服务器)中同步我们对数据库的修改呢? 一种方法是在运行 update-database 脚本加上 -verbose 或 -s

ASP.NET: Setup a MVC5 website with MySQL, Entity Framework 6 Code-First and VS2013

The new features available in EF6 allow any developer to build a simple DB-powered website with very few lines of code. There are many tutorials explaining how to do that with SQL Express available on the web, but those who want (or are forced) to us

第一次使用Entity Framework 的CodeFirst

做了这么久的.NET MVC 却没有一次真正的使用Entity Framework ,要么就是看教程上的内容,照着做,今天终于自己试了一下 用的是Code First模式,创建好实体类,设置好连接字符串,写好继承自DbContext的类,接下来就是用程序包管理器控制台来生成数据库了 上图就是我最开始操作的过程的,虽然出了一些问题,但是我还是通过百度搜索解决了,看来这些命令还是应该要用正常操作来 第一步: Enable-Migrations -ContextTypeName 使用base("&qu

[ORM] Entity Framework(2) CodeFirst进阶

在上一节中,实现了CodeFirst快速入门.但是很多与数据库的细节还无法自定义.以及使用EF过程中,需要注意的事项. 在本节中,会涉及到以下 EF中的连接字符串 EF的对象状态 延迟加载,为什么需要Virtual,贪婪加载 绕过EF,直接SQL查询 查看EF生成SQL语句 实体与数据库的映射通过DataAnnotation与FluentAPI两种方式 结合MVC异步控制器做个CRUD例子 建议 连接字符串 1个完整的连接字符串 IP:端口\实例名 数据库名组成 Nuget安装完EF会在*.co

asp.net MVC中使用entity framework出现从 datetime2 数据类型到 datetime 数据类型的转换产生一个超出范围的值”的处理

方法一: 使用DateTime类型的字段在作为参数传入到数据库前记得赋值,并日期要大于1753年1月1日. 方法二: 将DateTime类型的字段修改为DateTime?类型,由于可空类型的默认值都是为null,所以传入数据库就可以不用赋值,数据库中的datetime类型也支持null. 方法三: 将数据库中的datetime类型修改为datetime2类型