EF Core 兼容多数据库 保姆级教程 SqlServer PostgreSQL SQLite

本文环境 Microsoft Visual Studio 2022、.Net6、SQLServer2019、PostgreSQL 14.4、SQLite 3.5

一、准备数据库环境

SQLServer 建表,按绿色箭头
在这里插入图片描述
★如果没有到本链接下载开发版即可,上面这软件是单独装的安装向导里面有(https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads)

IF  EXISTS (SELECT * FROM sys.objects WHERE object_id = OBJECT_ID(N'UserData2Extension') AND type in (N'U'))
DROP TABLE UserData2Extension;

IF  EXISTS (SELECT * FROM sys.objects WHERE object_id = OBJECT_ID(N'UserData2') AND type in (N'U'))
DROP TABLE UserData2;

CREATE TABLE UserData2(
	ID int IDENTITY(1,1) PRIMARY KEY ,
	LoginName nvarchar(50) UNIQUE,
	Password nvarchar(50),
	DisplayName nvarchar(50),
	CreateDate datetime,
);

insert into UserData2(LoginName,Password,DisplayName,CreateDate) values('admin','pwtest','管理员',getdate());

create table UserData2Extension(
	ID int IDENTITY(1,1) PRIMARY KEY,
	UserId int ,
	Code nvarchar(50),
	Value nvarchar(50),
	FOREIGN KEY(UserId) REFERENCES UserData2 (ID)
);

insert into UserData2Extension(UserId,Code,Value) values(1,'LastUpdateTime',CONVERT(varchar(100), GETDATE(), 21));

PostgreSQL 建表,按黑色箭头
在这里插入图片描述
★如没数据库可点击本链接到官方网站下载200多M,带上面哪个软件(https://www.postgresql.org)

DROP TABLE IF EXISTS "UserData2Extension";
DROP TABLE IF EXISTS "UserData2";

CREATE TABLE IF NOT EXISTS "UserData2"
(
    "ID" serial PRIMARY KEY,
    "LoginName" character varying(50) UNIQUE,
    "Password" character varying(50),
    "DisplayName" character varying(50),
    "CreateDate" timestamp without time zone
    
);

INSERT INTO "UserData2"( "LoginName", "Password", "DisplayName", "CreateDate") VALUES ('admin','pwtest','管理员',statement_timestamp());

create table IF NOT EXISTS "UserData2Extension"(
	"ID" serial PRIMARY KEY,
	"UserId" integer ,
	"Code" character varying(50),
	"Value" character varying(50),
    FOREIGN KEY("UserId") REFERENCES "UserData2"("ID")
);

insert into "UserData2Extension"("UserId","Code","Value") values(1,'LastUpdateTime',statement_timestamp());

SQLite 建表

先创建一个叫 DefaultDb.db 的文件,在你的工程目录里,然后按蓝色箭头执行SQL如下图
在这里插入图片描述
上面的 DB Browser for SQLite 软件到管网下载,数据库支持软件和VS都自带(https://sqlitebrowser.org)

DROP TABLE IF EXISTS "UserData2Extension";
DROP TABLE IF EXISTS "UserData2";

CREATE TABLE "UserData2" (
	"ID" INTEGER PRIMARY KEY AUTOINCREMENT,
	"LoginName" TEXT UNIQUE,
	"Password" TEXT,
	"DisplayName" TEXT,
	"CreateDate" DATETIME	
);

insert into UserData2(LoginName,Password,DisplayName,CreateDate) values('admin','pwtest','管理员',DateTime('now','localtime'));

create table "UserData2Extension"(
	"ID" INTEGER PRIMARY KEY AUTOINCREMENT,
	"UserId" INTEGER ,
	"Code" TEXT,
	"Value" TEXT,
    FOREIGN KEY("UserId") REFERENCES "UserData2"("ID")
);

insert into "UserData2Extension"("UserId","Code","Value") values(1,'LastUpdateTime',DateTime('now','localtime'));

二、准备代码工程环境

新建一个控制台工程,添加包如下,tools是生成代码的工具,其他几个是EF数据库包

Microsoft.EntityFrameworkCore.SqlServer
Npgsql.EntityFrameworkCore.PostgreSQL
Microsoft.EntityFrameworkCore.Sqlite
Microsoft.EntityFrameworkCore.Tools

在这里插入图片描述

启动程序包管理控制台
在这里插入图片描述
把之前步骤创建的 DefaultDb.db 包括到项目中,设置复制到输出目录
在这里插入图片描述

三、生成与处理上下文、实体代码

运行如下命令,生成所有数据库对应的上下文,实体代码
注意:用户名,密码,数据库根据自己的库改
在这里插入图片描述
命令代码

Scaffold-DbContext "Data Source=.;Initial Catalog=Demo20220707;Integrated Security=true; pooling=false;" Microsoft.EntityFrameworkCore.SqlServer -OutputDir ModelsSQLServer

Scaffold-DbContext "Host=localhost;Username=postgres;Password=pg2022sql;Database=postgres" Npgsql.EntityFrameworkCore.PostgreSQL -OutputDir ModelsNpgsql

Scaffold-DbContext "Data Source=DefaultDb.db" Microsoft.EntityFrameworkCore.Sqlite -OutputDir ModelsSqlite

这样会得到多个对应不同数据库的上下文,实体代码。如下图
注意:这些代码最终删除,最终我们只用一套上下文与实体。这样容易复制代码优化成一套
在这里插入图片描述
先看 xxxContext 的,找差异。

看看 SQLServer的
在这里插入图片描述
看看 PostgreSQL的,大约有三类差异
在这里插入图片描述
看看 SQLite的。大约有两类差异
在这里插入图片描述
总结一下,3个数据库的差异
1)日期类型
2)unique 哪里有些差异,就是索引的名字,如果开发需要就改成统一的否则不需要这参数
3)还有就是postgresql多一行,HasPostgresExtension(“pg_catalog”, “adminpack”); 把这些差异合并成一套,这行可要可不要其实。

