TORM.SqlServer
2.0.98
dotnet add package TORM.SqlServer --version 2.0.98
NuGet\Install-Package TORM.SqlServer -Version 2.0.98
<PackageReference Include="TORM.SqlServer" Version="2.0.98" />
<PackageVersion Include="TORM.SqlServer" Version="2.0.98" />
<PackageReference Include="TORM.SqlServer" />
paket add TORM.SqlServer --version 2.0.98
#r "nuget: TORM.SqlServer, 2.0.98"
#:package TORM.SqlServer@2.0.98
#addin nuget:?package=TORM.SqlServer&version=2.0.98
#tool nuget:?package=TORM.SqlServer&version=2.0.98
<p align="center"> <img src="logo.svg" width = "400" height = "200" alt="TORM Logo"/> </p>
<h1 align="center">TORM - 高性能 .NET ORM 框架</h1>
<div align="center">
轻量级、高性能、功能丰富的对象关系映射框架
TGateway 生态系统中的 ORM 组件,专为高性能场景设计。
</div>
中文
📖 项目简介
TORM 是一个为 .NET 平台设计的轻量级、高性能数据访问组件。TORM 核心和四个关系型 provider 提供完整 ORM 能力;QuestDB、TDengine 与 Apache IoTDB 扩展包使用各数据库的原生协议,提供 schema、批量写入和查询能力,不伪装成关系型 ORM,也不暴露虚假的事务、Queryable 或 Upsert 语义。
✨ 核心特性
🚀 高性能设计
- AOT:支持AOT编译
- 表达式树解析:高效的 LINQ 表达式到 SQL 转换
- 批量操作优化:支持 BulkCopy 高性能批量插入/更新
🗄️ 多数据库支持
| 数据库 | NuGet/项目 | 访问模型 | 当前能力 |
|---|---|---|---|
| MySQL / MariaDB | TORM.MySql |
关系型 ORM | CRUD、CodeFirst、事务、分表、BulkCopy、原子 Upsert |
| SQL Server | TORM.SqlServer |
关系型 ORM | CRUD、CodeFirst、事务、分表、BulkCopy、原子 Upsert |
| PostgreSQL | TORM.PostgreSql |
关系型 ORM | CRUD、CodeFirst、事务、分表、BulkCopy、原子 Upsert |
| SQLite | TORM.Sqlite |
关系型 ORM | CRUD、CodeFirst、事务、分表和批量操作 |
| QuestDB | TORM.QuestDb |
原生 REST SQL + CSV /imp |
独立 schema、表维护、TTL、临时 CSV 分批导入、拒绝行与提交状态、原生查询 |
| TDengine | TORM.TaosData |
显式 Native / WebSocket | database、stable、subtable、KEEP、非 ADO row reader、Schemaless 写入结果 |
| Apache IoTDB 2.0.8 | TORM.IoTDB |
Native API Tree / Table | 双模型 schema、CodeFirst、Record/Tablet 分批写入、连接池和原生查询 |
关系型 ORM 与时序原生客户端是明确分层的两组能力。QuestDB、TDengine 和 IoTDB 不注册 IDbProvider,也不支持 OrmClient.Queryable<T>();需要完整 ORM 语义时应使用前四种关系型 provider。
💡 丰富的功能
基础 CRUD 操作
高级功能
- 🔹 Code First:自动创建/更新数据库表结构
- 🔹 分表分库:支持时间分表、数量分表策略
- 🔹 批量操作:BulkCopy 高性能批量导入
- 🔹 事务管理:支持同步/异步事务
- 🔹 AOP 拦截:SQL 执行前后拦截,日志记录
- 🔹 JSON 支持:原生 JSON 类型支持
- 🔹 全局分表语义:实体更新/删除按分表列路由,Distinct、Count、排序和分页在跨表结果上统一执行
- 🔹 一致写入列策略:Insertable、Savable 和各关系型 BulkCopy 统一处理 identity 与
IsOnlyIgnoreInsert - 🔹 安全 SQL 方言:标识符转义、LIKE 字面量转义和比较方式由 provider 方言配置,不在表达式访问器中硬编码数据库类型
- 🔹 并发保存:数据库原生 Upsert 保持原子语义,fallback 的存在性查询和写入复用同一连接与事务
⏱️ 时序数据库原生客户端
QuestDB
TORM.QuestDb 保留 QuestDB REST /exec 查询和 /imp 导入协议。每个导入批次使用一个临时 CSV 文件并在成功、拒绝、取消或异常后删除;只有服务端明确接受后才返回 Committed,部分拒绝和全部拒绝都会抛出包含数量与原始响应的异常。
using QuestDbDriver;
using TORM.QuestDb;
using var client = new QuestDbClient(new ConnectionStringBuilder("host=127.0.0.1;port=9000"));
var tables = new QuestDbTableClient(client);
await tables.EnsureTableAsync<SensorRow>();
var writer = new QuestDbCsvBulkWriter<SensorRow>(client) { BatchSize = 1000 };
var result = await writer.WriteAsync(rows);
if (result.CommitState != QuestDbCommitState.Committed)
throw new InvalidOperationException("QuestDB batch was not committed.");
Apache IoTDB
连接串必须显式指定 Model=tree 或 Model=table。Tree 模型需要 RootPath,Table 模型需要 Database;同一个客户端不会在两种模型之间自动探测或失败回退。
using TORM.IoTDB;
var options = IoTdbConnectionOptions.Parse(
"DataSource=127.0.0.1;Port=6667;Username=root;Password=root;" +
"Model=tree;RootPath=root.gateway;PoolSize=2;FetchSize=128;ZoneId=UTC");
await using var client = new IoTdbClient(options);
await client.TreeCodeFirst.InitDeviceSchemaAsync<SensorPoint>("device_1001");
var writer = client.CreateTreeWriter<SensorPoint>("device_1001");
writer.BatchSize = 500;
await writer.InsertAsync(points);
Table 模型使用 IoTdbTableSchema、TableCodeFirst 和 CreateTableWriter<T>();Tree 模型使用 device path、measurement、TreeCodeFirst 和 CreateTreeWriter<T>()。两种模型的查询都返回 IoTdbQueryResult,时间以 UTC 毫秒进入原生协议。
TDengine
TDengine 连接必须显式选择 Protocol=Native 或 Protocol=WebSocket。当前客户端直接管理 transport 和结果生命周期,不再提供 DbConnection、DbCommand、DbDataReader 或 TaosDataOrmClient 兼容外壳。
using TORM.TaosData;
var options = TdengineConnectionOptions.Parse(
"Host=127.0.0.1;Port=6041;Username=root;Password=taosdata;Protocol=WebSocket");
using var client = new TdengineClient(options);
if (!client.CheckHealth()) throw new InvalidOperationException("TDengine is unavailable.");
var schema = new TdengineSchemaClient(client);
schema.EnsureDatabase("telemetry");
using var reader = client.Query("SELECT server_version() AS version");
Native/WebSocket 的真实异步和取消能力由 client.Capabilities 明确报告;客户端不会用 Task.Run 伪造异步,也不会在协议失败时自动切换 transport。
📊 性能测试
以下为 2026-11-22 固定 CRUD 负载的短测结果。使用本机 SQLite 和 Docker 中的 SQL Server 2022、PostgreSQL 17、MySQL 8.4,环境为 Windows 10、Ryzen 9 5900X、Release / .NET 10.0.15,固定 DOTNET_TieredCompilation=0。SQLite 统一使用 WAL + FULL。当前 1123 项定向回归通过;Count、投影、流式和分表查询另完成四库补充入口验证。
四库直接对照的 20 个组合中,TORM 有 16 个耗时中位数更低、19 个客户端 CPU 周期更少、19 个累计托管分配更少,尚未达到全部 CRUD 同时领先的目标。以下保留全部组合。
四库 CRUD:TORM 与 EF Core + BulkExtensions
每格顺序为 TORM / EF Core + BulkExtensions,GC 使用分号分隔两者。EF Core 为 10.0.15,BulkExtensions 使用对应 10.0.2 源码构建;批量写入使用 BulkExtensions,查询使用无跟踪编译查询,删除使用原生 ExecuteDeleteAsync。选列更新只修改 Age,并传输必要的 Id 匹配键。
| 数据库 | 场景 | 耗时 ms | CPU ms | 百万 CPU 周期 | 托管分配 KiB | GC 合计 |
|---|---|---|---|---|---|---|
| SQLite | 批量插入 10,000 条 | 26.67 / 35.31 | 28.65 / 36.46 | 100.70 / 125.99 | 2819.87 / 14504.62 | 0/0/0;0/0/0 |
| SQLite | 全列批量更新 10,000 条 | 32.75 / 43.19 | 33.85 / 41.67 | 118.89 / 161.16 | 2820.64 / 14506.66 | 0/0/0;0/0/0 |
| SQLite | 选列批量更新 10,000 条 | 18.16 / 26.41 | 13.02 / 23.44 | 60.47 / 91.49 | 1492.14 / 4491.22 | 0/0/0;0/0/0 |
| SQLite | 查询 25,000 条 | 43.62 / 52.50 | 44.70 / 53.82 | 167.99 / 196.27 | 3446.26 / 5006.62 | 6/0/0;6/0/0 |
| SQLite | 条件删除 10,000 条 | 5.05 / 6.58 | 5.21 / 5.21 | 12.01 / 18.03 | 4.40 / 7.59 | 0/0/0;0/0/0 |
| SQL Server | 批量插入 10,000 条 | 126.59 / 146.09 | 18.23 / 31.25 | 69.80 / 131.19 | 2132.03 / 9818.04 | 0/0/0;0/0/0 |
| SQL Server | 全列批量更新 10,000 条 | 157.55 / 340.41 | 18.23 / 31.25 | 71.13 / 128.46 | 2066.47 / 9854.93 | 0/0/0;0/0/0 |
| SQL Server | 选列批量更新 10,000 条 | 71.17 / 179.61 | 2.60 / 20.83 | 24.30 / 71.70 | 497.19 / 5852.71 | 0/0/0;0/0/0 |
| SQL Server | 查询 25,000 条 | 23.59 / 26.22 | 26.48 / 26.48 | 103.69 / 106.76 | 5496.20 / 5525.85 | 6/0/0;6/0/0 |
| SQL Server | 条件删除 10,000 条 | 15.90 / 13.83 | 2.60 / 0.00 | 1.71 / 1.95 | 6.52 / 9.19 | 0/0/0;0/0/0 |
| PostgreSQL | 批量插入 10,000 条 | 71.01 / 82.03 | 20.83 / 33.85 | 89.99 / 121.91 | 1568.78 / 4616.45 | 0/0/0;0/0/0 |
| PostgreSQL | 全列批量更新 10,000 条 | 113.78 / 121.64 | 26.04 / 31.25 | 95.54 / 118.30 | 1575.93 / 4647.15 | 0/0/0;0/0/0 |
| PostgreSQL | 选列批量更新 10,000 条 | 92.30 / 98.45 | 2.60 / 10.42 | 25.54 / 30.05 | 479.20 / 1180.27 | 0/0/0;0/0/0 |
| PostgreSQL | 查询 25,000 条 | 22.78 / 23.21 | 17.80 / 19.97 | 69.47 / 70.44 | 3461.31 / 3473.95 | 6/0/0;6/0/0 |
| PostgreSQL | 条件删除 10,000 条 | 7.86 / 8.55 | 0.00 / 0.00 | 1.34 / 1.81 | 5.32 / 8.95 | 0/0/0;0/0/0 |
| MySQL | 批量插入 10,000 条 | 100.70 / 95.12 | 15.62 / 28.65 | 60.44 / 104.50 | 3205.24 / 11160.00 | 0/0/0;0/0/0 |
| MySQL | 全列批量更新 10,000 条 | 146.27 / 450.54 | 15.62 / 44.27 | 65.54 / 122.69 | 3216.87 / 11197.05 | 0/0/0;0/0/0 |
| MySQL | 选列批量更新 10,000 条 | 135.23 / 327.93 | 2.60 / 18.23 | 16.30 / 73.85 | 495.59 / 7494.01 | 0/0/0;0/0/0 |
| MySQL | 查询 25,000 条 | 35.65 / 33.57 | 23.00 / 19.53 | 83.47 / 77.89 | 3462.54 / 3460.14 | 6/0/0;6/0/0 |
| MySQL | 条件删除 10,000 条 | 35.19 / 31.68 | 0.00 / 0.00 | 1.67 / 2.10 | 6.98 / 11.66 | 0/0/0;0/0/0 |
每个组合由两个独立进程各记录三次,合计六样本,轮内交替 ORM 顺序。耗时与分配取中位数,CPU 时间和周期取平均值;GC 为六个测量窗口的 Gen0/1/2 合计,每个查询窗口执行六次,其余一次。数据准备和逐字段校验均在计时外。短操作 CPU 时间的零读数受 Windows 计时粒度限制;托管分配不代表峰值、存活堆或原生内存。范围与全部原始样本见最终实测报告。
耗时仍落后的项目为 SQL Server 条件删除,以及 MySQL 批量插入、查询和条件删除;MySQL 查询的 CPU 周期与分配也略高。普通 MySQL 实体更新的 CPU 表现仍待确认。短测样本范围存在重叠,以上不代表所有负载下的稳定排名。
SQLite 四 ORM:最终实现
每格为 耗时中位数 ms / 累计托管分配 KiB。该组使用独立的 QuickCrud 宿主,EF Core + BulkExtensions 为发布包 10.0.1,和上面的四库组分别统计。
| 场景 | TORM | SqlSugar | FreeSql | EF Core + BulkExtensions |
|---|---|---|---|---|
| 查询 25,000 条 | 36.31 / 3275.25 | 115.38 / 11307.71 | 57.15 / 7189.05 | 43.15 / 4519.15 |
| 批量插入 10,000 条 | 27.13 / 3211.49 | 89.35 / 33513.20 | 91.69 / 31344.51 | 39.03 / 14663.21 |
| 批量更新 50,000 条 | 162.22 / 16024.30 | 474.11 / 165001.35 | 895.51 / 343079.88 | 215.18 / 73102.20 |
| 条件删除 10,000 条 | 5.90 / 3.97 | 5.64 / 16.50 | 6.64 / 9.41 | 6.01 / 8.56 |
四 ORM 的 CPU、GC 和耗时范围见基准项目 README。FreeSql 使用 System.Data.SQLite,其余三个 ORM 使用 Microsoft.Data.Sqlite,结果包含驱动和原生引擎差异。
项目结构
TORM/
|-- analyzer/TORM.Generators/ 源生成器
|-- src/TORM/ ORM 核心
|-- src/TORM.Sqlite/ SQLite 驱动
|-- src/TORM.MySql/ MySQL/MariaDB 驱动
|-- src/TORM.SqlServer/ SQL Server 驱动
|-- src/TORM.PostgreSql/ PostgreSQL 驱动
|-- src/TORM.QuestDb/ QuestDB REST SQL、schema 与 CSV writer
|-- src/TORM.IoTDB/ Apache IoTDB Native API Tree/Table 双模型扩展
|-- src/TORM.TaosData/ TDengine Native/WebSocket 原生客户端
|-- samples/TORM.AotDemo/ AOT 示例
|-- benchmark/TORM.Benchmark/ BenchmarkDotNet 基准项目
`-- test/TORM.Test/ 自动化测试
构建与测试
dotnet restore TORM.slnx
dotnet build TORM.slnx -c Release
dotnet test test/TORM.Test/TORM.Test.csproj -c Release
真实数据库集成测试使用 SQLite 加六个 Docker 服务:MySQL、PostgreSQL、SQL Server、QuestDB、TDengine 和 Apache IoTDB 2.0.8。固定镜像、端口、账号和连接串保存在 test/TORM.Test/docker-compose.yml 与 test/TORM.Test/docker-test.env。
docker compose -f test/TORM.Test/docker-compose.yml up -d
docker compose -f test/TORM.Test/docker-compose.yml ps
dotnet test test/TORM.Test/TORM.Test.csproj --configuration Release
完整连接变量和 Windows Docker Desktop 注意事项见 数据库集成测试说明,当前生产变更与测试名称的逐项映射见 测试覆盖矩阵。
2026-08-30 的完整 Release 实测结果为 3808/3808 通过、0 失败、0 跳过;测试覆盖四种关系型 provider 的真实 CRUD/事务/分表/索引/BulkCopy,以及 QuestDB、TDengine、IoTDB 的真实原生协议闭环。
运行基准测试:
dotnet run -c Release -f net10.0 --project benchmark/TORM.Benchmark/TORM.Benchmark.csproj -- --smoke
dotnet run -c Release -f net10.0 --project benchmark/TORM.Benchmark/TORM.Benchmark.csproj -- --filter '*'
基础配置
using TORM;
// 创建 ORM 客户端
using var ormClient = new OrmClient(new OrmConnectionConfig
{
DatabaseType = OrmDbType.MySql,
ConnectionString = "Server=localhost;Database=test;Uid=root;Pwd=password;"
});
定义实体
[OrmTable(TableName = "users")]
public class User
{
[OrmColumn(IsPrimaryKey = true, IsIdentity = true)]
public long Id { get; set; }
[OrmColumn(ColumnName = "user_name", Length = 50)]
public string Name { get; set; }
public int Age { get; set; }
public DateTime CreateTime { get; set; }
}
Code First 自动建表
// 自动创建表结构
await ormClient.CodeFirst.InitTableAsync<User>();
📚 功能详解
查询操作
// 基础查询
var list = await ormClient.Queryable<User>().ToListAsync();
// 条件查询
var adults = await ormClient.Queryable<User>()
.Where(u => u.Age >= 18)
.ToListAsync();
// 分页查询(返回 PagedList<T>,包含总数)
var page = await ormClient.Queryable<User>()
.Where(u => u.IsActive)
.OrderByDescending(u => u.CreateTime)
.ToPageListAsync(pageNumber: 1, pageSize: 20);
// 聚合查询
var count = await ormClient.Queryable<User>().CountAsync();
var exists = await ormClient.Queryable<User>().AnyAsync();
// 投影查询
var names = await ormClient.Queryable<User>()
.Select(u => new { u.Id, u.Name })
.ToListAsync();
// 流式查询(大数据量场景)
await foreach (var user in ormClient.Queryable<User>().ToAsyncEnumerable())
{
// 逐行处理
}
批量操作
// 批量插入(高性能)
await ormClient.InsertableRange(users).ExecuteAsync();
// BulkCopy 批量导入(最高性能)
await ormClient.BulkCopy<User>().BulkInsertAsync(users);
// 批量更新
await ormClient.BulkCopy<User>().BulkUpdateAsync(users);
// 批量保存(自动判断插入/更新)
await ormClient.BulkCopy<User>().BulkMergeAsync(users);
分表操作
定义分表实体:
/// <summary>按月保存日志,物理表名后缀为 _yyyyMM。</summary>
[OrmTable(TableName = "logs", SplitType = SplitTableType.Month, SplitColumn = nameof(CreateTime))]
public class Log
{
/// <summary>每张物理表独立生成主键。</summary>
[OrmColumn(IsPrimaryKey = true, IsIdentity = true)]
public long Id { get; set; }
/// <summary>日志内容。</summary>
[OrmColumn(IsNullable = NullableState.Nullable)]
public string? Message { get; set; }
/// <summary>用于决定月份,分表依据列必须为 DateTime。</summary>
[OrmColumn(IsNullable = NullableState.Nullable)]
public DateTime CreateTime { get; set; }
}
/// <summary>按记录数保存采样,每个物理桶最多分配 10000 条插入记录。</summary>
[OrmTable(TableName = "sensor_data", MaxRowCount = 10000)]
public class SensorData
{
/// <summary>每张物理表独立生成主键。</summary>
[OrmColumn(IsPrimaryKey = true, IsIdentity = true)]
public long Id { get; set; }
/// <summary>本次采样值。</summary>
[OrmColumn(IsNullable = NullableState.Nullable)]
public double Value { get; set; }
}
/// <summary>按月和记录数保存事件,物理表形如 events_202401_1。</summary>
[OrmTable(TableName = "events",
SplitType = SplitTableType.Month,
SplitColumn = nameof(EventTime),
MaxRowCount = 50000)]
public class Event
{
/// <summary>每张物理表独立生成主键。</summary>
[OrmColumn(IsPrimaryKey = true, IsIdentity = true)]
public long Id { get; set; }
/// <summary>决定事件所属的月份。</summary>
[OrmColumn(IsNullable = NullableState.Nullable)]
public DateTime EventTime { get; set; }
}
分表操作示例:
通过 .Split(startTime, endTime) 查询已有物理表,省略范围则查询全部分表;范围用于筛选分表,精确到行的时间条件仍需用 Where 指定。
var startTime = DateTime.Now.AddDays(-30);
var endTime = DateTime.Now;
var list = await ormClient.Queryable<Log>()
.Split(startTime, endTime)
.Where(log => log.CreateTime >= startTime && log.CreateTime <= endTime)
.ToListAsync();
实体增删改使用 .SplitTable(),更新时间分表时实体应携带原来的分表时间。行数分表按主键定位首张匹配物理表。返回单个自增标识的分表插入只接受一条实体。
await ormClient.InsertableRange(logs).SplitTable().ExecuteAsync();
await ormClient.UpdatableRange(logs).SplitTable().ExecuteAsync();
await ormClient.DeletableRange(logs).SplitTable().ExecuteAsync();
await ormClient.BulkCopy<Log>().SplitTable().BulkInsertAsync(logs);
await ormClient.BulkCopy<Log>().SplitTable().BulkUpdateAsync(logs);
await ormClient.BulkCopy<Log>().SplitTable().BulkMergeAsync(logs);
await ormClient.Savable(logs).SplitTable().ExecuteAsync();
Savable(...).SplitTable() 按实际条件键定位已有记录,更新首张匹配表,并将新增记录交给相同的容量租约。行数实体路由按物理表名的 Ordinal 升序选择首个匹配桶,查询和分页目录按表名倒序读取。修改分表时间应显式调用 MoveSplitTableAsync(original, replacement),传入原、新快照;完整主键必须相同且不能是自增键,删除与插入在同一事务内完成。条件更新通过 SetColumns 改分表时间会提前拒绝。
Where(log => log.CreateTime >= startTime && log.CreateTime < endTime) 中直接作用于时间分表列的合取比较可自动裁剪物理表,原始 WHERE 始终保留。OR、NOT、布尔比较包装、方法调用等复杂条件不推断范围,严格边界仍由数据库筛选行。
跨表 SQL 预览使用异步 ToSqlAsync(),实体、投影和聚合均返回基于实际目录的等价数据 SQL 与参数;同步 ToSql() 对跨表查询报错。预览不代表分页计数定位等全部执行命令。
var query = ormClient.Queryable<Log>().Split()
.Where(log => log.CreateTime >= startTime);
var preview = await query.ToSqlAsync();
var firstPage = await query.ToCursorPageAsync(100);
var secondPage = firstPage.HasMore
? await query.ToCursorPageAsync(100, firstPage.NextCursor)
: null;
游标分页不查询总数,按物理表名倒序、表内完整主键升序返回,每页仅多读取一行判断 HasMore。只支持完整实体、完整非空主键及参数化查询,不能混用自定义排序、投影、Distinct 或 Skip/Take。令牌属于相同逻辑表、连接配置和筛选参数;并发修改时不提供跨页快照。需要总数、页码或自定义排序时使用 ToPageListAsync()。
自动写入首次同步当前实体的物理表结构,后续热写入复用成功状态。需要主动同步列和索引时,显式调用 CodeFirst.InitTableAsync(physicalTableName, EntityInfo.GetEntityInfo<Log>());同步只撤销该表的结构缓存,保留已发放的容量租约。物理表索引名由逻辑索引名和物理表名生成,各表独立维护唯一约束。实体查询的无排序 FirstAsync() 和从起点开始的有界 Take() 直接读取所需物理表,不预先统计全部历史表;需要总数的页码查询仍执行真实计数。
空分表目录的实体、投影及聚合查询均使用空集语义,SumAsync() 等可空标量返回 null;异步 SQL 预览也能直接执行。BulkUpdateAsync() 没有匹配记录时返回 0,不开启空数据事务;新增记录分类只用于合并。维护索引时,DropIndexAsync(tableName, indexName) 核对索引的物理表归属,避免误删邻表索引;SQLite 也隔离主库与同名临时索引。
默认每次查询真实分表目录,便于看见其它连接新建的表。表结构完全由当前进程管理时,可在创建客户端时设置 ConnectionConfig.CacheSplitTableCatalog = true,减少目录查询。经 TORM 维护 API 执行的 DDL 自动失效;外部 DDL、原始 SQL 或绕过分表路由的插入后,应在写入停止时调用 ormClient.RefreshSplitTableMetadata() 刷新目录、初始化及容量状态。
默认内置行数策略在同进程、相同完整连接配置的活动客户端之间共享容量预留,客户端副本也复用状态。SQLite 按驱动规则统一 Data Source、DataSource 和 Filename 等标准别名,保留日志与同步选项,其它配置相同的文件客户端共享容量。需要跨进程容量约束时,全部写入者启用 ConnectionConfig.CoordinateSplitTableWrites = true 并通过分表路由写入:MySQL 使用会话命名锁,PostgreSQL 使用会话建议锁,SQL Server 使用会话应用锁,SQLite 文件库使用数据库旁的稳定独占锁文件。协调锁覆盖表准备、数据事务和调用方外部事务完成,锁内重新读取目录及当前容量;该模式增加协调和实时统计成本,默认关闭。SQLite 锁文件在释放句柄后保留,存在文件不表示仍被锁定,不应在其它进程运行时删除。
服务器协调模式的外部事务必须使用 ReadCommitted;MySQL 在开始外部事务前还须预建物理表和索引。SQLite 外部事务若不能立即取得协调文件锁会明确失败,调用方须回滚后重试整个事务,避免其已持有的数据库锁与另一写入者形成反向等待;无外部事务的普通写入仍可取消等待。锁取得被取消、解锁失败或事务结果未知时,由各实现库淘汰物理会话,避免携锁连接返回池。正常锁等待超时不会释放其它会话的锁。该约束只覆盖全部遵守相同策略的 ORM 写入者,不涵盖旁路 SQL、不同容量配置及外部并发 DDL;SQLite 内存库不提供跨进程共享。
自定义 IRowCountSplitTableService 必须实现 ReserveTablesAsync,一次返回完整批次的 IRowCountTableReservation。每段须有非空表名、正条数和独立租约,条数之和等于请求数;分配失败由服务回收已发额度。执行器在写入前调用 Enlist(ado),成功后以真实条数调用 Complete(affected, ado),最后调用可重复的 ReleasePending()。已开始写入的额度归事务收尾,已知回滚归还,未知结果保守保留。自定义服务自行保证并发和容量策略;ORM 不再为其逐块追加 COUNT。显式 NotifyInserted(tableName, count, ado) 仍须按数据库归属处理,不能对同一租约重复通知。
采用内置数字桶名称规则的自定义服务可声明 UsesNumericTableSuffix = true,直接从一次真实目录中筛选时间与行数混合表;公共流程依据命名契约执行,不判断服务实现类型。其它命名保留默认值 false,由服务提供物理表列表。分表修改的可空 WhereColumns 将两个空值视为同一条件键,普通更新、Savable 与原生 Bulk 使用一致的比较规则;非空主键保留直接等号比较。
PostgreSQL 目录及维护操作使用连接的 current_schema(),SQL Server 使用登录用户的默认 schema。不同 schema 使用不同连接配置;不在活动客户端上切换搜索路径或默认 schema。逻辑表名按实现库的保守规则严格匹配,SQLite 忽略大小写,其余实现精确匹配;应始终使用物理名称的实际大小写。
一次分表增删改或 Bulk 调用的各物理表数据写入共用事务。已有外部事务时由调用方提交或回滚,调用失败后应回滚该事务;提交结果未知时保守保留容量。MySQL 外部事务开始前应预建所需表、列及索引,自动准备发现结构缺失会明确报错,避免 DDL 隐式提交。自动建表在自有数据事务之前执行,失败时已建的空表可能保留。MySQL 原生 Bulk 的重复键、截断等警告通过 MySqlBulkLoadException 抛出。
分表类型说明:
| SplitTableType | 说明 | 表名后缀格式 |
|---|---|---|
| None | 不分表(默认) | - |
| Day | 按日分表 | _yyyyMMdd |
| Week | 按周分表 | _yyyyMMdd(周一日期) |
| Month | 按月分表 | _yyyyMM |
| Quarter | 按季度分表 | _yyyyQn |
| Year | 按年分表 | _yyyy |
事务管理
await ormClient.UseTranAsync(async () =>
{
await ormClient.InsertableRange(addModels).ExecuteAsync().ConfigureAwait(false);
}).ConfigureAwait(false);
AOP 日志拦截
// SQL执行前日志
ormClient.Aop.OnLogExecuting = (sql, parameters) =>
{
Console.WriteLine($"执行SQL: {sql}");
};
// SQL执行后日志
ormClient.Aop.OnLogExecuted = (sql, parameters, elapsed) =>
{
Console.WriteLine($"SQL执行耗时: {elapsed.TotalMilliseconds}ms");
};
// 插入/更新前修改值
ormClient.Aop.OnDataExecuting = (args) =>
{
if (args.DataExecutingType == DataExecutingType.Insert)
{
// 自动填充创建时间
if (args.Entity is BaseEntity entity)
{
entity.CreateTime = DateTime.Now;
}
}
};
Release 构建会生成 NuGet 包并输出到上级 nupkgs 目录。
相关资源
- Docker 集成测试:test/TORM.Test/README.docker-tests.md
- 当前变更测试矩阵:test/TORM.Test/TEST_COVERAGE_MATRIX.md
- 官方文档:https://runtime.thingsgateway.cn/
- Gitee:https://gitee.com/ThingsGateway/TORM
- GitHub:https://github.com/kimdiego2098/ThingsGateway
- QQ 群:605534569
许可证
本项目使用 Apache-2.0 协议。
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. net11.0 is compatible. |
-
net10.0
- Microsoft.Data.SqlClient (>= 7.1.2)
- System.Formats.Asn1 (>= 11.0.0)
- System.Security.Cryptography.Pkcs (>= 11.0.0)
- TORM (>= 2.0.98)
-
net11.0
- Microsoft.Data.SqlClient (>= 7.1.2)
- System.Security.Cryptography.Pkcs (>= 11.0.0)
- TORM (>= 2.0.98)
NuGet packages (2)
Showing the top 2 NuGet packages that depend on TORM.SqlServer:
| Package | Downloads |
|---|---|
|
ThingsGatewayRuntime.Admin
Package Description |
|
|
TAdmin
Package Description |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 2.0.98 | 0 | 11/22/2026 |
| 2.0.97 | 216 | 11/13/2026 |
| 2.0.96 | 158 | 11/10/2026 |
| 2.0.95 | 154 | 11/9/2026 |
| 2.0.94 | 150 | 11/8/2026 |
| 2.0.93 | 210 | 11/8/2026 |
| 2.0.92 | 336 | 11/5/2026 |
| 2.0.91 | 284 | 11/2/2026 |
| 2.0.90 | 160 | 11/1/2026 |
| 2.0.87 | 156 | 10/28/2026 |
| 2.0.86 | 164 | 10/26/2026 |
| 2.0.85 | 166 | 10/26/2026 |
| 2.0.83 | 159 | 10/23/2026 |
| 2.0.82 | 340 | 10/19/2026 |
| 2.0.81 | 150 | 10/14/2026 |
| 2.0.80 | 145 | 10/13/2026 |
| 2.0.79 | 138 | 10/12/2026 |
| 2.0.78 | 267 | 10/7/2026 |
| 2.0.77 | 149 | 9/30/2026 |
| 2.0.76 | 157 | 9/29/2026 |