.NET/C#大型项目研发必备(14)--数据库的负载均衡(续)

前言：本系列文章适合有初/中级.NET知识的同学阅读。
（1）本系列文章，旨在讲述研发一个中大型项目所需要了解的一系列“基本构件”，并提供这些“基本构件”的【最简单】、【最快速】使用方法！！（并不深究技术原理）
（2）通过阅读本系列文章，能让你在正规“项目研发”方面快速入门+进阶，并能达成“小团队构建大网站”的目的。
（3）本系列文章采用的技术，已成功应用到人工智能、产业互联网、社区电商、游戏、金融风控、智慧医疗、等项目上。

本文主要讲述“异种数据库”的负载均衡。其实现方式是基于前述“数据库的负载均衡”这篇文章的内容发展而来，请先对其阅读参考。

下面就通过一个例子，给出实现“异种数据库”负载均衡的两种方法。

若是在.Net Core环境下，把配置负载均衡策略的DeveloperSharp.json文件修改为多个异种数据库，如下：

{
  "DeveloperSharp":
  {
     "DatabaseClusterList":
     [
        {
           "Id":"StudentData",
           "DatabaseCluster":
           [
                 {
                     "Id":"A1",
                     "Enable":"true",
                     "Weight":"100",
                     "DatabaseType":"SqlServer",
                     "ConnectionString":"Server=localhost;Database=YZZ;Uid=sa;Pwd=123"
                 },
                 {
                     "Id":"A2",
                     "Enable":"true",
                     "Weight":"100",
                     "DatabaseType":"MySql",
                     "ConnectionString":"Host=localhost;Database=YZZ;User Id=root;password=123"
                 },
                 {
                     "Id":"A3",
                     "Enable":"true",
                     "Weight":"100",
                     "DatabaseType":"PostgreSql",
                     "ConnectionString":"Server=127.0.0.1;Database=YZZ;Port=5432;User Id=postgres;Password=123;"
                 }
           ]
        }
     ]
  }
}

若是在.Net Framework环境下，把配置负载均衡策略的DeveloperSharp.xml文件修改为多个异种数据库，如下：

<?xml version="1.0" encoding="utf-8" ?>
<DeveloperSharp>
    <DatabaseClusterList>
        <DatabaseCluster Id="StudentData">
            <Database Id="A1" Enable="true" Weight="100" DatabaseType="SqlServer" ConnectionString="Server=localhost;Database=YZZ;Uid=sa;Pwd=123"/>
            <Database Id="A2" Enable="true" Weight="100" DatabaseType="MySql" ConnectionString="Host=localhost;Database=YZZ;User Id=root;password=123"/>
            <Database Id="A3" Enable="true" Weight="100" DatabaseType="PostgreSql" ConnectionString="Server=127.0.0.1;Database=YZZ;Port=5432;User Id=postgres;Password=123;"/>
        </DatabaseCluster>
    </DatabaseClusterList> 
</DeveloperSharp>

说明：以上配置了异种的Sql Server、MySql、PostgreSql三个数据库来做负载均衡。

方法一：

SLB.IDA.ConnectionString //数据库链接字符串 
SLB.IDA.DatabaseType     //数据库类型

无论你的数据库访问工具是Entity Framework、Dapper、SqlSugar、FreeSql、等等，只要有了如上两个参数，你就能自行实现相应的数据库操作。

（注：看懂本文思路的前提，是你已经阅读过“数据库的负载均衡”这篇文章）

方法二：

var IDA = SLB.IDA;
//接下来，直接通过IDA进行各类数据库操作

【示例1：查询】
下面，首先直接给出一个“查询多数据+选出单数据+参数”的使用示例，代码如下：

   //查询多数据
   var Students1 = IDA.SqlExecute<stu>("select * from t_Student");

   //查询多数据（带参数）
   var Students2 = IDA.SqlExecute<stu>("select * from t_Student where Id>@IdMin and Name like @LikeName", new { IdMin = 2, LikeName = "%周%" });
   //另一种写法1
   var IdMin = IDA.CreateParameterInput("IdMin", DbType.Int32, 2);
   var LikeName = IDA.CreateParameterInput("LikeName", DbType.String, 50, "%周%");
   var Students3 = IDA.SqlExecute<stu>("select * from t_Student where Id>@IdMin and Name like @LikeName", LikeName, IdMin);
   //另一种写法2
   var Students4 = IDA.SqlExecute<stu>("select * from t_Student").Where(t => t.Id > 2 && t.Name.Contains("周"));

   //选出单数据
   var OneStudent = Students2.FirstOrDefault();

