sqlalchemy 分库分表

SQLSugar 是一个轻量级的 ORM 框架，它提供了分库分表的功能，能够帮助开发者在处理大量数据时，将数据分散存储到不同的数据库或表中，以提高系统的扩展性和性能，下面将详细介绍 SQLSugar 分库分表的方法。

1. 分库分表的概念

在数据量不断增长的情况下，单库单表的架构往往无法满足系统的性能需求，分库分表是一种水平拆分的策略，它将数据分散到多个数据库或表中，以减轻单一数据库的压力。

分库：将数据根据一定的规则分散到不同的数据库中。

分表：将数据根据一定的规则分散到同一个数据库的不同表中。

2. SQLSugar 分库分表的配置

在使用 SQLSugar 进行分库分表之前，需要对框架进行相应的配置。

2.1 安装 SQLSugar

通过 NuGet 安装 SQLSugar 包：

InstallPackage SqlSugar

2.2 配置 SQLSugarClient

创建 SqlSugarClient 实例，并配置分库分表的规则。

using SqlSugar;
public static class DBHelper
{
    public static SqlSugarClient GetInstance()
    {
        var db = new SqlSugarClient(new ConnectionConfig()
        {
            ConnectionString = "your_connection_string", // 数据库连接字符串
            DbType = DbType.SqlServer, // 数据库类型
            IsAutoCloseConnection = true, // 自动释放连接
            InitKeyType = InitKeyType.Attribute // 从实体特性中读取主键和自增列信息
        });
        // 配置分表策略
        db.Ado.IsEnableLogEvent = false; // 关闭日志事件
        db.Aop.OnLogExecuting = (sql, pars) =>
        {
            // 根据业务需求自定义分表规则
            // 根据用户 ID 进行分表
            var userID = pars.FirstOrDefault(it => it.ParameterName == "@UserID");
            if (userID != null && userID.Value is int id)
            {
                db.Ado.ChangeSqlTableName($"YourTable_{id % 10}", true);
            }
        };
        return db;
    }
}

3. 使用 SQLSugar 进行分库分表操作

配置完成后，可以使用 SQLSugarClient 实例进行常规的数据库操作，如查询、插入、更新和删除等，SQLSugar 会根据配置的分表规则自动选择对应的表进行操作。

3.1 查询操作

using SqlSugar;
public List<User> GetUsersByCondition(int userID)
{
    using (var db = DBHelper.GetInstance())
    {
        var users = db.Queryable<User>().Where(it => it.UserID == userID).ToList();
        return users;
    }
}

3.2 插入操作

using SqlSugar;
public bool AddUser(User user)
{
    using (var db = DBHelper.GetInstance())
    {
        return db.Insertable(user).ExecuteCommand() > 0;
    }
}

3.3 更新操作

using SqlSugar;
public bool UpdateUser(User user)
{
    using (var db = DBHelper.GetInstance())
    {
        return db.Updateable(user).ExecuteCommand() > 0;
    }
}

3.4 删除操作

using SqlSugar;
public bool DeleteUser(int userID)
{
    using (var db = DBHelper.GetInstance())
    {
        return db.Deleteable<User>().Where(it => it.UserID == userID).ExecuteCommand() > 0;
    }
}

4. 注意事项

确保分表规则的逻辑正确，避免数据丢失或重复。

在进行分表操作时，尽量避免跨表查询，以免影响性能。

根据实际业务需求调整分表策略，以获得最佳性能。

SQLSugar 提供了灵活的分库分表功能，通过简单的配置和代码实现，可以轻松实现数据的水平拆分，提高系统的扩展性和性能，在实际应用中，开发者需要根据业务需求和数据量选择合适的分库分表策略，以达到最佳的系统性能。