Skip to content

数据库版本检测 - #44

Merged
MarvelTiter merged 11 commits into
masterfrom
数据库版本检测
Sep 18, 2026

Hidden character warning

The head ref may contain hidden characters: "\u6570\u636e\u5e93\u7248\u672c\u68c0\u6d4b"
Merged

MarvelTiter merged 11 commits into
masterfrom
数据库版本检测

Conversation

@MarvelTiter

Copy link
Copy Markdown
Owner

数据库版本探测与方言能力档案(附 SQLite / 达梦反向读表)

分支 数据库版本检测 → master · 11 commits · 80 个文件(含 8 个新增)· +2360 / −1302

一、背景与动机

方言版本差异此前靠手写枚举表达:SqlServer 用 SqlServerVersion.V1/Over2012/Over2017(影响分页 OFFSET-FETCH、TRIM()、STRING_AGG),MySQL 用 MySqlTableOptions.Version(影响 ROLLUP()/CUBE/GROUPING SETS),Oracle 用 OracleTableOptions.OverVersion(影响自增列 IDENTITY vs 序列+触发器)。

三个问题:

  1. 调用方必须猜版本——SqlServerProvider.Create(SqlServerVersion.V1, ...) 写错就静默生成出错的 SQL。
  2. 版本在构造期烘焙,且 ExpressionSqlOptions.SetDatabase 按 DbBaseType.Name 去重、是静态全局——同进程内两个不同版本的同类 provider 会互相串味。
  3. 能力位判据不统一:有的是"两套写法",有的只有一种写法(如 JSON_VALUE、STRING_AGG),后者硬判版本只会多一条走不到的失败分支。

本次改为构造期后台探测真实服务端版本 → 翻译成能力位,并补齐 SQLite / 达梦的反向读表结构。

二、核心设计

2.1 探测机制(src/LightORM/Implements/DbVersionProbe.cs)

  • 构造期后台单飞:Lazy<Task> + ConcurrentDictionary,每个方言每次运行只探一次。
  • 永不抛错、失败自愈:探测失败不污染调用方,落入"未探测"分支,后续可重试。
  • 连接串超时改写下沉到方言:Func<string,int,string?>? prepareConnectString,各驱动用自己的 builder(NpgsqlConnectionStringBuilder.Timeout、DmConnectionStringBuilder.ConnectionTimeout 等);SQLite 不需要改写,传 null + OpenBeforeRead = false。
  • Source 三态:Explicit > Probed > Assumed,便于诊断能力位是猜的还是测的。

2.2 能力档案骨架(src/LightORM/Implements/DbCapabilities.cs)

DbCapabilities<TDatabase, TDatabaseFeatures>
    where TDatabase : DbCapabilities<TDatabase, TDatabaseFeatures>, new()
{
    protected abstract string ProbeTarget { get; }                                    // 探测单飞键
    protected virtual string? PrepareProbeConnectString(string cs, int seconds) => null;
    protected virtual bool OpenBeforeRead => true;
    public abstract TDatabaseFeatures MapFeatures(Version? version);                  // 方言只实现这两样
}

- DbVersionProbe:构造期后台单飞探测,永不抛错、失败自愈;连接串超时改写下沉到方言委托
- DbServerVersion:原始版本串 + 解析结果 + 来源(Explicit/Probed/Assumed)
- DbCapabilities<TDatabase,TDatabaseFeatures>:能力档案骨架,提供 Baseline/ForVersion/Start 静态工厂
- TableOptions 新增 SpecificVersion / DetectVersion(显式指定或关闭探测即不建连)
- 补 required members 的 net462 polyfill
- 新增 SqlServerCapabilities:手写 SqlServerVersion 枚举换成探测得到的能力位
  (OffsetFetch 2012+ / TrimFunction 2017+),只登记存在两套写法的能力
