CYQ.Data 支持 KingbaseES人大金仓数据库

KingbaseES人大金仓数据库介绍：

KingbaseES是一种关系型数据库管理系统，也被称为人大金仓数据库。KingbaseES 是北京人大金仓信息技术股份有限公司研发的，具有自主知识产权的通用数据库产品。

该产品面向事务处理类应用，兼顾各类数据分析类应用，可用做管理信息系统、业务及生产系统、决策支持系统、多维数据分析、全文检索、地理信息系统、图片搜索等的承载数据库。

作为KingbaseES产品系列最新一代版本，KingbaseESV8在系统的可靠性、可用性、性能和兼容性等方面进行了重大改进。

以下是一些关于KingbaseES数据库的特点和功能：

1. 数据库引擎：KingbaseES是基于开源数据库PostgreSQL开发的，具备PostgreSQL的核心功能。它继承了PostgreSQL的可靠性、稳定性和高度兼容性，同时加入了自主创新的技术和功能。

2. 兼容性：KingbaseES与其他主流数据库（如Oracle、SQL Server等）具有较高的兼容性，可以迁移和运行现有的应用程序和数据库对象。这使得企业能够更容易地将现有的应用程序和数据迁移到KingbaseES上。

3. 分布式存储和高可用性：KingbaseES支持分布式数据库和高可用架构，可以实现数据的分布式存储和在多个节点之间的数据复制和同步，提供高可用性和容错性。

4. 安全性：KingbaseES提供了强大的安全性功能，包括角色和用户管理、访问控制、数据加密等，以确保数据库的安全性和数据的保密性。

5. 多语言支持：KingbaseES支持多种编程语言和开发工具，包括Java、C#、Python等，使得开发人员能够使用自己熟悉的语言来开发和管理数据库应用程序。

6. 大数据处理：KingbaseES具备处理大规模数据和高并发访问的能力，支持大数据处理和分析，适用于需要处理海量数据和高性能计算的场景。

总体而言，KingbaseES是一个功能强大、稳定可靠、兼容性好的关系型数据库管理系统。

它在中国企业和政府机构中得到广泛应用，特别是那些希望建立在成熟开源技术基础上，同时具备商业级支持和增强功能需求的组织。

CYQ.Data 框架简介：

CYQ.Data 是一个高性能且功能强大的ORM（对象关系映射）框架，支持包括.NET Core在内的各种.NET版本。

它设计用于与多种数据库如MSSQL、MySQL、Oracle、Sybase、PostgreSQL、DB2、FireBird、SQLite、DaMeng、KingBaseES等，以及格式如Txt、Xml、Access、Excel和FoxPro等工作。

该框架旨在通过提供写日志、操作JSON和分布式缓存等功能，简化数据层操作，无需额外的库如Log4net.dll、newtonjson.dll或Memcached.ClientLibrary.dll。

该框架自豪于其低调但持续15年的更新，强调其长期可靠性和对开发人员寻找稳定且多功能ORM解决方案的支持。

前言：

去年有群友问我，CYQ.Data 支不支国产数据库，那时候，没支持，只是给了些提示，让其自行通过开源代码支持了。

后来问的人多了，就开始支持了。

CYQ.Data 从去年年底开始支持国产数据库，下面就开始介绍相关内容。

1、开源地址：

https://github.com/cyq1162/cyqdata

2、 Nuget 引用

可以通过 nuget 管理器，直接搜 cyqdata，找到对应的 KingBaseES 版本，引入即可。

 

cyq.data 原始版本和 cyq.data.kingbasees 版本的区别：

cyq.data 原始版本：

　　不包含其它数据库驱动，需要自行引用对应数据的驱动：比如使用mysql数据库时，需要再引用 mysql.data.dll 驱动。如果引用 cyq.data.mysql，则里面包含了 mysql.data.dll 驱动。

cyq.data.kingbasees 版本：

　　同样，里面集成了对应的数据库驱动，不用再单独引用。

3、支持的版本：

从下图可以看如，由于官方驱动未支持.net 2.0的原因，因此从.net 4.0 一路支持到 .net 8 及以上。

