C# SqlSugar多数据库连接配置详解

# 1. 简介

- 1.1 介绍C#中的ORM框架SqlSugar
- 1.2 多数据库连接的需求及好处

# 2. SqlSugar配置基础

- 2.1 引入SqlSugar库
- 2.2 单数据库连接配置详解

在使用SqlSugar之前，我们首先需要在项目中引入SqlSugar库。通过NuGet包管理器或手动下载导入均可。

### 2.1 引入SqlSugar库

在Visual Studio中，可以通过NuGet包管理器搜索SqlSugar并进行安装：

Install-Package SqlSugar

### 2.2 单数据库连接配置详解

在配置单数据库连接时，需要先定义连接字符串，并创建SqlSugar实例，示例代码如下：

using SqlSugar;

public class DbManager
{
    public static SqlSugarClient GetInstance()
    {
        // 数据库连接字符串
        string connectionString = "Server=127.0.0.1;Database=mydb;Uid=root;Pwd=123456;";

        // 创建SqlSugar实例
        var db = new SqlSugarClient(connectionString);

        return db;
    }
}

在上述代码中，首先定义了数据库连接字符串，然后通过该连接字符串创建了一个SqlSugar实例。这样就可以使用SqlSugar进行数据库操作了。

# 3. 实现多数据库连接

在实际项目开发中，我们经常需要同时连接多个数据库。这可能是因为业务需要访问不同的数据库实例，也可能是为了读写分离或主从配置。使用SqlSugar可以轻松实现多数据库连接，下面我们来看如何操作：

#### 3.1 定义多个数据库连接字符串

首先，在配置文件（如appsettings.json）中定义多个数据库连接字符串，每个字符串代表一个数据库实例，如下所示：

{
  "ConnectionStrings": {
    "Db1": "Server=server1;Database=db1;Uid=username;Pwd=password;",
    "Db2": "Server=server2;Database=db2;Uid=username;Pwd=password;"
  }
}

#### 3.2 创建多个SqlSugar实例

接下来，在代码中创建多个SqlSugar实例，分别对应不同的数据库连接字符串，示例代码如下：

using SqlSugar;

class Program
{
    static void Main(string[] args)
    {
        string db1ConnStr = Configuration.GetConnectionString("Db1");
        string db2ConnStr = Configuration.GetConnectionString("Db2");
        // 创建第一个数据库连接
        SqlSugarClient db1 = new SqlSugarClient(new ConnectionConfig()
        {
            ConnectionString = db1ConnStr,
            DbType = DbType.MySql,
            IsAutoCloseConnection = true
        });
        // 创建第二个数据库连接
        SqlSugarClient db2 = new SqlSugarClient(new ConnectionConfig()
        {
            ConnectionString = db2ConnStr,
            DbType = DbType.MySql,
            IsAutoCloseConnection = true
        });
        // 使用db1和db2执行数据库操作
    }
}

通过以上步骤，我们成功实现了在C#项目中使用SqlSugar连接多个数据库实例的配置。这样可以更灵活地处理不同数据库之间的数据交互，提高项目的可扩展性和性能。

# 4. 数据库连接池管理

在SqlSugar中，我们可以通过配置数据库连接池相关参数来管理数据库连接池，以优化性能。接下来将介绍如何配置和使用数据库连接池：

#### 4.1 配置数据库连接池相关参数

首先，我们需要配置数据库连接池的相关参数，例如连接池大小、最小空闲连接数、连接超时时间等。以下是一个示例配置：

// 设置连接池最大连接数
SqlSugar.SqlSugarClient db = new SqlSugarClient(new ConnectionConfig()
{
    ConnectionString = "YourConnectionString",
    DbType = DbType.SqlServer,
    IsAutoCloseConnection = true,
    InitKeyType = InitKeyType.Attribute,
    Aop = AopUnity.GetAop(),
    MoreSettings = new ConnMoreSettings()
    {
        ConnectionString = new List<string>()
        {
            "YourConnectionString1",
            "YourConnectionString2"
        },
        CusMasterConnection = new MasterConnectionConfig()
        {
            ConnectionString = "YourMasterConnectionString",
            DbType = DbType.SqlServer,
        },
        GetConnectionFunc = () =>
        {
            return new SqlConnection("YourConnectionString");
        },
    },
});
// 设置连接池最小空闲连接数
db.Ado.SetFreePoolSize(5);
// 设置连接超时时间（单位：秒）
db.Ado.CommandTimeOut = 30;

在以上示例中，我们配置了连接池最大连接数、连接池最小空闲连接数以及连接超时时间。

#### 4.2 使用连接池优化性能

