Repository navigation
数据库版本检测 - #44
Merged
Hidden character warning
The head ref may contain hidden characters: "\u6570\u636e\u5e93\u7248\u672c\u68c0\u6d4b"
Merged
数据库版本检测#44
Conversation
- 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
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
数据库版本探测与方言能力档案(附 SQLite / 达梦反向读表)
一、背景与动机
方言版本差异此前靠手写枚举表达:SqlServer 用
SqlServerVersion.V1/Over2012/Over2017(影响分页 OFFSET-FETCH、TRIM()、STRING_AGG),MySQL 用MySqlTableOptions.Version(影响ROLLUP()/CUBE/GROUPING SETS),Oracle 用OracleTableOptions.OverVersion(影响自增列 IDENTITY vs 序列+触发器)。三个问题:
SqlServerProvider.Create(SqlServerVersion.V1, ...)写错就静默生成出错的 SQL。ExpressionSqlOptions.SetDatabase按DbBaseType.Name去重、是静态全局——同进程内两个不同版本的同类 provider 会互相串味。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)