空间 ETL 必须显式管理坐标、模式与质量损失

空间 ETL 从文件、数据库、服务或消息中抽取地理数据，经过模式、坐标和几何转换，再装载到目标系统。任务显示“成功”只代表程序结束，不代表空间语义保持。字段截断、坐标错用和几何修复都可能生成可读取但错误的数据。

可靠流水线把每次转换当作有输入契约、损失说明和质量门禁的数据产品，而不是一串无法追溯的格式命令。

抽取阶段先固定输入快照

源文件应记录路径、大小、摘要和修改时间，数据库抽取需要事务快照或水位标识，API 需要分页、版本和查询条件。没有稳定边界时，同一批次可能读取到前后两个状态。

远程服务的默认页数、排序和坐标参考可能变化。客户端应显式请求并检查响应元数据。遇到限流和超时时，重试要避免重复或漏页。

字符编码、区域小数点和日期格式也属于输入契约。乱码字段不会阻止几何加载，却会破坏连接键和分类。抽取后先做模式概览与异常统计，再进入昂贵转换。

源字段到目标字段的映射包括名称、类型、长度、空值、单位和代码表。把长字符串写入短字段、把大整数转成浮点、把空值变成零，都可能静默改变意义。

多值、嵌套和数组结构进入扁平格式时需要明确展开规则。一个对象拆成多行后，主键和顺序必须可重建。目标格式不支持的属性应报告，而不是无声丢弃。

代码表转换要版本化。行政区代码、地类和状态枚举随时间变化，无法识别的值应进入隔离区。用默认“其他”吞掉未知值会隐藏上游变更。

仅有 EPSG 编号仍可能不足，动态基准、垂直参考和坐标轴顺序会影响转换。源 CRS 不能通过数值范围盲猜；缺失时应阻止自动转换并回到数据提供方确认。

从一个基准到另一个基准可能有多条坐标操作，适用区域、精度和网格文件不同。流水线应记录实际选择的操作与资源版本，而不只记录目标 CRS。

经纬度交换、单位错误和缺少高程会产生巨大偏移。转换后要检查范围、控制点和代表对象。落入目标国家边界不是充分证明，系统性小偏差同样会破坏叠加。

曲线进入只支持线段的格式需要离散化，三维写入二维目标会丢失高程，多面可能被拆成单面。每种降级都要登记容差和损失，不能让使用者误以为数据等价。

几何有效性修复可能移动边界或改变对象数量。流水线应先隔离错误，再按规则修复，并输出修复前后面积、长度和数量差异。无法确定的对象不能自动删除。

简化和精度降低可减小体积，但会影响拓扑。共享边界若分别简化会产生缝隙；小对象可能消失。简化产品应作为派生版本，保留原始精度来源。

更新时间字段只能捕获正确维护的变化，不能发现未更新标记的修订。变更日志或数据库 CDC 更可靠，但仍要处理事务顺序、模式变化和重放。

上游删除可以用墓碑、状态字段或快照差集表达。忽略删除会让目标不断积累失效对象；物理删除又可能破坏审计和下游引用。策略应由业务生命周期决定。

幂等装载使用稳定业务键、源版本和批次标识。任务重试不能重复插入，晚到旧事件也不能覆盖新状态。空间对象若没有稳定 ID，只按几何比较会受坐标和精度变化影响。

小批次可以事务提交，大批量常先写暂存区，完成校验后交换表或版本指针。直接覆盖生产表会让使用者看到半批数据，也使回滚困难。

索引、约束和统计信息影响装载与查询。为提速暂时关闭约束时，必须在发布前重新验证；索引建成不代表查询使用，应检查代表性执行计划。

目标权限与所有权要在部署脚本中定义。临时装载账号不应长期拥有删除全部数据的权限，生产服务也不应能修改暂存原始区。

结构检查包含字段、类型、空值和唯一性；空间检查包含 CRS、范围、几何有效性、对象数量、面积长度分布和拓扑；业务检查确认代码表、时间范围和关键关联。

总行数相等不足以证明成功。一个多面拆成多行后数量变化可能合理，所有经度被截断仍可能保持数量。门禁应根据转换预期设置，并对变化给出解释。

抽样需要覆盖边界、极值、无效输入和不同数据源。固定样区有利于回归，但还应随机抽样发现新问题。质量失败的批次进入隔离，不能因下游等待而自动放行。

每个输出版本应记录输入、工具、参数、代码、运行时间和质量结果。中间产物可按成本与审计需求保留，至少要能重新取得原始输入并复现关键转换。

日志不能只写命令成功。应输出读取、过滤、修复、拒绝和写入数量，以及警告类别。敏感属性在日志和样本中仍需脱敏。

监控区分任务延迟、数据新鲜度和内容异常。任务准时完成却只读到空文件，是数据事故而非成功。与历史分布比较可以发现突变，但阈值要允许真实季节变化。

空间 ETL 的工程质量取决于转换是否可解释、损失是否已知、失败是否被阻止。格式兼容只是入口，坐标、几何、模式和业务语义都通过验证，输出才能成为可信空间资产。

OSGeo GDAL Project：GDAL Documentation，https://gdal.org/en/stable/
Open Geospatial Consortium：Simple Feature Access，https://www.ogc.org/standards/sfa/