一旦配置了数据库连接池的相关参数，SqlSugar会自动管理数据库连接池，从而提高数据库连接的效率和性能。确保及时释放数据库连接，以便其他请求可以重复使用连接，减少连接创建和销毁的开销。

通过合理配置数据库连接池参数，可以大大提升系统的性能和响应速度，特别是在高并发的场景下效果更为明显。

这就是如何配置和管理数据库连接池，以优化SqlSugar的性能。下一节将介绍如何实现读写分离配置。

# 5. 读写分离配置

在实际的项目中，为了优化数据库读写操作，常常会配置读写分离，即主数据库用于写入操作，从数据库用于读取操作。下面将详细介绍如何使用SqlSugar实现读写分离配置。

#### 5.1 使用SqlSugar实现读写分离

通过SqlSugar的配置，我们可以很方便地实现读写分离。首先，我们需要在配置数据库连接时指定主数据库和从数据库的连接字符串。然后，在使用数据库操作时，根据需求选择主从数据库进行读写操作。

// 配置数据库连接字符串
var masterDbConnection = "Server=masterServer;Database=masterDb;Uid=user;Pwd=password;";
var slaveDbConnection = "Server=slaveServer;Database=slaveDb;Uid=user;Pwd=password;";

// 创建SqlSugar实例
var masterDb = new SqlSugarClient(new ConnectionConfig
{
    ConnectionString = masterDbConnection,
    DbType = DbType.MySql, // 设置数据库类型
    IsAutoCloseConnection = true, // 自动关闭数据库连接
});

var slaveDb = new SqlSugarClient(new ConnectionConfig
{
    ConnectionString = slaveDbConnection,
    DbType = DbType.MySql,
    IsAutoCloseConnection = true,
});

// 写入操作使用主数据库
var insertResult = masterDb.Insertable(entity).ExecuteCommand();

// 读取操作使用从数据库
var queryResult = slaveDb.Queryable<Entity>().ToList();

#### 5.2 配置主从数据库连接

除了在代码中指定主从数据库的连接字符串外，我们还可以通过SqlSugar的配置文件来简化主从数据库的连接配置。在配置文件中指定主数据库和从数据库的连接信息，然后在代码中引用配置文件中的连接信息即可实现读写分离。

// 从配置文件中读取连接字符串
var masterDbConnection = ConfigurationManager.ConnectionStrings["masterDb"].ConnectionString;
var slaveDbConnection = ConfigurationManager.ConnectionStrings["slaveDb"].ConnectionString;

通过以上配置和代码实现，我们可以轻松地在项目中实现数据库的读写分离配置，从而优化数据库的读写性能，提升系统的稳定性和性能。

# 6. 高级配置与注意事项

在使用SqlSugar进行多数据库连接配置时，还有一些高级配置和需要注意的事项需要我们关注。下面将详细介绍这些内容：

#### 6.1 配置数据库类型与版本

在SqlSugar中，我们需要根据具体的数据库类型和版本进行相应的配置。比如，如果我们连接的是MySQL数据库，需要在SqlSugar的初始化配置中指定数据库类型为MySQL，以确保SqlSugar在执行SQL语句时能够正确地识别和处理MySQL特有的语法，从而避免出现错误。

// 配置MySQL数据库连接
SqlSugarClient db = new SqlSugarClient(new ConnectionConfig() {
    ConnectionString = "YourMySQLConnectionString",
    DbType = DbType.MySql,
    IsAutoCloseConnection = true
});

另外，在处理不同版本的数据库时，也需要注意数据库版本的差异可能会导致一些功能的不同实现或对SQL语法的支持程度不同，因此在使用SqlSugar时，建议根据实际情况选择合适的数据库版本，并了解该版本对应的SqlSugar支持情况。

#### 6.2 注意事项与常见问题解决

在配置多数据库连接时，有一些常见的注意事项和问题需要我们留意，以避免出现意外情况：

- **连接字符串安全性：** 在配置数据库连接字符串时，应注意不要将敏感信息硬编码在代码中，可以将连接字符串保存在配置文件中，并通过读取配置文件的方式获取连接字符串，确保连接字符串的安全性。

- **连接池大小设置：** 在进行数据库连接池管理时，应根据系统的并发量和数据库连接情况合理设置连接池的大小，避免连接池过小导致连接瓶颈，或过大导致资源浪费和性能下降。

- **事务管理：** 在多数据库连接操作中，需要注意事务的管理，确保事务的原子性和一致性。可以使用SqlSugar提供的事务管理功能，对多个操作进行事务封装，以保证数据操作的完整性。

通过对高级配置和注意事项的了解和实践，我们可以更好地利用SqlSugar实现多数据库连接配置，并确保系统的安全性和性能稳定性。