Files
wiki/wsf/bd/decisions.md
2026-08-19 10:12:27 +08:00

3.4 KiB

title, source_status
title source_status
冲突裁决与决策记录(只追加,不改历史条目) 汇编自 knowledge/governance/conflicts-and-open-questions.json 与 docs/sql-agent-design.md 决策记录

冲突裁决与决策记录

本文件只追加。新增决策写在对应表格末尾并带日期;已确认的历史条目不得回改或删除, 后续如果推翻旧决策,新增一条记录说明"取代了哪条",而不是编辑旧条目。

已裁决冲突

主题 数仓开发规范说法 分析师/Agent 规则 裁决
ADS 前缀 ads_ds_ads_bi_ads_iBigdata_ ads_analyze_ + ds/bi/ibigdata 本 Agent 场景用分析师规则
MID 前缀 mid_ mid_analyze_ 本 Agent 场景用分析师规则
计数后缀语义 times=非去重,cnt=去重 cnt=非去重,num=去重 分析师产出统一用分析师标准
分区谓词范围 文档字面写"禁止全表扫描" 用户确认:只有分区表需要分区谓词,非分区表允许全表扫描 用用户确认规则

已确认问题(带日期)

日期 主题 结论
2026-07-21 生产 SQL 自动执行 第一阶段不自动执行,由用户在 WeData 人工运行
2026-07-21 元数据采集范围 按需逐表查询,不做全量 DDL 采集
2026-07-21 数据库范围 只用 wanshifu_dw,排除 wanshifu_enterprise
2026-07-21 ODS 新旧套选择 新旧套同时存在时优先 _v
2026-07-22 周表 stat_date 语义 不设默认值;生成部署脚本前必须询问用户是周起始/周结束/其他业务日期
2026-07-22 MID 依赖 MID 不能依赖另一个 MID
2026-07-22 业务时间分区缺少范围 必须询问用户,不自动查近三年
2026-07-24 元数据访问权限 改用受限专用密钥,正式环境只开放所需只读元数据接口;提示词/Skill 层禁止规则不作为权限边界
2026-07-24 表字段就绪校验范围 必须同时检查普通字段和 PARTITIONED BY 分区字段,禁止把已存在的分区字段误报为待接入
2026-07-27 中文 SQL 常量编码故障 两次真实查询证明 JDBC/Kyuubi 链路可能使中文常量失真;诊断和降级规则见 sql-rules.md

待确认问题

  • 分区语义证据优先级的建议顺序(verified_table_level_knowledge > verified_job_code > DDL 分区定义和注释 > 表名推断 > 询问用户)尚待正式确认。
  • 是否每个物理临时表在成功和重跑两种场景下都必须执行 DROP 清理,尚待确认。
  • 公司 Agent 平台的 Skill/Tool/状态存储协议尚未定稿。
  • SQL 开发规范的正式内容(除已提炼部分外)尚未完整获取。
  • 指标口径来源和版本管理方式尚未定稿。
  • 多轮会话状态保存周期尚未定稿。
  • 未来 WeData 只读执行器的权限、审批和资源限制尚未定稿。

原始规范文档指针(未内嵌全文)

文档 版本 生效日期 角色
数据分析师_商业分析师数仓开发规范.md 2.0.0 2026-06-02 分析师主规范
万师傅数仓开发规范.md 1.5.0 2026-06-01 数仓设计学习参考
万师傅数仓现状_订单数据架构.md 订单域参考

相关