其余的都差不多,然后开始处理成一套,处理 OnModelCreating 如下图
在这里插入图片描述再处理 OnConfiguring (其实顺序无所谓先 OnConfiguring 也行)
在这里插入图片描述
上下文、实体代码如下

using System;
using System.Collections.Generic;
using System.Diagnostics;
using System.Reflection;
using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Infrastructure;
using Microsoft.EntityFrameworkCore.Metadata;
using Microsoft.EntityFrameworkCore.SqlServer.Infrastructure.Internal;
using Microsoft.EntityFrameworkCore.Storage;
using Microsoft.Extensions.Configuration;
using Npgsql.EntityFrameworkCore.PostgreSQL.Infrastructure;
using Npgsql.EntityFrameworkCore.PostgreSQL.Infrastructure.Internal;

namespace ConsoleApp6.Models
{
    public partial class DefaultDbContext : DbContext
    {
        
        string _connectionString=string.Empty;
        string _providerType = string.Empty;
        public DefaultDbContext()
        {
            //如果在这里 Thorw 可以禁止某些设计时操作如在程序包管理器运行 Script-DbContext 生成脚本
            //throw new ApplicationException("禁止 DefaultDbContext");
        }
        public DefaultDbContext(string connectionString,string providerType)
        {
            _connectionString = connectionString;
            _providerType = providerType;

        }
        public DefaultDbContext(DbContextOptions<DefaultDbContext> options)
            : base(options)
        {
            
        }
        public virtual DbSet<UserData2> UserData2s { get; set; } = null!;
        public virtual DbSet<UserData2Extension> UserData2Extensions { get; set; } = null!;
        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
        {
            //日志输出到 Console.WriteLine 可以看到代码到SQL转换过程等,测试没问题了关闭即可。
            optionsBuilder.LogTo(Console.WriteLine);
            
            if (!optionsBuilder.IsConfigured)
			{
                                     
                if ("Npgsql.EntityFrameworkCore.PostgreSQL" == _providerType)
                    optionsBuilder.UseNpgsql(_connectionString);
                else if("Microsoft.EntityFrameworkCore.SqlServer" == _providerType)
                    optionsBuilder.UseSqlServer(_connectionString);
                else if ("Microsoft.EntityFrameworkCore.Sqlite" == _providerType)
                    optionsBuilder.UseSqlite(_connectionString);
                else
                    throw new ApplicationException("未知的数据库 Provider");               

            }

            base.OnConfiguring(optionsBuilder);

        }

        protected override void OnModelCreating(ModelBuilder modelBuilder)
        {
            var db = this.Database;
           
            if (db.IsNpgsql())
                modelBuilder.HasPostgresExtension("pg_catalog", "adminpack");            

            modelBuilder.Entity<UserData2>(entity =>
            {
                entity.ToTable("UserData2");

                entity.HasIndex(e => e.LoginName).IsUnique();

                entity.Property(e => e.Id).HasColumnName("ID");

                if (db.IsNpgsql())
                    entity.Property(e => e.CreateDate).HasColumnType("timestamp without time zone");
                else if (db.IsSqlServer())
                    entity.Property(e => e.CreateDate).HasColumnType("datetime");
                else if (db.IsSqlite())               
                    entity.Property(e => e.CreateDate).HasColumnType("DATETIME");
                else
                    throw new ApplicationException("未知的数据库 Provider");          
                

                entity.Property(e => e.DisplayName).HasMaxLength(50);

                entity.Property(e => e.LoginName).HasMaxLength(50);

                entity.Property(e => e.Password).HasMaxLength(50);
            });

            modelBuilder.Entity<UserData2Extension>(entity =>
            {
                entity.ToTable("UserData2Extension");

                entity.Property(e => e.Id).HasColumnName("ID");

                entity.Property(e => e.Code).HasMaxLength(50);

                entity.Property(e => e.Value).HasMaxLength(50);

                entity.HasOne(d => d.User)
                    .WithMany(p => p.UserData2Extensions)
                    .HasForeignKey(d => d.UserId);
            });

            OnModelCreatingPartial(modelBuilder);
        }

        partial void OnModelCreatingPartial(ModelBuilder modelBuilder);
    }
}

using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;

namespace ConsoleApp6.Models
{
    public partial class UserData2
    {
        public UserData2()
        {
            UserData2Extensions = new HashSet<UserData2Extension>();
        }
        public int Id { get; set; }
        public string? LoginName { get; set; }
        public string? Password { get; set; }
        public string? DisplayName { get; set; }
        public DateTime? CreateDate { get; set; }

        public virtual ICollection<UserData2Extension> UserData2Extensions { get; set; }
    }
}
using System;
using System.Collections.Generic;

namespace ConsoleApp6.Models
{
    public partial class UserData2Extension
    {
        public int Id { get; set; }
        public int? UserId { get; set; }
        public string? Code { get; set; }
        public string? Value { get; set; }

        public virtual UserData2? User { get; set; }
    }
}

四、测试代码、执行效果

在这里插入图片描述
代码逻辑很简单,就是用不同的数据库链接串与类型,创建不同的上下文然后循环输出,代码如下


using ConsoleApp6.Models;
using Microsoft.EntityFrameworkCore;
using System.Reflection;

namespace ConsoleApp6
{
	internal class Program
	{

		static void Main(string[] args)
		{				
			string[] csTable = {
				 "Data Source=.;Initial Catalog=Demo20220707;Integrated Security=true; pooling=false;"
				 , "Host=localhost;Username=postgres;Password=pg2022sql;Database=postgres"
				 , "Data Source=DefaultDb.db"
			};
			string[] dbTypeTable ={
				"Microsoft.EntityFrameworkCore.SqlServer"
				, "Npgsql.EntityFrameworkCore.PostgreSQL"
				, "Microsoft.EntityFrameworkCore.Sqlite"
			};

			for (int i = 0; i < csTable.Length; i++)
			{

				Program.ExecTest(csTable[i], dbTypeTable[i]);

				Console.WriteLine("━━━━━━━━━━━━");
			}
		}

		private static void ExecTest(string constr, string ptype)
		{
			using var context = new DefaultDbContext(constr
				, ptype);

			//创建建库脚本
			var sql = context.Database.GenerateCreateScript();

			Console.WriteLine("数据库类型:{0}", context.Database.ProviderName);
			Console.WriteLine("建库脚本");
			Console.WriteLine(sql);

			//添加数据
			var d1 = DateTime.Now;
			var rn1 = d1.GetHashCode();

			var d2 = DateTime.Now;
			var rn2 = d2.GetHashCode();

			var adduser1 = new UserData2()
			{
				LoginName = "usertest" + rn1,
				Password = "upsw",
				DisplayName = "测试用户",
				CreateDate = d1
			};

			var adduser2 = new UserData2()
			{
				LoginName = "usertest" + rn2,
				Password = "upsw",
				DisplayName = "测试用户" + +rn2,
				CreateDate = d2
			};

			context.UserData2s.AddRange(adduser1, adduser2);
			var changCount = context.SaveChanges();

			Console.WriteLine("Insert自动编号:{0}、{1}", adduser1.Id, adduser2.Id);
			//查询数据,且包括子表数据,且生成的sql包括代码路径与行号
			var users = from user in context.UserData2s.Include(e=>e.UserData2Extensions).TagWithCallSite()
						where user.Id > 1 || user.Id <= adduser2.Id
						orderby user.Id descending
						select user;

			Console.WriteLine("查询数据");

			foreach (var u in users)
			{
				var extCount = u.UserData2Extensions.Count();
				
				Console.WriteLine($"{u.Id}\t{u.LoginName}\t{u.Password}\t{u.DisplayName}\t{u.CreateDate}\t{extCount}");
			}


		}
	}
}

