UT 覆盖补充方案

已有测试

parquet_column_reader_test.cpp

类别	测试	覆盖
标量类型	ReadAllSupportedPhysicalAndLogicalTypes	所有物理/逻辑类型的 flat read
复杂类型	ReadSupportedComplexTypes	struct/list/map 基本 read
Skip/Select	SkipThenRead、SelectReadsOnlySelectedRanges	标量 skip/select
Struct 投影	ReadProjectedStructChildren、ReadProjectedNullableStructChildren	标量子字段投影
List 投影	ReadProjectedListStructElementChildren	list 元素字段投影
Map 投影	ReadProjectedMapStructValueChildren	map<k, struct> value 字段投影
未投影复杂 child	ReadProjectedStructListChildOnly、SkipProjectedStructListChildOnlyThenRead、SelectProjectedStructListChildOnly	struct 中未投影的 list child
未投影 MAP child	ReadProjectedStructMapChildOnly、SkipProjectedStructMapChildOnlyThenRead、SelectProjectedStructMapChildOnly	struct 中未投影的 map child
Overflow	ReadListWithOverflowAcrossChunks、SkipListWithOverflowThenRead、SelectListWithOverflow 等	list<scalar/struct/map>、list、map<scalar/struct> 的溢出
嵌套	ReadListListWithOverflowAcrossChunks、ReadListStructWithOverflowAcrossChunks、ReadStructMapWithOverflowAcrossChunks	多层嵌套的 read/skip/select

parquet_reader_test.cpp

类别	测试
Reader 生命周期	OpenStoresRequestAndCloseClearsState、CloseReleasesSharedIOContext
读	ReadSingleRowGroupThenEof、ReadMultipleRowGroups
过滤	ReadPredicateAndNonPredicateColumnsWithSelection、ColumnPredicateOnlyPrunesAndDoesNotFilterRowsInsideRowGroup、ReadMultiPredicateColumnsBeforeExpressionFilter、PredicateColumnFiltersBeforeNonPredicateRead、NonPredicateColumnKeepsSelectionFromPredicateColumn
Pruning	PredicateFiltersRowGroupsByStatistics、PredicateFiltersRowGroupsByDictionary、PlannerNarrowsRowRangesByPageIndex、InPredicateFiltersRowGroupsByDictionary、StatisticsPruningSkipsPrefixRowGroupsAndReadsLaterGroups
Row position	RowPositionReaderReturnsFileLocalPositions、RowPositionReaderKeepsPositionsAfterSelection、RowPositionReaderUsesFileLocalPositionsForScanRange
Delete	DeletePredicateFiltersRowPositions、QueryPredicateAndDeletePredicateFilterRowPositions
Bloom filter	EqPredicateUsesArrowHashAndPrunesAbsentIntValue、InPredicatePrunesOnlyWhenAllValuesAreAbsent、BooleanPredicateHashesAsParquetInt32、StringPredicateUsesArrowByteArrayHash、NullableAcceptingAndUnsupportedPredicatesKeepRowGroup
Column predicate	ColumnPredicatesDoNotForcePredicateMaterialization
ColumnMapper	CreatesComplexProjectionForStructChildren、CreatesComplexProjectionForMapValueStructChildren

table_reader_test.cpp

类别	测试
聚合下推	PushDownCount/MinMax* 系列（含 struct/list/map 子字段）
Schema 变化	ProjectedColumnsFillDefaultForParquetSchemaMismatch、ProjectedStructFillsMissingChildWithDefault
Filter	OpenReaderBuildsTableFiltersFromConjuncts、OpenReaderPushesMultiColumnConjunctToParquetReader
Delete	IcebergTableReaderAppliesDeletionVectorFile、IcebergTableReaderDoesNotPushDownAggregateWithDeletes 等
Virtual column	IcebergVirtualColumnsUseRowLineageMetadata

需要补充

P0：基本正确性

测试	说明
NullableListElement	LIST 元素 nullable：[null, 1]、[1, null]、empty list、null list 各场景的 read/skip/select
NullableMapValue	MAP value nullable：{k: null}、{k: v}、empty map、null map 各场景的 read/skip/select
ListStructNullableChild	List<Struct<nullable_child>> 的 read/skip/select，验证 null child 的 def level 处理
MapStructNullableChild	Map<K, Struct<nullable_child>> 同上
MapListNullableValue	Map<K, List<nullable V>> 小 batch read + overflow，验证两层 cursor 与 overflow 一致

P1：过滤交互

测试	说明
ConjunctFilterOnStructField	SELECT * FROM t WHERE s.id > 5，验证 struct 子字段 conjunct 过滤正确
ConjunctFilterOnMapValue	SELECT * FROM t WHERE m['k'] > 5，验证 map value 过滤
ComplexColumnSelectPath	非谓词复杂列（struct/list/map）在过滤后通过 select() 读取，验证 SelectionVector → column 的行数一致
ProjectionAndFilterInteraction	SELECT s.b FROM t WHERE s.a > 0（同一 struct 内，a 是谓词列，b 是非谓词投影列），验证列 reader 数量、类型、行数正确
FilterThenNullStruct	filter 后 struct 列为 null 时，子字段不会被错误物化

P2：边界

测试	说明
EmptyStruct	struct 无子字段的 read/skip
AllChildrenProjectedOut	struct 所有子字段都不投影（project_all_children=false，children 为空）时的行为——应返回 error 或 skip
DeepNestedPath	三层以上嵌套（a.b.c.d）的 read/skip/select
SkipLongRepeatedList	跳过跨越多个 page 的 long repeated list，验证 overflow + cursor 状态一致
SelectLongRepeatedList	select 跨越 overflow 边界的 repeated list

P3：P4 完成后

测试	说明
PageLevelSkipByStatistics	构造一个 row group 包含多个 page，其中部分 page 的 min/max 完全落在 filter 范围外。验证 page-level skip 调用次数正确
PageLevelSkipByDictionary	dictionary filter 触发 page skip

现有测试未覆盖的复杂类型组合

以下组合在当前代码中有路径但无测试：

• Map<K, Map<K2, V2>>（nested map）
• Array(Map<K, V>)
• Array(Struct<list_child, map_child>)
• struct 内同时有投影和未投影的 non-scalar child（已覆盖 list-only 和 map-only，未覆盖同时存在）

建议在 P0 中优先覆盖前三项（属于已实现路径的回归保护），第四项在 P2 中补充。