作者简介:博主是一位.Net开发者,同时也是RPA和低代码平台的践行者。
个人主页:会敲键盘的肘子
系列专栏:SqlSugar ORM
专栏简介:SqlSugar是一款来自未来的ORM,拥有超前的理念,需求领跑第一线,在设计理念上就算不更新几年都不会过时,是一款真正用了功能齐全的ORM框架。博主在工作中学习和实战SqlSugar,形成本专栏,希望可以帮助到您解决问题。
座右铭:总有一天你所坚持的会反过来拥抱你。
随着华为、中兴事务,国产数据库市场相信是未来是趋势走向,纵观 .net core 整个圈子FreeSql和SqlSugar(排名不分先后)都已早早支持国产数据库,比如人大金仓、神通、达梦,针对不同的项目要求支持适配不同的国产数据库。今天我们使用 SqlSugar ORM 来体验人大金仓国产数据库。
SqlSugar是一款来自未来的ORM,开箱即用,拥有超前的理念,需求领跑第一线,在设计理念上就算不更新几年都不会过时,是一款真正用了功能齐全的ORM框架。
感谢果糖大数据科技团队对SqlSugar的维护和更新,北京人大金仓信息技术股份有限公司提供的支持。
本文关键字:国产数据库、人大金仓、SqlSugar、ORM
KingbaseES
是一款面向事务处理应用,兼顾简单分析应用的企业级关系型数据库,产品融合了金仓在数据库领域多年的产品研发经验和企业级应用经验,可满足各行业用户多种场景的数据处理需求。
金仓数据库管理系统 KingbaseES 支持多种操作系统和硬件平台: 支持 Linux、Windows、国产 Kylin 等数十个操 作系统产品版本,支持通用 x86_64 及国产龙芯、飞腾、申威等 CPU 硬件体系架构。Windows 平台的金仓数据库管 理系统 KingbaseES 提供标准版。
金仓数据库管理系统 KingbaseES 软件能够提供一主一备以及一主多备的高可用集群架构,实现数据及实例级 (异地) 故障容灾,也能够提供多节点并行服务,内存融合及存储共享,实现高并发性能利用最大化,结合读写分离或备份使用同步实现数据保护最大化。
根据操作习惯的不同,您可以选择图形化安装
、控制台安装
或静默安装
的方式安装部署金仓数据库管理系统 KingbaseES。推荐使用图形化安装。
安装方式 | 简介 |
---|---|
图形化安装 | 启用图形化界面进行向导式安装。 |
控制台安装 | 使用命令行方式进行向导式安装。 |
静默安装 | 通过编写配置文件,执行命令进行安装,安装过程不需要干预 |
数据库 license 是金仓数据库管理系统 KingbaseES 提供的授权文件,其中会对数据库有效日期、发布类型、最大 并发连接数 mac 地址、ip 等信息进行设置。 如果在 license 文件中信息与安装环境中相关信息不匹配,数据库将无法启动。
Windows 版本的金仓数据库管理系统 KingbaseES V8.6 可以运行在通用 X86_64 体系结构的 CPU 上。其中标准版需要内存512MB 以上以及10GB 以上的硬盘空闲空间。
本文使用通用型数据库标准版,下载链接:KingbaseES_V008R006C006B0021_Win64_install。
您在获得安装程序(iso 文件)的同时,应该会获得一个 MD5 值或 SHA1 值。建议先通过以下命令查看安装程序文件对应的 MD5 值或 SHA1 值,再和拿到的 MD5 值或 SHA1 值进行比对。如果一致说明安装文件正常;如果不 一致说明安装文件可能不完整,安装过程可能无法正常完成。
假设拿到的安装包文件是 KingbaseES_V008R006C006B0021_Win64_install.iso,
查看其 MD5 值: certutil -hashfile C:\KingbaseES_V008R006C006B0021_Win64_install.iso MD5
查看其 SHA1 值: certutil -hashfile C:\KingbaseES_V008R006C006B0021_Win64_install.iso SHA1
如下图所示,
金仓数据库管理系统 KingbaseES 安装过程中有默认的安装目录 C:\Program Files\Kingbase\ES\V8
。
数据目录是金仓数据库管理系统 KingbaseES 中存放数据文件的目录,默认是在安装目录下的 data 目录。也可以与安装目录分开单独设置。您也可以根据系统的业务数据量来设置数据目录路径。默认数据目录是安装目录下的 data 目录。如果使用默认安装目录,则数据目录默认为 C: \ProgramFiles\Kingbase\ES\V8\data
。
注意: 数据目录不必事先创建。安装过程中会提示指定数据目录,如果目录不存在安装程序会自动创建。
右键以管理员身份运行金仓数据库管理系统 KingbaseES V8.6 安装程序,将弹出安装程序窗口,如图所示。
选择语言(默认 < 简体中文 >),并点击“确定”按钮,继续安装。
点击【下一步】,继续本次安装。
默认“我接受许可协议条款”的选择框未选中,【下一步】按钮置灰。当且仅当选择“我接受许可协议条款”后,【下一步】按钮方有效。
若点击【取消】按钮,将弹出取消安装提示窗口,点击【退出】按钮,退出安装程序。若点击【继续】,则回到安装界面,继续安装。
根据安装后数据库服务功能的不同,金仓数据库管理系统 KingbaseES V8.6 可分为完全安装、客户端安装和定制安装三种安装集。
完全安装:包括数据库服务器、接口、数据库开发管理工具、数据库迁移工具、数据库部署工具。选择“完全安装”安装集,系统将安装 KingbaseES 所有组件,点击【下一步】,至选择授权文件。
客户端安装:包括接口、数据库开发管理工具、数据库迁移工具、数据库部署工具。选择“客户端安装”安装集,系统将安装 KingbaseES 的所有客户端工具和编程接口,点击【下一步】,至选择安装文件夹。
定制安装:在数据库服务器、接口、数据库开发管理工具、数据库迁移工具、数据库部署工具所有组件中自由选择。选择“定制安装”安装集,可根据需求选择安装所需功能部件,点击【下一步】,至选择产品功能组件。
如选择定制安装的安装集,您通过点击功能组件项选择或去除对应的组件。如果要安装集群节点上的数据库服务,必须要安装“数据库部署工具”。点击【下一步】,继续安装。
您在本步骤需要选择授权文件,授权文件路径默认为空,点击【选择】按钮以选择本机上的授权文件。若指定的授权文件合法,则将显示授权文件的详细信息。进入该步骤【下一步】按钮默认置灰,若授权文件通过验证,则【下一步】按钮有效。
授权文件在下载安装包的页面下载,本文使用windows版本。
此步骤用于选择安装路径。默认安装路径为: D:\Program Files\Kingbase\ES\V8
。
您点击【选择】按钮,弹出文件选择对话框,可选择其他安装路径。
点击【恢复缺省文件夹】按钮,将安装路径恢复为默认安装路径。
点击【下一步】按钮,继续安装。
您在此步骤会看到即将安装产品的摘要信息,包括:
您点击【安装】按钮后,系统开始安装 KingbaseES,安装过程不断刷新安装进度。
如选择“完全安装”安装集,安装进度 100% 之后,将至 初始化数据库。
如选择“客户端安装”安装集,安装进度 100% 之后,将至 安装完成。
如选择“定制安装”安装集,并选择安装了数据库服务器组件,安装进度 100% 之后,将至 初始化数据库。
首先选择数据库数据目录,默认数据目录为安装目录下的 data 目录。如使用默认安装目录,则数据目录默认为
D:\Program Files\Kingbase\ES\V8\data
。
点击【选择】按钮,弹出文件选择对话框,选择自定义数据目录。
您点击【恢复缺省文件夹】按钮,将数据目录恢复为默认的数据目录。
点击【下一步】按钮,继续设置如下初始化数据库参数:
若安装过程中没有出现任何警告或错误,将显示如下界面。单击【完成】退出安装程序。若安装过程中出现任何警告或错误,则窗口中显示日志文件位置,您可以打开日志文件查看具体错误信息。
关于命令行安装和静默安装,大家可以下载人大金仓官网的安装手册自行安装。
对于选择客户端安装集或定制安装集的数据库,后续可根据需要增加其他未安装的功能组件。
运行安装程序 KingbaseES_V008R006C006B0021_Win64_install.exe,以管理员身份运行。选择“修改存在的实例”并选中安装目录,点击“确定”按钮。
选择【添加功能】选项,点击【下一步】。
点击【取消】按钮,可以退出,若无特殊说明,以下各步骤皆与此相同。
点击【下一步】按钮,继续安装;点击【取消】按钮,取消安装。
您可以选中需要添加的功能组件,置灰无法选择的组件是已经安装的组件。点击【下一步】按钮,继续安装。
此步骤用于显示安装进度。如果选择的组件包含数据库服务器,则后续会继续选择授权文件、初始化数据库步
骤。
若安装过程中没有出现任何警告或错误,将显示如下界面。单击【完成】退出安装程序
关于删除组件,大家可以下载人大金仓官网的安装手册自行操作。
关于命令行增删组件,大家可以下载人大金仓官网的安装手册自行安装。
我们使用刚刚安装的数据库开发和管理工具来创建数据库和数据表。
点击数据库 >> 新建连接。
选择默认数据库 >> 【下一步】。
输入刚才安装时设置的密码后,点击左下角测试链接。
连接成功会出现下图弹窗。
表空间 >> 【新建表空间】,创建数据表。
这里我们简单创建3张表,分别是用户表sys_user
、角色表sys_role
、菜单功能表sys_feature
、用户角色映射表sys_userrole
、角色菜单映射表sys_rolefeature
。
id作为主键
id作为主键
id作为主键
id作为主键
这里ID之所以用36位字符,是软件里准备使用GUID,是微软对UUID标准的实现。
至于为什么是36位,原因如下:
这取决于您格式化Guid的方式:
Guid.NewGuid().ToString()
=> 36个字符(带连字符的)
输出:12345678-1234-1234-1234-123456789abc
Guid.NewGuid().ToString("D")
=> 36个字符(连字符,与相同ToString()
)
输出:12345678-1234-1234-1234-123456789abc
Guid.NewGuid().ToString("N")
=> 32个字符(仅数字)
输出:12345678123412341234123456789abc
Guid.NewGuid().ToString("B")
=> 38个字符(大括号)
输出:{12345678-1234-1234-1234-123456789abc}
Guid.NewGuid().ToString("P")
=> 38个字符(括号)
输出:(12345678-1234-1234-1234-123456789abc)
Guid.NewGuid().ToString("X")
=> 68个字符(十六进制)
输出:{0x12345678,0x1234,0x1234,{0x12,0x34,0x12,0x34,0x56,0x78,0x9a,0xbc}}
SqlSugar 是一款 老牌 .NET 开源ORM框架,由果糖大数据科技团队维护和更新 ,开箱即用最易上手的ORM框架 ,51Job和Boss直招简历数超过 国外框架 Nhibernate PetaPoco, 仅次于Dapper和EF Core , 占Dapper 40% 。
关系型数据库 | MySql、SqlServer、Sqlite、Oracle 、 postgresql、达梦、人大金仓、神通数据库、瀚高、Access 、MySqlConnector、华为 GaussDB 、南大通用 GBase 、Odbc、自定义 |
---|---|
时序数据库 | QuestDb (适合几十亿数据分析,模糊查询,自动分表存储 ,缺点不支持删除) |
列式存储库 | Clickhouse(适用于商业智能领域(BI),缺点大小写必须和库一样,不支持事务) |
即将上线 | Mongodb(mongodb.entities)TDengine、Sybase… |
点击项目引用 >> 右键 Nuget管理
.Net Core 3 & 5 & 6 &7
博主这里因为需要对SqlSugar做一些修改,所以用了源码,结构如下,
分为R6和R3一定要看 下面的安装 小有区别
public enum DbType
{
MySql ,
SqlServer,
Sqlite,
Oracle,
PostgreSQL,
Dm,
Kdbndp // 人大金仓 只支持.NET CORE
}
R3
版本只需要引用 SqlSugarCore
R6
版本需要单独安装 SqlSugarCore.Kdbndp 6.1 和 SqlSugarCore
基本上和PgSql一模一样更贴近开发功能也继承了pgsql所有功能,对开发人员比较友好
appsettings.json配置
"ConnectionStrings": {
"kdbndp": "data source=127.0.0.1;database=test;Port=54321;UID=SYSTEM;PWD=system", //测试版本用人大金仓数据库
},
UnitOfWork.cs 工作单元实现
using Microsoft.AspNetCore.Http;
using Microsoft.Extensions.Configuration;
using SqlSugar;
using System;
namespace Sys.Infrastructure.Data
{
///
/// 工作单元实现
///
public abstract class UnitOfWork : IUnitOfWork
{
public UnitOfWork(IConfiguration configuration, IHttpContextAccessor accessor)
{
Configuration = configuration;
HttpContextAccessor = accessor;
}
protected IConfiguration Configuration { get; set; }
public IHttpContextAccessor HttpContextAccessor { get; set; }
protected DateTime StartTime { get; set; }
protected DateTime EndTime { get; set; }
public SqlSugarClient Db { get; protected set; }
public void BeginTran() => Db.BeginTran();
public void CommitTran()
{
try
{
Db.CommitTran();
}
catch (Exception ex)
{
Db.RollbackTran();
throw ex;
}
}
public void RollbackTran() => Db.RollbackTran();
}
}
KdbndpOfWork.cs
using Microsoft.AspNetCore.Http;
using Microsoft.Extensions.Configuration;
using Newtonsoft.Json;
using Serilog;
using SqlSugar;
using Supcon.APS.Common;
using Supcon.APS.Domain.Core;
using Supcon.APS.Domain.Entities;
using Supcon.APS.Domain.Entities.Sys;
using Supcon.APS.Domain.IRepository;
using System;
using System.IO;
using System.Linq;
namespace Sys.Infrastructure.Data
{
public class KdbndpOfWork : UnitOfWork, IUnitOfWork
{
public KdbndpOfWork(IConfiguration configuration, IHttpContextAccessor accessor) : base(configuration, accessor)
{
Db = new SqlSugarClient(new ConnectionConfig
{
ConnectionString = configuration.GetConnectionString("kdbndpdb"), //数据库连接在 appsettings.json 中配置
DbType = DbType.Kdbndp,
IsAutoCloseConnection = true,
IsShardSameThread = true,
AopEvents = new AopEvents
{
OnLogExecuted = OnLogExecuted,
OnLogExecuting = OnLogExecuting,
OnError = OnError
}
});
}
///
/// 当数据库操作执行出错时
///
///
private static void OnError(SqlSugarException exception)
{
}
///
/// 当数据库操作执行时
///
///
///
private static void OnLogExecuting(string sql, SugarParameter[] parameters)
{
//StartTime = DateTime.Now;
}
///
/// 当数据库操作执行完毕后
///
///
///
private static void OnLogExecuted(string sql, SugarParameter[] parameters)
{
// EndTime = DateTime.Now;
//CreateHttpSqlLog(sql, parameters);
}
}
}
仓储(包含查询、多表查询、插入、更新、删除等方法)
public interface IRepository : IRepository
where TEntity : ApsEntity, new()
{
}
public interface ISupplyChanRepository : IRepository
where TEntity : SupplyChanEntity, new()
{
}
public interface IRepository
where TEntity : Entity, new()
where TUnitOfWork : IUnitOfWork
{
#region 查询
///
/// 是否存在满足指定条件的数据
///
/// 条件表达式
///
bool IsExist(Expression> whereExpression);
///
/// 统计数据条数
///
/// 条件表达式
///
int Count(Expression> whereExpression = null);
///
/// 获取一条数据
///
/// 条件表达式
///
Task SingleAsync(Expression> whereExpression);
///
/// 查询
///
///
Task> QueryAsync();
///
/// 查询
///
/// 查询字符串
///
Task> QueryAsync(string strWhere);
///
/// 查询
///
/// 条件表达式
///
Task> QueryAsync(Expression> whereExpression);
///
/// 查询
///
/// 查询字符串
/// 排序字段,如:Name Asc, Age Desc
///
Task> QueryAsync(string strWhere, string strOrderByFileds);
///
/// 查询
///
/// 条件表达式
/// 排序字段,如:Name Asc, Age Desc
///
Task> QueryAsync(Expression> whereExpression, string strOrderByFileds);
///
/// 查询
///
/// 条件表达式
/// 排序表达式
/// 是否为升序
///
Task> QueryAsync(Expression> whereExpression, Expression> orderByExpression, bool isAsc = true);
///
/// 查询前 N 条数据
///
/// 条件表达式
/// 记录数
/// 排序字段,如:Name Asc, Age Desc
///
Task> TopAsync(
Expression> whereExpression,
int count,
string strOrderByFileds);
///
/// 查询前 N 条数据
///
/// 条件字符串
/// 记录数
/// 排序字段,如:Name Asc, Age Desc
///
Task> TopAsync(
string strWhere,
int count,
string strOrderByFileds);
///
/// 分页查询
///
/// 条件字符串
/// 当前页数
/// 分页大小
/// 排序字段,如:Name Asc, Age Desc
/// 总记录数
///
List Pages(string strWhere, int pageIndex, int pageSize, string strOrderByFileds, out int totalCount);
///
/// 分页查询
///
/// 条件表达式
/// 当前页数
/// 分页大小
/// 排序表达式
/// 是否为升序
/// 总记录数
///
List Pages(Expression> whereExpression,
int pageIndex, int pageSize, Expression> orderByExpression, bool isAsc,
out int totalCount);
///
/// 多表查询
///
/// 实体1
/// 实体2
/// 返回类型
/// 关联表达式 (join1, join2) => new object[] { JoinType.Left, join1.UserNo == join2.UserNo }
/// 返回表达式 (s1, s2) => new { Id =s1.UserNo, Id1 = s2.UserNo }
/// 查询表达式 (w1, w2) => w1.UserNo == "")
///
Task> QueryMuchAsync(
Expression> joinExpression,
Expression> selectExpression,
Expression> whereLambda = null) where T1 : class, new();
///
///多表查询
///
Task> QueryMuchAsync(
Expression> joinExpression,
Expression> selectExpression,
Expression> whereLambda = null) where T1 : class, new();
///
///多表查询
///
Task> QueryMuchAsync(
Expression> joinExpression,
Expression> selectExpression,
Expression> whereLambda = null) where T1 : class, new();
Task> QueryMuchAsync(
Expression> joinExpression,
Expression> selectExpression,
Expression> whereLambda = null) where T1 : class, new();
Task> QueryMuchAsync(
Expression> joinExpression,
Expression> selectExpression,
Expression> whereLambda = null) where T1 : class, new();
#endregion
#region 新增
///
/// 新增
///
/// 实体(集合)
///
Task> AddAsync(params TEntity[] entities);
///
/// 新增
///
/// 实体
/// 指定要插入的列
///
Task AddAsync(TEntity entity, Expression> insertColumns);
///
/// 新增
///
/// 实体集合
/// 指定要插入的列
///
Task> AddAsync(TEntity[] entities, Expression> insertColumns);
#endregion
#region 更新
///
/// 更新
///
/// 实体
/// 指定要更新的列
/// 指定要忽略的列
///
Task UpdateAsync(TEntity entity,
Expression> updateColumns = null,
Expression> ignoreColumns = null);
///
/// 更新
///
/// 实体集合
/// 指定要更新的列
/// 指定要忽略的列
///
Task UpdateAsync(TEntity[] entities,
Expression> updateColumns = null,
Expression> ignoreColumns = null);
///
/// 更新
///
/// 条件表达式
/// 要更新的值(匿名对象)
///
Task UpdateAsync(Expression> whereExpression, dynamic anonymous);
#endregion
#region 删除
///
/// 删除(Support IPhantomEntity)
///
/// 实体(集合)
///
Task DeleteAsync(params TEntity[] entities);
///
/// 删除(Support IPhantomEntity)
///
/// 主键(集合)
///
Task DeleteAsync(params TKey[] ids);
/
/ 删除(Support IPhantomEntity)
/
/ 条件表达式
/
//Task DeleteAsync(Expression> whereExpression);
/
/ 删除(Support IPhantomEntity)
/
/ 条件字符串
/
//Task DeleteAsync(string strWhere);
#endregion
#region 更新或新增
///
/// 更新或插入
/// http://www.codeisbug.com/Doc/8/1172
///
/// 实体
/// 指定要更新或插入的列
/// 指定要忽略的列
///
TEntity UpsertAsync(TEntity entity,
Expression> upsertColumns = null,
Expression> ignoreColumns = null);
///
/// 更新或插入
/// http://www.codeisbug.com/Doc/8/1172
///
/// 实体集合
/// 指定要更新或插入的列
/// 指定要忽略的列
///
Task> UpsertAsync(List entities,
Expression> upsertColumns = null,
Expression> ignoreColumns = null);
///
/// 更新或插入
///
/// 实体
/// 指定要插入的列
/// 指定要忽略的插入列
/// 指定要更新的列
/// 指定要忽略的更新列
///
TEntity UpsertAsync(TEntity entity,
Expression> insertColumns = null,
Expression> ignoreInsertColumns = null,
Expression> updateColumns = null,
Expression> ignoreUpdateColumns = null);
///
/// 更新或插入
///
/// 实体集合
/// 指定要插入的列
/// 指定要忽略的插入列
/// 指定要更新的列
/// 指定要忽略的更新列
///
Task> UpsertAsync(List entities,
Expression> insertColumns = null,
Expression> ignoreInsertColumns = null,
Expression> updateColumns = null,
Expression> ignoreUpdateColumns = null);
#endregion
}
通用实体
public abstract class Entity
{
[SugarColumn(IsPrimaryKey = true)]
public virtual TKey Id { get; set; }
}
public abstract class KdbndpEntity : Entity, IPhantomEntity
{
public KdbndpEntity()
{
Id = GuidGenerator.Current.Create();
}
///
/// 创建时间
///
[SugarColumn(ColumnName = "create_time", IsOnlyIgnoreInsert = true, IsOnlyIgnoreUpdate = true)]
public virtual DateTime CreateTime { get; set; } = DateTime.Now;
///
/// 更新时间
///
[SugarColumn(ColumnName = "update_time", IsNullable = true, IsOnlyIgnoreInsert = true, IsOnlyIgnoreUpdate = true)]
public virtual DateTime? UpdateTime { get; set; }
[SugarColumn(ColumnName = SqlSugarConst.PhantomColumnName)]
public bool IsDeleted { get; set; }
public virtual string GetMainKey()
{
return this.Id.ToString();
}
}
用户表实体
///
/// 用户表
///
[SugarTable("sys_user")]
public class User : KdbndpEntity
{
///
/// 用户名
///
public string Username { get; set; }
///
/// 昵称
///
public string Nickname { get; set; }
///
/// 手机
///
public string Phone { get; set; }
///
/// 邮箱
///
public string Email { get; set; }
///
/// 密码
///
public string Password { get; set; }
}
用户表仓储接口
///
/// 用户表仓储接口
///
public interface IUserRepository : IRepository
{
}
用户表仓储
public class UserRepository : Repository, IUserRepository
{
public UserRepository(KdbndpOfWork unitOfWork) : base(unitOfWork)
{
}
}
多表查询
public List Query(UserQuery query)
{
return Db.Queryable((p, userRole) => p.RoleId == userRole.Id)
.WhereIF(!IsNullOrEmpty(query.Username), p => p.Username.Contains(query.Username, StringComparison.OrdinalIgnoreCase))
.WhereIF(!IsNullOrEmpty(query.Nickname), p => p.Nickname == query.Nickname)
.WhereIF(!IsNullOrEmpty(query.RoleName), (p, userRole) => userRole.Id.Contains(query.Id, StringComparison.OrdinalIgnoreCase))
.Select((p, unitType) =>
new UserModel()
{
Username = p.Username,
Nickname = p.Nickname,
CreateTime = p.CreateTime,
Phone = p.Phone,
Password = p.Password,
Id = p.Id,
RoleId = userRole.Id.ToString(),
UpdateTime = p.UpdateTime,
Email=p.Email
}
).ToList();
}
插入
//返回插入行数
db.Insertable(insertObj).ExecuteCommand(); //都是参数化实现 //插入返回自增列db.Insertable(insertObj).ExecuteReturnIdentity(); //返回雪花ID 看文档3.1具体用法(在最底部)
long id= db.Insertable(实体).ExecuteReturnSnowflakeId();
本文主要介绍了SqlSugar访问人大金仓数据库的实战,当然这仅仅只是SqlSugar的基本用法。下一篇文章,我们将介绍通过SqlSugar的工作单元模式进行多数据库访问,包括多类型MySQL、人大金仓、达梦等数据,或者同一种数据库的多个库。
文章中出现的任何错误请大家批评指出,一定及时修改。
希望写在这里的小伙伴能给个三连支持!