其中stu实体类代码如下形式：

    //此实体类中的Id、Name、Age、Birth、MyLevel属性名，要与数据表中的字段名一一对应
    public class stu
    {
        public int? Id { get; set; }//数据库中该字段若存在Null值，类型后需要加问号?
        public string Name { get; set; }
        public int? Age { get; set; }
        public DateTime? Birth { get; set; }
        public Level? MyLevel { get; set; }//也可以使用枚举，会自动转换
    }

    public enum Level
    {
        Student=100,//学生
        Teacher=200,//老师
        Manager=300,//管理员
        Principle=400//校长
    }

注意：（1）DbType类型的命名空间是System.Data
（2）若没有定义stu实体类，也可以用dynamic替代

【示例2：分页】
承接上面“示例1”的代码，若我们要对Students1、Students2进行分页操作（比如：每页20条，取出第5页），相关代码如下：

using DeveloperSharp.Extension;//调用“分页功能”需要引用此命名空间
--------------------------

   var Page1 = Students1.PagePartition(20, 5);
   var Page2 = Students2.PagePartition(20, 5);

   //一气呵成的写法
   var Page3 = IDA.SqlExecute<stu>("select * from t_Student").PagePartition(20, 5);

分页后获得的PagePiece对象中所包含的各类属性/参数，可参看这篇文章：高效分页

【示例3：增/删/改】
前面谈完“查询”，我们接下来谈谈“增/删/改”的使用方式，下面是一个“修改数据+参数+事务”的使用示例：

   try
   {
       //开启事务
       IDA.TransactionBegin();

       //修改数据（多语句）
       int affectedRows1 = IDA.SqlExecute("insert into t_Student(Name,Age)values('ww','96');update t_Student set Age=100 where Id=1006");

       //修改数据（带参数）
       int affectedRows2 = IDA.SqlExecute("insert into t_Student(Name,Age)values(@N,@A)", new { N = "孙悟空", A = 200 });
       //另一种写法
       var NewAge = IDA.CreateParameterInput("NewAge", DbType.Int32, 200);
       var NewName = IDA.CreateParameterInput("NewName", DbType.String, 50, "孙悟空");
       int affectedRows3 = IDA.SqlExecute("insert into t_Student(Name,Age)values(@NewName,@NewAge)", NewName, NewAge);

       //完成事务
       IDA.TransactionCommit();
   }
   catch
   {
       //回滚事务
       IDA.TransactionRollBack();
   }

【示例4：输出参数】
前面几个示例都只用到了“输入参数”，下面我们看看“输出参数”怎么使用，示例代码如下：

   var op1 = IDA.CreateParameterOutput("TotalCount", DbType.Int32);//此项为输出参数
   var op2 = IDA.CreateParameterOutput("MyName", DbType.String, 50);//此项为输出参数

   //以下sql语句混杂了多个“输入”与“输出”参数，注意看
   IDA.SqlExecute("insert into Friend(Birth,Name,height)values(@B,@N,@h);" +
       "select @TotalCount=count(*) from Friend;" +
       "select @MyName=Name from Friend where Id=@Id",
       new { N = "杨小伟", B = "1999-02-28 12:03:45", h = 11.023, Id = 2 },
       op1, op2);

   int tc = Convert.ToInt32(op1.Value);
   string mn = op2.Value.ToString();

【示例5：存储过程】
最后，我们来谈谈如何调用存储过程。我们创建一个存储过程，它带有输入、输出、返回三种类型的参数，代码如下：

CREATE PROCEDURE Test5
    @B as datetime,
    @N as nvarchar(50),
    @h as float,
    @TotalCount as int output,
    @MyName as nvarchar(50) output,
    @Id as int
AS
BEGIN
    insert into Friend(Birth,Name,height)values(@B,@N,@h);
    select @TotalCount=count(*) from Friend;
    select @MyName=Name from Friend where Id=@Id;
    return @TotalCount+100;
END

调用该存储过程的示例代码如下：

   var op1 = IDA.CreateParameterOutput("TotalCount", DbType.Int32);//输出参数
   var op2 = IDA.CreateParameterOutput("MyName", DbType.String, 50);//输出参数
   var op3 = IDA.CreateParameterReturn();//返回参数

   IDA.SpExecute("Test5", new { N = "杨小伟", B = "1999-02-28 12:03:45", h = 11.023, Id = 2 }, op1, op2, op3);

   int tc = Convert.ToInt32(op1.Value);
   string mn = op2.Value.ToString();
   int ret = Convert.ToInt32(op3.Value);

学习+灵活使用以上5个示例，就能满足几乎所有的数据操作需求。

另外，你有没有发现，上述所有的数据操作几乎只用了一个方法来实现：SqlExecute/ SqlExecute<T>
（更多数据库操作具体说明，请参看“DataAccess数据库访问技术(续)”这篇文章）