- SqlServerProvider.Create 去掉 version 参数,版本改由构造期探测或 SpecificVersion 指定
- UseSqlServer 去掉 version 重载;需显式版本或关闭探测时改用 Action 重载
- 同步适配测试用例与 DatabaseUtils 两个调用点
- 新增 MySqlCapabilities:MySqlTableOptions.Version 换成探测得到的能力位
  (GroupByRollup 8.0+,旧版本只有 WITH ROLLUP)
- MySqlProvider / CustomMySqlAdapter 改为从能力位取分支
- MySqlTableOptions 移除手写 Version 属性
- 新增 OracleCapabilities:手写 OverVersion 布尔换成能力位
  (IdentityColumn 12.1+ / JsonNativeType 21c+)
- 修正 IDENTITY 列 DDL:GENERATED ALWAYS AS IDENTITY 必须紧跟数据类型,
  且身份列隐含 NOT NULL、不能再显式写 NULL(分别对应 ORA-00907 / ORA-30670)
- 非 21c 环境 JSON 列退化 CLOB(JSON_VALUE / JSON_QUERY 对文本列同样有效)
- OracleTableOptions 移除手写 OverVersion;同步适配测试用例
- 新增 SqliteCapabilities:Jsonb 能力位(3.45+),JSONBackend.Binary 在老版本自动退回文本族
- SqliteProvider / SqliteMethodResolver / CustomSqliteAdapter / SqliteTableHandler 改为从能力位取分支
- 实现 SqliteTableHandler 三个反向读表方法:
  · GetTablesSql:sqlite_master,排除 sqlite_ 引擎内部表
  · GetTableStructSql:pragma_table_info 表值函数(可数主键列以判定 rowid 别名身份列)
  · ParseDataType:精确表匹配 + SQLite 官方亲和性顺序兜底
- 测试改用显式 SqliteProvider.Create 构造 ResolveContext(避开静态单例串味)并关闭版本探测
- GetTablesSql:USER_TABLES
- GetTableStructSql:USER_TAB_COLUMNS 为底,LEFT JOIN USER_COL_COMMENTS(注释)、
  USER_CONSTRAINTS/USER_CONS_COLUMNS(主键)、SYSOBJECTS+SYSCOLUMNS:
  · 自增只能取 SYSCOLUMNS.INFO2 的 bit0(USER_TAB_COLUMNS 没有 IDENTITY_COLUMN 列)
  · 长度必须取 SYSCOLUMNS.LENGTH$(DATA_LENGTH 对 NVARCHAR2 给的是字节数)
  · JSON/JSONB 物理存成 BLOB,靠 SYSCOLUMNS.SCALE=16384 判别并改写成 'JSON'
- ParseDataType:定点数按 Length 里的精度分档;裸 NUMBER 给 decimal(浮点语义)
- 删除 test/TestProject1 下的全部项目源码
- LightORM.slnx 摘除对应项目引用
- 注:旧格式 LightORM.sln 仍指向 test\TestProject1\TestProject1.csproj,待后续一并更新
- SqlServer 的版本感知由手写枚举改为能力档案,补充能力位登记口径
  (只登记存在两套写法的能力,单一写法不判版本)
- 补充 DbCapabilities 骨架与 net462 用 CRTP + 空实例传递方言元数据的说明
- 说明为什么只有四个方言接入探测(PG/KES/达梦无版本分支,接入只是白搭一次连库)
- 记录版本探测与能力档案的落地过程、用户对'无能力位方言不做探测'的回退决策
- 记录 SQLite / 达梦反向读表结构的实现要点与方言坑(NVARCHAR2 字节数、JSON 存 BLOB 等)
- 纠正 TFM 记录:netstandard2.0 已移除,现为 net462;net8.0;net10.0
@MarvelTiter
MarvelTiter merged commit 018a3b9 into master Sep 18, 2026
2 checks passed
@MarvelTiter
MarvelTiter deleted the 数据库版本检测 branch September 18, 2026 03:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant