remove useless codes: dead struct fields, unused parameters, and unreferenced methods · Pull Request !1734 · KWDB/kwdb

## 概述

清理 `TSTableFileMetadata` 等结构体中的死字段、死方法和无用宏定义。所有删除的代码均经过验证：在整个代码库中仅有写入、无任何读取。

**核心原则：** `TSTableFileMetadata` 是通过 mmap 持久化到磁盘的文件头结构，其 264 字节布局不可改变。被删除的字段替换为 `char padding[N]` 数组，并通过 `sizeof == 264` 和 `offsetof` 断言保证二进制兼容。

---

## TSTableFileMetadata 字段变更明细

### 已删除的字段（替换为 padding）

| 字段 | 原用途 | 删除原因 |
|------|--------|---------|
| `int struct_type` | 标记对象结构类型（`ST_VTREE \| ST_NS_EXT \| ST_COLUMN_TABLE`） | 仅通过 `structType()` 暴露，调用者为 0；对应的 `ST_*` 宏亦已删除 |
| `time_t create_time` | 记录表创建时间 | 仅 `init()` 中 `time(&create_time)` 写入，无任何读取 |
| `off_t meta_data_length` | 元数据段长度（始终等于 `sizeof(TSTableFileMetadata)` = 264） | 仅 `initMetaData()` 和 `addColumnInfo()` 写入，无读取者。`open()` 使用 `bt_file_.fileLen()` 获取文件大小，不依赖此字段 |
| `off_t attribute_offset` | 属性数据起始偏移（始终等于 264，紧接头之后） | 仅 1 处写入（`init()`）、2 处读取（`open()` 和 `setColumnInfo()`）。读取处已替换为常量 `sizeof(TSTableFileMetadata)` |
| `off_t record_size` | 单行记录大小，由 `setAttributeInfo()` 计算返回 | 返回值无读取者；`setAttributeInfo()` 调用的副作用（`offset`/`encoding`）也无生产代码读取 |
| `int encoding` | 表级编码方案，始终传 0 | `create()` 的 `encoding` 参数始终为字面量 0，写入后无读取 |
| `bool is_dropped` | 标记表是否被 drop | 表级 drop 由内存变量 `TsTableSchemaManager::dropped_` 管理，drop 后直接删除文件目录，不需要在文件头中标记 |
| `bool has_data` | 标记是否有有效行 | 无写入，无读取 |
| `size_t num_node` | 总节点数 | 由 `size_()` 暴露，调用者为 0 |
| `off_t length` | 文件数据长度 | 仅 `open()` 中读取（始终为 0，因为无写入者）。删除后用 `bt_file_.fileLen()` 替代，行为等价 |
| `int status` | 状态标记 | 由 `setStatus()`/`status()` 暴露，调用者为 0 |
| `size_t num_leaf_node` | 叶子节点数 | 由 `_reservedSize()` 暴露，调用者为 0 |
| `size_t actul_size` | 实际表大小 | `addMetricForAlter()` 中拷贝，无读取者 |

### 保留的字段

| 字段 | 说明 |
|------|------|
| `magic` | 文件魔数 "MMET"，open 时校验 |
| `schema_version` | schema 版本号，版本管理核心字段 |
| `db_id` | 数据库 ID |
| `partition_interval` | 分区间隔（秒） |
| `cols_num` | 列数 |
| `precision` | 当前时间戳列精度（毫秒/微秒/纳秒） |
| `life_time` | 数据生命周期（秒） |
| `sparse` | 是否为稀疏表 |
| `hash_num` | entity hash 范围 |
| `user_defined` | 保留扩展区域（115→120 字节，吸收了尾部 padding） |

---

## 其他删除

### TsTableObject 移除的方法

| 方法 | 原因 |
|------|------|
| `_reservedSize()` / `size_()` | 零调用者，底层字段已删除 |
| `setStatus()` / `status()` | 零调用者，底层字段已删除 |
| `structType()` / `encoding()` | 零调用者，底层字段已删除 |
| `setNotDropped()` | 零调用者，底层字段已删除 |
| `setColumnInfo()` | 零调用者，底层字段已删除 |

### data_type.h 移除的宏和结构体

| 符号 | 原因 |
|------|------|
| `ST_VTREE/ST_NS/ST_NS_EXT/ST_DATA/ST_COLUMN_TABLE/ST_TRANSIENT` | 随 `struct_type` 字段删除，无其他引用 |
| `isTransient()` | 依赖 `ST_TRANSIENT`，无调用者 |
| `LD_*` 宏系列 + `LD_setLen/setDataLen` | VarBinary/Geometry 长度编码辅助宏，无引用 |
| `InputString` | 无引用 |
| `TimeStamp64LSN` | 无引用 |

### ts_table_object.h 移除的无用 include

`<mutex>` / `<shared_mutex>` / `<pthread.h>` / `"ts_object.h"` / `"sys_utils.h"` — `TsTableObject` 类从未使用这些头文件中的任何符号。

### MMapMetricsTable::create() 移除 `int encoding` 参数

两个调用处（`ts_metrics_table_version_manager.cpp` 和 `ts_table_schema_manager.cpp`）均已同步更新。

---

## 二进制兼容性

```
struct 总大小: 264 字节 (static_assert 保证)
字段偏移量:   offsetof 断言锁定了每个存活字段的位置
on-disk 数据: 旧文件可被新代码正确解析（保留字段的偏移和语义未变）
padding 区域: 旧数据中的值被忽略（原先也只是写入后从未读取）
```

---

## 验证方法

对每个删除的符号执行了全代码库 grep 搜索（排除 `build/` 和 `third_party/`），确认：
- 被删字段/方法/宏在 C++ 和 Go 代码中均无线程读取者
- 所有写入值始终为常量默认值（如 `encoding=0`、`length=0`）
- `setAttributeInfo()` 的副作用（`offset`、`encoding` 填充）在生产路径中无下游消费者

类型	指派人员	状态
审查	zhaochunze e3ric zhaoqinhu MikeFeng David Zhang 已审查通过 liangbo01 William Shi ZhiTong Dou momo ZhangZirui 已审查通过 Albert ZhaoK renyanzheng zhangyg amateur1978 Jerry Z Epoch	已完成 (2/2人)
测试	liuhuanpak 已测试通过张帅已测试通过 Yang Xing 已测试通过 ZhanYuying 已测试通过 ZhangZirui 已测试通过	已完成 (5/1人)

GVPKWDB/kwdb

搜索帮助

GVP KWDB/kwdb