[finding] `isMissingSourceError` 仍把 Postgres 的「缺列」措辞 `column "c" of relation "t" does not exist` 判为「缺源」——文档明说不该,今天靠读路径不产生该措辞而无害

[hotlong]

观察(#5717 落地过程中量出的残留,非 #5717 范围)

packages/services/service-analytics/src/analytics-service.ts 的 isMissingSourceError 自己的文档写着:

Deliberately scoped to MISSING SOURCE (table/object/relation) — not column/syntax errors, which stay hard failures so real query bugs still surface.

但 Postgres 的缺列措辞里含有一段完整的缺表措辞:

column "label" of relation "acct" does not exist

relation "acct" does not exist 是它的子串,所以:

• [finding] queryDataset 里还有第二个 message 嗅探器 isMissingSourceError,命中即静默返回空结果 —— dataset-compiler 的一条拒收措辞已经命中它,只因抛点在 try 之外才没出事 #5717 之前的宽判据(includes('relation') && includes('does not exist'))命中;
• [finding] queryDataset 里还有第二个 message 嗅探器 isMissingSourceError,命中即静默返回空结果 —— dataset-compiler 的一条拒收措辞已经命中它,只因抛点在 try 之外才没出事 #5717 收紧后的锚定判据(/relation\s+["']?…["']?\s+does not exist/i)同样命中 —— 收紧的是「任意同时含两词的句子」,不是这一支。

命中的后果与 #5717 描述的一致:missingSourceRelation 会把 acct 当成「缺失的关系」,于是要么降级成空网格(若 acct 就是 dataset 自己的 object),要么报成跨库拓扑错误(若是 join 表)——两者都不是真相,真相是一个列名写错了,正是文档说要让它响亮失败的那一类。

为什么今天无害(observation 类)

analytics 是只读面。Postgres 在 SELECT 里遇到未知列说的是 column "bogus_dim" does not exist(不含 relation,不命中);column … of relation … does not exist 是 INSERT/UPDATE/ALTER 的措辞,dataset 查询路径不产生它。所以这是一条「判据比文档宽」的静默残留,不是今天有人踩得到的缺陷。

量化(#5717 的 13 条仓内真实措辞语料):收紧前后该串均为 HIT,是 13 条里唯一一条「判据与自身文档不一致」的。

可能的方向(不预判,留给 triage)

• 仓内已有先例:packages/rest/src/rest-server.ts:825 先用 /column\s+["'\]([a-z0-9_]+)["'`]\s+of relation\s+\S+\s+does not exist/i` 把缺列摘出来再判缺表(analytics 的 filter 拒收到不了调用方:service 侧多数拒收没有 ADR-0112 信封,REST 面又用 message 正则嗅探,一律答 500 #5352 面),照抄这一手即可。
• 或者顺着 [finding] queryDataset 里还有第二个 message 嗅探器 isMissingSourceError,命中即静默返回空结果 —— dataset-compiler 的一条拒收措辞已经命中它,只因抛点在 try 之外才没出事 #5717 方向 A(驱动侧结构化 code)一并解决 —— 该方向分诊已裁定需要时独立立单,涉 drivers 面。

参考

• packages/services/service-analytics/src/analytics-service.ts(isMissingSourceError / missingSourceRelation)
• [finding] queryDataset 里还有第二个 message 嗅探器 isMissingSourceError,命中即静默返回空结果 —— dataset-compiler 的一条拒收措辞已经命中它,只因抛点在 try 之外才没出事 #5717(第二个 message 嗅探器 —— 本条是它收紧后剩下的残留)、PR 见 [finding] queryDataset 里还有第二个 message 嗅探器 isMissingSourceError,命中即静默返回空结果 —— dataset-compiler 的一条拒收措辞已经命中它,只因抛点在 try 之外才没出事 #5717 的实现分支
• packages/rest/src/rest-server.ts:825(缺列先摘的既有先例)、packages/rest/src/rest.test.ts:2417(该措辞的既有用例)

[claude]

发现分诊轮(#4949 纪律):晋级 pm:queue,摘 finding。域维持 domain:services。

• 过时前提检查(origin/main 9e3709a)—— 逐行实读,前提成立,并对正文的一处措辞做事实修正****:
  • packages/services/service-analytics/src/analytics-service.ts:89–91 的 docblock 逐字仍在:Deliberately scoped to MISSING SOURCE (table/object/relation) — not column/syntax errors, which stay hard failures so real query bugs still surface;
  • :96 的 isMissingSourceError 判据仍是宽串对 msg.includes('relation') && msg.includes('does not exist') —— 即 [finding] queryDataset 里还有第二个 message 嗅探器 isMissingSourceError,命中即静默返回空结果 —— dataset-compiler 的一条拒收措辞已经命中它,只因抛点在 try 之外才没出事 #5717 的收紧并没有落在这个函数上,它落在 :125 的 missingSourceRelation 正则表(/relation\s+["']?([A-Za-z0-9_$.]+)["']?\s+does not exist/i)。正文写作「[finding] queryDataset 里还有第二个 message 嗅探器 isMissingSourceError,命中即静默返回空结果 —— dataset-compiler 的一条拒收措辞已经命中它,只因抛点在 try 之外才没出事 #5717 收紧后同样命中」在结论上正确(两条判据对 column "label" of relation "acct" does not exist 都 HIT),但收紧发生的位置要按这里读:宽判据本身仍在服役,不是「收紧后残留」而是「收紧未覆盖」。这个区别会改变修法落点(要动的是 :96,不只是正则)。
• 为什么晋级:① 判据与自己的文档不一致 —— 这是本仓一贯认真对待的 declared ≠ enforced 形状,而且方向是吞掉文档明说要响亮失败的那一类(列名写错);② 修法有仓内先例可照抄:packages/rest/src/rest-server.ts:825 已经用「先摘缺列、再判缺表」的两步法处理同一族措辞(analytics 的 filter 拒收到不了调用方:service 侧多数拒收没有 ADR-0112 信封,REST 面又用 message 正则嗅探,一律答 500 #5352 面),对应用例在 packages/rest/src/rest.test.ts:2417;③ 成本封顶,零裁决。
• 今天无害的判断本轮核过并同意(故优先级低):analytics 是只读面,Postgres 在 SELECT 下的未知列措辞是 column "x" does not exist(不含 relation,不命中);column … of relation … does not exist 是 INSERT/UPDATE/ALTER 的措辞,dataset 查询路径不产生它。⇒ 入队但不是 p0,排在真实用户可达的单之后。
• 给执行座位的一条前置判断(不是阻塞项):正文列的第二条方向(顺 [finding] queryDataset 里还有第二个 message 嗅探器 isMissingSourceError,命中即静默返回空结果 —— dataset-compiler 的一条拒收措辞已经命中它,只因抛点在 try 之外才没出事 #5717 方向 A,驱动侧结构化 error code)会让本单变得不必要。派发前请先确认那条方向尚未立单/未在飞,若已起则本单并入、⛔ 不要两处各修一半。附带说明:方向 A 落 driver-sql / Postgres 面,不在 driver-memory / driver-mongodb 的投入冻结面内([裁决] driver-memory / driver-mongodb 投入冻结 —— 维护者 2026-08-05 口径（跨单锚点） #5499),故不因冻结受阻。
• 查重:三仓无影子单;[finding] queryDataset 里还有第二个 message 嗅探器 isMissingSourceError,命中即静默返回空结果 —— dataset-compiler 的一条拒收措辞已经命中它,只因抛点在 try 之外才没出事 #5717(来源)、analytics 的 filter 拒收到不了调用方:service 侧多数拒收没有 ADR-0112 信封,REST 面又用 message 正则嗅探,一律答 500 #5352(先例出处)为关联。本轮 31 条 open PR 无在飞 PR 触 analytics-service.ts;同车道本轮另有 finding(service-automation): engine.ts 的 resumeInternal 把驱动错误插进 message —— #5737 修完后,这条 resume 路径上仅剩的一处外来 cause 拼接 #5912 晋级、[finding] filter-normalizer 的 $not allowNull 守卫在 #5298 第二批之后变成冗余的第二层(谓词等价,SQL 多一层括号) #6005 持有,三者文件互不相交。

本评论来自分诊座位 Routine(#5474 试点),不构成认领。

---

Generated by Claude Code