在optionsBuilder.LogTo(Console.WriteLine); 不生效时,可看见建库与数据
在这里插入图片描述
optionsBuilder.LogTo(Console.WriteLine); 生效时可以看见调试信息如下

建表脚本
在这里插入图片描述

在这里插入图片描述
INSERT 语句
在这里插入图片描述
SELECT 语句
在这里插入图片描述

五、收尾

测试无误把之前生成的多余的类都删了即可
在这里插入图片描述

本文完

ef-orm A Simple OR-Mapping framework on multiple databases. 使用手册(中文)http://geequery.github.io/ef-orm/manual/EF-ORM-user-guide.docx  使用示例工程 https://github.com/GeeQuery/ef-orm/tree/master/orm-tutorial EF-ORM是一个轻量,便捷的Java ORM框架。并且具备若干企业的应用特性,如分库分表、JTA事务等。 代码生成插件for eclipse(请在eclipse中Help/Install new software后输入地址并安装)http://geequery.github.io/plugins/1.3.x/特点一 EF的设计的一个主要目的是提高开发效率,减少编码工作,让开发者“零配置”“少编码”的操作数据库大部分功能。 例如:数据库查询条件的传入问题是所有ORM框架都不能回避的一个问题,所以我经常在想——既然我们可以用向DAO传入一个Entity来实现插入操作,为什么就不能用同样的方法来描述一个不以主键为条件的update/select/delete操作?为什么DAO的接口参数老是变来变去?为什么很多应用中,自行设计开发类来描述各种业务查询条件才能传入DAO?为什么我们不能在数据访问层上花费更少的时间和精力?   JPA1.0和早期的H框架,其思想是将关系型数据库抽象为对象池,这极大的限制了本来非常灵活的SQL语句的发挥空间。而本质上,当我们调用某H框架的session.get、session.load、session.delete时,我们是想传递一个以对象形式表达的数据库操作请求。只不过某H框架要求(并且限制)我们将其视作纯粹的“单个”对象而已。JPA 2.0为了弥补JPA1.0的不足,才将这种Query的思想引入为框架中的另一套查询体系——Criteria API。事实上针对单个对象的get/load/persist/save/update/merge/saveOrUpdate API和Criteria API本来就为一体,只不过是历史的原因被人为割裂成为两套数据库操作API罢了。   因此,对于关系型数据库而言——Entity和Query是一体两面的事物,所谓Query,可以包含各种复杂的查询条件,甚至可以作为一个完整的SQL操作请求的描述。为此,EF彻底将Entity和Query绑在了一起。这种思想,使得—— 开发人员需要编写的类更少。开发人员无需编写其他类来描述复杂的SQL查询条件。也无需编写代码将这些查询条件转换为SQL/HQL/JPQL。DAO层也不会有老要改来改去的接口和API,几乎可以做到零编码。 对单个对象进行CRUD的操作API现在和Criteria API合并在一起。Session对象可以直接提供原本要Criteria API才能提供实现的功能。API大大简化。 IQueryableEntity允许你将一个实体直接变化为一个查询(Query),在很多时候可以用来完成复杂条件下的数据查询。比如 ‘in (?,?,?)’, ‘Between 1 and 10’之类的条件。 xxQL有着拼装语句可读性差、编译器无法检查、变更维护困难等问题,但是却广受开发人员欢迎。这多少有历史原因,也有Criteria API设计上过于复杂的因素。两者一方是极端灵活但维护困难,一方是严谨强大而学习和编写繁琐,两边都是极端。事实上JPA的几种数据查询方式存在青黄不接的问题。选择查询语言xxQL,项目面临后续维护困难,跨数据库移植性差;选择Criteria API,代码臃肿,操作繁琐,很多人望而却步。EF的设计思想是使人早日摆脱拼装SQL/HQL/JPQL的困扰,而是用(更精简易用的)Criteria API来操作数据库。 基于轻量Criteria API的操作方式,使得对数据库的变更和重构变得非常轻松,解决了SQL语句多对软件维护和移植造成产生的不利影响。 阅读推荐:第3、4章 特点二,将SQL的使用发挥到极致,解决SQL拼凑问题、数据库移植问题 大部分OLTP应用系统到最后都不免要使用SQL/JPQL,然而没有一个很好的方法解决SQL在多种数据库兼容性的问题。 EF-ORM中采用了独特的SQL解析和改写技术,能够主动检查并确保SQL语句或者SQL片段在各个数据库上的兼容性。 EF中除了Criteria API以外,可以直接使用“SQL语句”或者“SQL片段”。但是这些SQL语句并不是直接传送给JDBC驱动的,而是 有着一个数据库方言层,经过方言层处理的SQL语句,就具备了在当前数据库上正确操作的能力。这相当于提供了一种能跨数据库操作的SQL语言。(E-SQL) E-SQL不但解决了异构数据库的语法问题、函数问题、特殊的写法问题,还解决了动态SQL问题、绑定变量扩展等特性。 对于各种常用SQL函数和运算符,都可以自动转换为当前数据库支持的方言来操作。其函数支持也要多于HQL支持的函数。 阅读推荐:第7、8章 特点三,可能是业界最快的ORM框架. 得益于ASM的动态代码生成技术,部分耗时操作通过动态代码固化为硬编码实现,EF-ORM的大部分操作性能要超过已知的其他框架。 实际性能测试表明,EF的大部分操作都要快于Hiberante和MyBatis, 部分操作速度甚至数十倍于上述框架。 EF在极限插入模式下,甚至刷新了每秒10万条写入的记录。远远超过了其他框架。 一个初步的性能测试:测试代码:http://geequery.github.io/ef-orm/manual/performance-test.rar 测试报告:http://geequery.github.io/ef-orm/manual/performance-compare.docx 阅读推荐:第9、17章 特点四,分库分表 开发过程中参照了Hibernate Shards、Alibaba TDDL、Cobar等框架,也是基于词法分析器来提取SQL参数,并计算路由。 能支持分库维度含糊等场景下的分库分表。以及包括多库多表下的 order by , distinct, group by, having等操作。 阅读推荐:第10章 特点五,常用DDL操作的封装 从数据库元数据访问,到建表,创建约束,创建sequence等各种DDL操作进行了封装,用户无需编写各种SQL,可以直接通过API操作数据库结构。 尤其是ALTER TABLE等修改数据库的语句,各种不同的RDBMS都有较大语法差异。特点六、解决各种跨RDBMS的移植问题 1、DML操作、自增值处理与返回、查询这些不同数据库操作差异很大的东西,都了统一的封装。 2、DDL操作、建表、删表、trunacte,Sequence创建和TABLE模拟Sequence等,都做了支持。 3、对SQL语法操作和函数的改写与支持。其他特性轻量 该框架对应用环境、连接池、 是否为J2EE应用等没有特殊要求。可以和EJB集成,也可与Spring集成,也可以单独使用。整个框架只有两个JAR包,模块和功能都较为轻量。依赖少 整个框架只有三个jar库。间接依赖仅有commons-lang, slf4j等7个通用库,作为一个ORM框架,对第三方依赖极小。简单直接的API 框架的API设计直接面向数据库操作,不绕弯子,开发者只需要数据库基本知识,不必学习大量新的操作概念即可使用API完成各种DDL/DML操作。 最大限度利用编译器减少编码错误的可能性 API设计和元数据模型(meta-model)的使用,使得常规的数据库查询都可以直接通过Criteria API来完成,无需使用任何JPQL/HQL/SQL。可以让避免用户犯一些语法、拼写等错误。JPA2规范兼容 使用JPA 2.0规范的标准注解方式来定义和操作对象。(但整个ORM不是完整的JPA兼容实现)更高的性能 依赖于ASM等静态字节码技术而不是CGlib,使得改善了代理性能;依赖于动态反射框架,内部数据处理上的开销几乎可以忽略。操作性能接近JDBC水平。对比某H开头的框架,在写入操作上大约领先30%,在大量数据读取上领先50%以上。更多的性能调优手段 debug模式下提供了大量性能日志,帮您分析性能瓶颈所在。同时每个查询都可以针对batch、fetchSize、maxResult、缓存、联操作类型等进行调整和开关,可以将性能调到最优。可在主流数据库之间任意切换 支持Oracle、MySQL、Postgres、MSSQL、GBase、SQLite、HSQL、Derby等数据库。除了API方式下的操作能兼容各个数据库之外,就连SQL的本地化查询也能使之兼容。JMX动态调节 可以用JMX查看框架运行统计。框架的debug开关和其他参数都可以使用JMX动态调整。动态表支持 表结构元数据的API也向用户开放,同时支持在使用过程中,灵活调整映射关系,因此用户可以用API动态的创建表结构的模型,从而实现各种动态类型和表的映射(例如POJO中包含一个Map,用于映射各种动态扩展的字段)企业特性支持 SQL分析,性能统计,分库分表,Oracle RAC支持,读写分离支持 标签:eform
评论 4
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值