4、数据库链接语句：

 随便 CYQ.Data 支持的数据库越多，有些数据库的语句都一样，无法再根据关键字信息来识别，于是在语句上支持了provider：

链接语句示例：

provider=kingbasees;server=127.0.0.1;User Id=system;Password=123456;Database=test;Port=54321;schema=public;

链接语句配置：

{
  "ConnectionStrings": {
    "Conn": "provider=provider=kingbasees;server=127.0.0.1;User Id=system;Password=123456;Database=test;Port=54321;schema=public;"

  }
}

5、使用示例：

框架默认会引用配置中 Conn 的链接，所以在代码中无需指定。

1、无实体：

使用 MAction 操作表、视图，带分页：

using (MAction action = new MAction("表名、视图名、sql查询语句"))
{
    MDataTable dt = action.Select(1, 10, "id>10");
}

使用 MProc 操作原始sql语句或存储过程：

using (MProc proc=new MProc("sql语句、存储过程名"))
{
    MDataTable dt = proc.ExeMDataTable();
}

2、有实体：

A、纯实体

public class Users
{
    public int ID { get; set; }
    public string Name { get; set; }
}

使用：

List<Users> users=DBFast.Select<Users>(1,10,"id>10");

B、实体继承自 CYQ.Data.Orm

public class Users:CYQ.Data.Orm.SimpleOrmBase<Users>
{
    public Users()
    {
        base.SetInit(this, "表名");
    }
    public int ID { get; set; }
    public string Name { get; set; }
}

使用：

using(Users user = new Users())
{
    List<Users> users = user.Select(1, 10, "id>10");
}

以上仅展示查询功能，CYQ.Data 的操作，对十多种数据库，操作都是一致的。

如果还没有学过，可以看 CYQ.Data 相关教程。

1、V4 系列：https://www.cnblogs.com/cyq1162/category/216965.html

2、V5 系列：https://www.cnblogs.com/cyq1162/category/852300.html

6、KingBaseES 人大金仓数据库的基础说明：

在安装或使用 KingBaseES 人大金仓数据库时，可以通过安装后的数据库开发工具KStudio管理工具，来管理数据库

启动，输入账号进入界面后：

可以看到，默认都是小写标识，语句的关键字，是通过双引号包括起来。

而且和上篇文章介绍的：CYQ.Data 支持 DaMeng 达梦数据库 明显不同。

关键信息：

1、KingBaseES 人大金仓数据库 是多数据库、多模式。
2、public 为默认模式，因此，默认情况下，我们可以在 public 模式下新建表即可。

一开始没发现 public 是默认模式，都是新建模式在测试，这让我在一开始的时候，有点绕。

重新看一下这个示例的数据库链接语句：

provider=kingbasees;server=127.0.0.1;User Id=system;Password=123456;Database=test;Port=54321;schema=public;

从这个示例链接中，我们不仅要指定Database，同时也需要指定schema。

做为一篇介绍框架支持数据库的文章，就不过多的介绍介绍数据库本身了，有用到的，可以上官方了解更多。

总结：

CYQ.Data 是一个用于操作数据库的框架，可以方便地连接和管理各种类型的数据库。在操作 KingBaseES 人大金仓数据库时，使用 CYQ.Data 框架可以提供以下功能和优势：

1. 连接数据库：CYQ.Data 可以轻松地建立与 KingBaseE 数据库的连接，通过简单的配置即可实现连接功能，节省了开发人员的时间和精力。

2. 执行 SQL 查询：使用 CYQ.Data 可以方便地执行各种 SQL 查询操作，包括查询数据、更新数据、插入数据等，同时还支持事务处理，确保数据操作的准确性和完整性。

3. 参数化查询：CYQ.Data 支持参数化查询，可以有效防止 SQL 注入攻击，提高数据库操作的安全性。

4. 数据库事务：通过 CYQ.Data 框架可以轻松管理数据库事务，确保多个操作的原子性，避免数据不一致的情况发生。

总的来说，使用 CYQ.Data 框架操作 KingBaseES 数据库可以简化开发流程，提高开发效率，同时也增强了系统的稳定性和安全性。