IDA内功能方法详细说明（辅助参考）：

SqlExecute<T>  (异步为:SqlExecuteAsync<T>)
声明：IEnumerable<T> SqlExecute<T>(string cmdText, params IDataParameter[] Params) where T : class, new()
用途：执行Sql语句(Select类)
参数：（1）string  cmdText              --  Sql语句
     （2）params IDataParameter[] Params --  参数组
返回：IEnumerable<T> --  多数据结果集

SqlExecute<T>  (异步为:SqlExecuteAsync<T>)
声明：IEnumerable<T> SqlExecute<T>(string cmdText, object InputParams, params IDataParameter[] Params) where T : class, new()
用途：执行Sql语句(Select类)
参数：（1）string  cmdText              --  Sql语句
     （2）object InputParams            --  输入参数对象
     （3）params IDataParameter[] Params --  参数组
返回：IEnumerable<T> --  多数据结果集

SqlExecute  (异步为:SqlExecuteAsync)
声明：int SqlExecute(string cmdText, params IDataParameter[] Params)
用途：执行Sql语句(Insert/Update/Delete类)
参数：（1）string  cmdText              --  Sql语句
     （2）params IDataParameter[] Params --  参数组
返回：int --  受影响的行数

SqlExecute  (异步为:SqlExecuteAsync)
声明：int SqlExecute(string cmdText, object InputParams, params IDataParameter[] Params)
用途：执行Sql语句(Insert/Update/Delete类)
参数：（1）string  cmdText              --  Sql语句
     （2）object InputParams            --  输入参数对象
     （3）params IDataParameter[] Params --  参数组
返回：int --  受影响的行数

SpExecute<T>  (异步为:SpExecuteAsync<T>)
声明：IEnumerable<T> SpExecute<T>(string cmdText, params IDataParameter[] Params) where T : class, new()
用途：执行Sp存储过程(Select类)
参数：（1）string  cmdText              --  Sp存储过程名
     （2）params IDataParameter[] Params --  参数组
返回：IEnumerable<T> --  多数据结果集

SpExecute<T>  (异步为:SpExecuteAsync<T>)
声明：IEnumerable<T> SpExecute<T>(string cmdText, object InputParams, params IDataParameter[] Params) where T : class, new()
用途：执行Sp存储过程(Select类)
参数：（1）string  cmdText              --  Sp存储过程名
     （2）object InputParams            --  输入参数对象
     （3）params IDataParameter[] Params --  参数组
返回：IEnumerable<T> --  多数据结果集

SpExecute  (异步为:SpExecuteAsync)
声明：int SpExecute(string cmdText, params IDataParameter[] Params)
用途：执行Sp存储过程(Insert/Update/Delete类)
参数：（1）string  cmdText              --  Sp存储过程名
     （2）params IDataParameter[] Params --  参数组
返回：int --  受影响的行数

SpExecute  (异步为:SpExecuteAsync)
声明：int SpExecute(string cmdText, object InputParams, params IDataParameter[] Params)
用途：执行Sp存储过程(Insert/Update/Delete类)
参数：（1）string  cmdText              --  Sp存储过程名
     （2）object InputParams            --  输入参数对象
     （3）params IDataParameter[] Params --  参数组
返回：int --  受影响的行数

推荐阅读

• .NET/C#大型项目研发必备(1)–UUID全球通用唯一识别码
• .NET/C#大型项目研发必备(2)–跨域访问
• .NET/C#大型项目研发必备(3)–数据库的负载均衡
• .NET/C#大型项目研发必备(4)–数据库的读写分离
• .NET/C#大型项目研发必备(5)–Web服务/WebApi的负载均衡
• .NET/C#大型项目研发必备(6)–IUtility工具介绍
• .NET/C#大型项目研发必备(7)–DataAccess数据库访问技术
• .NET/C#大型项目研发必备(8)–高效分页
• .NET/C#大型项目研发必备(9)–http请求调用(Post与Get)
• .NET/C#大型项目研发必备(10)–图片的裁剪、缩放、与加水印
• .NET/C#大型项目研发必备(11)–使用Redis缓存
• .NET/C#大型项目研发必备(12)–使用MQ消息队列
• .NET/C#大型项目研发必备(13)–DataAccess数据库访问技术(续)
• .NET/C#大型项目研发必备(14)–数据库的负载均衡(续)

---

如果文章对你有帮助，请点赞、收藏、关注（原创内容，欢迎转载，转载请注明出处）
出处：https://developersharp.blog.csdn.net/
【技术支持+获取更多宝贵资源，点击下方名片，备注“进群”】