REGION_TABLE
REGION_TABLE = 'td_sys_region'
地区表名(裸表名,SQL 拼接处走 DbSchema::prefix)
地区恢复命令
职责:从 gzip CSV 存档恢复地区数据(region:dump 产物)。解压 → TRUNCATE → 分批 INSERT → 同步序列 → 清地区统计缓存;与 RegionImport 同事务语义:TRUNCATE 与全部 INSERT 要么同成要么同败。
┌────────────────── 分区导航(按此顺序阅读)──────────────────┐ 分区 1 · 命令签名与说明 $signature / $description 分区 2 · 执行入口 handle 分区 3 · 内部辅助 toInsertRow / tableColumns └────────────────────────────────────────────────────────────┘
toInsertRow(array $line, array<string,int> $colIndex, array $importCols, array $tableColumns) : array
CSV 行 → 插入数组(按存档表头列下标映射定位列,O(1) 取列)。 空值表达按列的 is_nullable:可空列空串转 null;NOT NULL 列(如 postal_code default '')空串保持 '',避免违反非空约束。
| array | $line | |
| array |
$colIndex | 表头列名 → 下标(array_flip 一次生成) |
| array | $importCols | |
| array | $tableColumns |