SCHEMA / SA-40

字段对齐矩阵

六份月报要合并,先把表头摆到同一张矩阵里:谁有、谁缺、谁跟谁是同一个意思,一格一格确认。

已有同义缺失
投放 2~10 份表xlsx / csv / txt / tsv 可混合

    读取服务上限…

    字段矩阵尚未对齐
    上传至少 2 份表,点「对齐并生成矩阵」后,这里会显示字段 × 源表的对照格。

    对口径说明与常见误填 把话说清楚,比报个数更有用

    字段并集 union 按字段首次出现顺序排列,intersection 是所有源表都有的字段,diff 逐字段列出缺哪几份表。
    同义判断 表头归一化(大小写 / 空格 / 全角 / 标点)+ 本地别名表规则命中,识别「手机号 / mobile / 电话」这类写法;不调用语义模型。
    类型抽样 只对前 header_row + sample_rows 行做规则化类型推断,同名不同类型的字段会给出 variants 与建议。
    映射表 mapping[canonical] 是该源表的原始表头;null 表示真实缺失,不要替换成空字符串。
    来源口径 xlsx 每个工作表算一个源表,CSV 每个文件算一个源表;only_first_sheet 可只读第一张表。
    常见误填 重复表头会自动重命名为「原名_2」并在 warnings 说明;别名表未命中的字段不会被强行合并,业务方需复核 synonyms。

    这个工具解决什么问题

    六份月报要汇总,第一道坎永远是字段对不上:这份叫「手机号」,那份写 mobile,还有一份多了「备用电话」。本工具输出字段并集 / 差集、同名不同类型、疑似同义字段,并生成可直接给下游合并流程用的映射表 JSON。

    三条对齐原则

    • 先复核 synonyms 再落地:同义判断是规则匹配,不是语义理解。
    • same_name_diff_type 优先处理,否则合并后类型会被悄悄改写。
    • mapping 里 null 是真实缺失,下游取值时要显式判空。

    按这几步用

    1. 上传多份表:支持 xlsx / xlsm / csv / txt / tsv,最多 10 份。
    2. 设置表头:指定 xlsx 表头所在行与抽样行数,CSV 可单独设置是否有表头。
    3. 看差异清单:查看并集、交集、缺表清单与同名不同类型字段。
    4. 复核同义组:逐组看 canonical 与 variants,确认是否真要合并。
    5. 下载映射表:下载 mapping_json 交给下游,或导出字段明细 / 差异 CSV 人工核对。

    小提示

    xlsx 使用流式行迭代器只读前若干行,不会把整张大表读进内存;服务无状态,下载映射表时会重新提交相同文件。

    更新记录

    • v1.0 2026-11-07 工具上线:字段并集与差集、同义分组、类型冲突、映射表 JSON 与三份 CSV。

    常见问题

    「手机号」和「mobile」没被归到一组?

    别名表覆盖常见中英文字段,但不含行业自定义缩写。可先在源表里统一表头,或按导出的字段明细人工建立映射。

    xlsx 有多个工作表会怎么处理?

    默认每张工作表各算一个源表并分别列出字段;勾选「只读第一个工作表」可只取首表。

    同名不同类型是怎么判断的?

    按抽样行做规则化类型推断并比较主类型;样本太少时结论可能不稳,可增大 sample_rows。

    映射表里的 null 能直接当空字符串用吗?

    不能。null 表示该源表确实没有这个字段,下游取值需要判空并决定补默认值还是跳过,否则容易把「缺失」误当成「空值」。

    💬 留言板 0

    全部留言需审核通过后展示
    💬

    还没有留言,来抢沙发吧!

    ✍️ 说点什么
    0 / 500
    图形验证码