DaZuiZui commented on issue #18846:
URL: https://github.com/apache/iotdb/issues/18846#issuecomment-6141641624

   我先补充一份**修复后的行为定义**,把「正确的列映射语义是什么」写死,后面实现和回归都按这份对齐。
   
   ## 1. 现状与根因
   
   `IoTDBTablePreparedStatement.processQueryResult()` 目前调用的是 
`IoTDBJDBCResultSet` 的**短构造器**(`IoTDBJDBCResultSet:139`),只传到 `zoneId` 
为止,因此三处取值全部落到了构造器内部的默认值:
   
   | 取值 | 服务端实际提供 | 短构造器实际使用 | 后果 |
   | --- | --- | --- | --- |
   | 列映射 | `resp.getColumnIndex2TsBlockColumnIndexList()` | `IntStream.range(0, 
columnNameList.size())`(恒等映射) | 逻辑列与物理列顺序不一致时读到错误列 |
   | 表模型标志 | `resp.isSetTableModel() && resp.isTableModel()` | 硬编码 `false` | 
语义退化为树模型路径 |
   | 字符集 | 连接自身的 `charset` | 未赋值,回落字段默认值 `TSFileConfig.STRING_CHARSET` | 
连接字符集非默认时,字符串解码走错字符集 |
   
   恒等映射隐含了「第 i 个逻辑列 == 第 i 个物理列」这一前提。该前提不成立时:
   
   - 物理列数 ≥ 逻辑列数:静默返回**错误列的值**,不报任何异常;
   - 多个逻辑列共享同一物理列(`SELECT a AS x, a AS y`):按名字取第二列时以逻辑序号去索引物理块,超出块宽度抛 
`ArrayIndexOutOfBoundsException`。
   
   对照实现:普通 `IoTDBStatement`(`IoTDBStatement:540` 起)走的是完整构造器,这三项都正确转发,所以同一个响应在 
`Statement` 与 `PreparedStatement` 上结果不同。
   
   ## 2. 修复后的语义定义
   
   ### 2.1 `columnIndex2TsBlockColumnIndexList`
   
   - 语义:**逻辑结果列序号 → 物理 TsBlock 列序号**的映射,由服务端下发,客户端必须原样采用,不得重建。
   - 非空时 `size()` 即逻辑结果列数,与 `columns` 等长;第 `i` 个元素 `m[i]` 是逻辑列 `i` 对应的物理列序号。
   - 物理块宽度取 `max(m)+1`,客户端据此预分配 `dataTypeForTsBlockColumn`;**允许 `m[i]` 
重复**(多个逻辑列指向同一物理列)。
   - 为空/未下发时,才按既有约定推导:树模型下时间列占位 `-1` 并整体右移一位,其余情况恒等。
   
   ### 2.2 `tableModel`
   
   - 取值来源:`resp.isSetTableModel() && resp.isTableModel()`。
   - 为 `true` 时 `ignoreTimeStamp` 恒为 `true`,结果中不存在树模型的时间列。不得硬编码为 `false`。
   
   ### 2.3 按列序号与按列名的取值
   
   两者必须使用同一份映射,且结果一致:
   
   - `getXxx(int columnIndex)` 与元数据 `getColumnName(i)`、`getColumnType(i)` 
都基于逻辑列序号;
   - `getXxx(String columnName)` 先经 `columnNameIndexMap` 解析到逻辑序号,再经 
`columnIndex2TsBlockColumnIndexList` 落到物理列;
   - 同名逻辑列以**首次出现**为准(现有 `columnName2TsBlockColumnIndexMap` 的 `containsKey` 
判断即此语义)。
   
   ## 3. 类型与索引约束
   
   | 项 | 约束 |
   | --- | --- |
   | `getXxx(int)` 的入参 | 1-based 外部序号;表模型下取值范围 `[1, columns.size()]`,越界或取到空位应报 
`SQLException` |
   | 物理 TsBlock 列类型 | 
`INT32`/`INT64`/`FLOAT`/`DOUBLE`/`BOOLEAN`/`TEXT`/`TIMESTAMP` 等,按 
`dataTypeList` 声明 |
   | 映射取值范围 | `m[i] ∈ [0, 物理列数)`;重复合法 |
   | 重复映射的取值 | 与首次出现的物理列取值完全相同;`dataTypeList` 中同一物理列的类型声明必须自洽 |
   
   ## 4. 期望输出示例
   
   以「逻辑列 0..n-1、物理块列 0..k-1」表示,`physical` 为该物理列的实际值:
   
   | `columns` | `dataTypeList` | 映射 | 物理列值 | 期望 `[逻辑第1列, 逻辑第2列]` | 期望按名字取 |
   | --- | --- | --- | --- | --- | --- |
   | `["b","a"]` | `["INT32","INT32"]` | `[1,0]` | `[10, 20]` | `[20, 10]` | 
`b=20, a=10` |
   | `["x","y"]` | `["INT32","INT32"]` | `[0,0]` | `[10]` | `[10, 10]` | `x=10, 
y=10`(**不得抛 `ArrayIndexOutOfBoundsException`**) |
   | `["a","b"]` | `["INT32","INT32"]` | `[0,1]` | `[10, 20]` | `[10, 20]` | 
恒等情形,作为不回归的对照 |
   
   ## 5. 验收标准
   
   1. 上表三行在 `PreparedStatement` 上取值全部正确,且与同一响应的 `Statement` 路径一致;
   2. 不再出现 `ArrayIndexOutOfBoundsException`;
   3. 每个用例**同时**验证 `getXxx(int)`、`getXxx(String)` 与结果集元数据;
   4. 只断言元数据不算通过——元数据本身就是错的;
   5. 覆盖重排列、重复投影/别名两类,并跑通 table model 相关既有 JDBC 用例。
   
   ## 6. 最小改法
   
   `processQueryResult()` 换用完整构造器(`IoTDBJDBCResultSet:90`),在 `zoneId` 之后补三个实参:
   
   ```java
   charset,                                       // 或 statement 侧持有的连接字符集
   resp.isSetTableModel() && resp.isTableModel(),
   resp.getColumnIndex2TsBlockColumnIndexList()
   ```
   
   即与 `IoTDBStatement:540` 起的调用保持完全一致。不重建映射、不硬编码 `false`,`IoTDBRpcDataSet` 
侧无需改动。
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to