修bug，完善功能
This commit is contained in:
ChuNa7a committed
1 parent
30364b1c4b
commit
6996e19694
125 files changed
+15343
-3746
No files matched your search
+80
-8
@@ -2,7 +2,15 @@
|
||||
|
||||
[← 返回 README](../README.md)
|
||||
|
||||
**本页导航：** [自定义类型 DOMAIN](#自定义类型-domain) · [预定义类型的含义](#预定义类型的含义) · [系统类型目录字段](#系统类型目录字段) · [运行时类型与函数](#运行时类型与函数) · [DOMAIN 约束设计（尚未实现）](#domain-约束设计尚未实现)
|
||||
本页内容：
|
||||
|
||||
- [自定义类型 DOMAIN](#自定义类型-domain)
|
||||
- [预定义类型的含义](#预定义类型的含义)
|
||||
- [系统类型目录字段](#系统类型目录字段)
|
||||
- [运行时类型与函数](#运行时类型与函数)
|
||||
- [DOMAIN 约束与变更](#domain-约束与变更)
|
||||
|
||||
本页帮助你选择列类型、理解类型限制和 DOMAIN 约束。
|
||||
|
||||
ChuSQL 支持基础类型、运行时复合类型和按数据库保存的 DOMAIN。DOMAIN 为基础类型命名，便于多个表列复用同一定义。
|
||||
|
||||
@@ -32,7 +40,17 @@ DOMAIN 按数据库保存，保留名称并复用基础类型的校验与运算
|
||||
| TIMESTAMP | 日期与时间 | `timestamp` | 否 |
|
||||
| BLOB | 二进制数据类型名称 | `blob` | 否 |
|
||||
|
||||
上述名称表达类型分类，不表示已经完整复刻 PostgreSQL 的存储和数值行为。当前整数类型共用整数值表示；浮点类型共用浮点值表示；`CHAR(n)` 检查字符长度，不自动补空格。`DECIMAL(p,s)` 要求 `1 <= p <= 308`、`0 <= s <= p`，使用有限浮点表示并按小数位舍入，恰好半值时取偶数；舍入后的绝对值达到 `10^(p-s)` 即报精度溢出。它不能视为精确十进制存储。
|
||||
### 数值和字符行为
|
||||
|
||||
上述名称表达类型分类，不表示已经完整复刻 PostgreSQL 的存储和数值行为。当前整数类型共用整数值表示；浮点类型共用浮点值表示；`CHAR(n)` 检查字符长度，不自动补空格。
|
||||
|
||||
`DECIMAL(p,s)` 要求 `1 <= p <= 308`、`0 <= s <= p`，使用有限浮点表示并按小数位舍入，恰好半值时取偶数；舍入后的绝对值达到 `10^(p-s)` 即报精度溢出。它不能视为精确十进制存储。
|
||||
|
||||
### 行大小与索引键限制
|
||||
|
||||
声明长度之外还有物理容量限制：整行的 JSON 编码须放入一个存储页（默认 4096 字节，包含页头和槽位开销），尚无长行溢出存储。
|
||||
|
||||
已建立索引的键在默认配置下最多 128 字节；有效上限为 `min(128, floor((page_size - 11) / (order - 1)) - 12)`，密集旧配置可能仍只支持 64 字节。字符串按 UTF-8 字节计数，不按字符数计数。非索引文本不受这项键长限制，仍须满足整行容量。超页行或超长索引键在写 WAL 前拒绝；为已有列创建索引时也会先检查现有值。
|
||||
|
||||
## 系统类型目录字段
|
||||
|
||||
@@ -53,6 +71,8 @@ DOMAIN 按数据库保存，保留名称并复用基础类型的校验与运算
|
||||
|
||||
## 运行时类型与函数
|
||||
|
||||
运行时复合类型包括列表、可选值和元组。以下示例展示声明、构造、读取和更新：
|
||||
|
||||
```sql
|
||||
CREATE TABLE typed_values (
|
||||
id Int,
|
||||
@@ -77,23 +97,75 @@ SELECT not(TRUE), length('你好');
|
||||
| --- | --- |
|
||||
| 标量 | `Int`、`Double`、`Bool`、`String` |
|
||||
| 列表 | `[a]` / `List a`；`LIST<a>(...)` 按完整类型校验，不隐式转换元素类型 |
|
||||
| 可选值 | `Maybe a`；`MAYBE<a>()` 为 Nothing，`MAYBE<a>(value)` 为 Just |
|
||||
| 可选值 | `Maybe a`；`MAYBE<a>()` 表示无值（Nothing），`MAYBE<a>(value)` 表示有值（Just） |
|
||||
| 元组 | `(a, b, ...)`；`TUPLE<a, b>(...)` 校验各字段类型 |
|
||||
| `length` | `String -> Int` |
|
||||
| `not` | `Bool -> Bool` |
|
||||
|
||||
空列表和 Nothing 也有确定类型。SQL 可空列的 `NULL` 与 Maybe 内部的 Nothing 不同，不能互相替代。内建函数名称不区分大小写，NULL 参数传播为 NULL，非空参数仍校验类型。
|
||||
|
||||
> [!NOTE]
|
||||
> 复合类型尚无 SQL Eq / Ord / Hash 能力，不能自动用于比较、排序、分组、极值或索引。Web 可以显示复合值及构造器预览，修改须通过 SQL 控制台。
|
||||
### 比较、排序与分组
|
||||
|
||||
类型能力说明一种类型支持哪些运算。相等比较、排序和哈希分别记为 Eq、Ord 和 Hash；哈希用于 JOIN、GROUP BY 和 DISTINCT 的值分组。内建 Int、Double、Bool、String 提供这些能力，List、Maybe 和 Tuple 根据全部参数类型递归获得能力，DOMAIN 沿用基础类型的能力。
|
||||
|
||||
同一完整类型的复合值可以使用比较运算、IN、ANY / ALL、JOIN、ORDER BY、GROUP BY、DISTINCT 和 MIN / MAX。不同类型身份之间不隐式转换，例如 `[Int]` 与 `[Double]` 不能比较，空列表也遵守这一规则。SUM / AVG 仍只接受数值标量。
|
||||
|
||||
结构比较使用以下规则：
|
||||
|
||||
| 类型 | 升序规则 |
|
||||
| --- | --- |
|
||||
| List | 从首个不同元素比较大小；相同前缀下，较短列表在前 |
|
||||
| Maybe | Nothing 在 Just 前；两个 Just 比较内部值 |
|
||||
| Tuple | 按字段从左到右比较，取首个不同字段的结果 |
|
||||
| SQL NULL | 升序在所有非空值之前；参与 SQL 比较时结果仍为 NULL |
|
||||
|
||||
以下查询都返回 TRUE：
|
||||
|
||||
```sql
|
||||
SELECT LIST<Int>(2) < LIST<Int>(10);
|
||||
SELECT LIST<Int>(2) < LIST<Int>(2, 9);
|
||||
SELECT MAYBE<Int>() = MAYBE<Int>();
|
||||
```
|
||||
|
||||
SQL NULL 与 Maybe 的 Nothing 不同，`MAYBE<Int>() = NULL` 返回 NULL。分组和去重将 SQL NULL 合并为一组，将 Nothing 作为另一个非空值处理。同键排序保留输入行序。
|
||||
|
||||
复合值按结构哈希，类型身份和各字段共同参与。有限浮点数的正负零相等，嵌套在列表、可选值或元组中也得到相同哈希。NaN、无穷大和载荷类型失配在读取或表达式边界明确拒绝。
|
||||
|
||||
复合值的查询能力不包含索引键编码。运行时类型仍不能声明索引、UNIQUE 或 PRIMARY KEY；索引连接遇到复合键时使用原有扫描或哈希路径。Web 可以显示复合值及构造器预览，修改须通过 SQL 控制台。
|
||||
|
||||
### 类型身份与持久化
|
||||
|
||||
内建构造器编号固定为 `Int=1`、`Double=2`、`Bool=3`、`String=4`、`List=5`、`Maybe=6`、`Tuple=7`；函数编号固定为 `length=1`、`not=2`。完整 `TypeId` 与逻辑类型、物理表示分开，schema 和值使用版本化编码。未知版本、类型或载荷不匹配、非有限浮点数明确报错。
|
||||
内建构造器编号固定为 `Int=1`、`Double=2`、`Bool=3`、`String=4`、`List=5`、`Maybe=6`、`Tuple=7`；函数编号固定为 `length=1`、`not=2`。完整类型身份 `TypeId` 与逻辑类型、物理表示分开；表结构（schema）和值使用版本化编码。未知版本、类型或载荷不匹配、非有限浮点数明确报错。
|
||||
|
||||
> [!IMPORTANT]
|
||||
> 旧标量编码可继续读取；包含运行时复合类型的数据不能交给不支持该编码的旧客户端。
|
||||
|
||||
## DOMAIN 约束设计（尚未实现）
|
||||
## DOMAIN 约束与变更
|
||||
|
||||
当前 DOMAIN 只提供类型命名，不支持自身 `CHECK`、`NOT NULL`、`DEFAULT`、`ALTER DOMAIN` 或 `CASCADE`。后续约束绑定依赖统一 [bound IR](architecture.md#bound-ir)、对象依赖管理和原子结构事务；不能仅放开语法而绕过写入校验、旧数据验证及 WAL 恢复。
|
||||
领域约束的继承、默认值和修改规则如下。
|
||||
|
||||
### 检查条件
|
||||
|
||||
DOMAIN 支持字面量 `DEFAULT`、`NOT NULL` 和多条 `CHECK`；语法见 [SQL 语法](syntax.md#自定义类型-domain)。
|
||||
|
||||
`CHECK` 的单值变量 `VALUE` 不分大小写，可使用标量表达式和函数，不能引用表列、聚合或子查询。结果为 TRUE 或 SQL NULL 时通过，为 FALSE 时拒绝；非空由独立的 `NOT NULL` 保证。
|
||||
|
||||
### 继承与默认值
|
||||
|
||||
嵌套领域继承全部 CHECK 和非空限制。列自己的 DEFAULT 优先，其次取最近领域的 DEFAULT，再向基础领域查找；显式 NULL 不触发默认值。列声明的可空属性不能放宽领域的非空限制。
|
||||
|
||||
继承属性在绑定时计算，不固化到表列，因此领域默认值变化会影响后续省略该列的 INSERT；已有行不被重写。建表、加列、改列类型、INSERT 和 UPDATE 都使用这些规则；默认值在声明时也须满足完整领域约束。
|
||||
|
||||
### 修改定义与依赖失效
|
||||
|
||||
`ALTER DOMAIN` 支持 SET / DROP DEFAULT、SET / DROP NOT NULL、ADD [CONSTRAINT 名称] CHECK 和 DROP CONSTRAINT。未命名 CHECK 分配 `domain_check_1` 起的名称，跳过已有名称。变更发布前验证传递依赖领域、列默认值和已有行；失败保留原定义。
|
||||
|
||||
依赖定义的绑定查询与写计划在元数据变化后失效；显式事务提交也会复查修改表及其传递领域依赖，按旧定义暂存的写入不能越过新约束。
|
||||
|
||||
### 持久化与并发边界
|
||||
|
||||
持久存储在库读门内取得同一提交点的完整快照，引擎完成校验后，存储在库写门内复查库身份和提交点，再通过现有 ReplaceSchema WAL 原子发布领域目录。并发写入或库替换导致 `serialization_failure`，调用方可重新执行；不自动重试。
|
||||
|
||||
元数据沿用目录列编码，基础列保存类型、可空性和默认值，具名 CHECK 保存为独立目录列；已有只含基础类型的 DOMAIN 可继续读取。原始管理员存储接口仍不是完整 SQL 类型校验入口。
|
||||
|
||||
当前不支持领域改名、修改基础类型、CASCADE、NOT VALID 或在显式事务中执行领域 DDL；这些能力仍依赖后续结构事务与对象依赖管理。
|
||||
Reference in new issue
Block a user