数仓 SQL 智能体怎样关联历史版本？用半开时间区间，检查边界只命中一条

数仓 SQL 智能体关联历史资料时，不能永远取最新版本。应按事实发生时间匹配当时有效的区间，并检验切换时刻不会同时命中两个版本。

让AI编写数仓历史维度关联的开发者。本文使用 Python 3.11 或以上版本的标准库，先验证一组人工构造的小样本。AI 负责提出实现或解释差异，结果由本地检查决定；这里没有把模型回答当成真实运行结果。

核对历史版本时间关联前，先定规则

示例采用[start,end)半开区间，开始包含、结束不包含。正好发生在新版本开始时的事实，应归入新版本。

时间用统一YYYY-MM-DD格式只是简化演示。真实数据要统一时区与时间精度，不能混用不可排序的日期文本。

关联后每条事实需要恰好一个维度匹配；零匹配是缺历史，两条匹配是区间重叠，都应输出问题。

给 AI 的输入要包含什么

把下面这份输入说明和你的实际样本一起交给可用的 AI 编程助手。示例只含虚构数据；对真实材料先去除账号凭据和个人信息。

SQLite facts(id,occurred), dim(label,start,end)。用start<=occurred AND occurred<end关联，不取最新版本；两区间在2026-02-01交界。验证当天只命中新版，输出每条事实匹配数。

要求模型保留检查条件，并把它认为缺少的业务定义列出来。若回答改变了输入字段、忽略异常分支或直接删除原材料，先要求修正，再运行。提示词的作用是缩小任务范围，验收仍以代码和数据为准。

保存并运行最小验证程序

下方程序把关键规则和验证用例放在同一个可复跑示例中，便于先理解输入如何变成输出，再用它检查 AI 给出的实现。

新建一个空目录，把下面代码保存为 check.py，在该目录打开终端，运行 python -X utf8 check.py。代码自带示例输入，不需要安装第三方库。

import sqlite3
db=sqlite3.connect(':memory:')
db.execute('create table facts(id text, occurred text)')
db.execute('create table dim(label text, start text, end text)')
db.executemany('insert into dim values(?,?,?)',[('old','2026-01-01','2026-02-01'),('new','2026-02-01','2026-03-01')])
db.executemany('insert into facts values(?,?)',[('a','2026-01-31'),('b','2026-02-01')])
rows=db.execute('select f.id,d.label from facts f join dim d on d.start<=f.occurred and f.occurred<d.end order by f.id').fetchall()
assert rows==[('a','old'),('b','new')]
counts=db.execute('select f.id,count(d.label) from facts f left join dim d on d.start<=f.occurred and f.occurred<d.end group by f.id order by f.id').fetchall()
assert counts==[('a',1),('b',1)]
print('matches',rows)
print('match_counts',counts)

怎样判断结果符合要求

a命中old，b在交界日只命中new，两条匹配数均为1。把 <end 改为 <=end 会让边界事实重复匹配。

下方是这份最小示例在本地执行得到的输出。它验证示例程序与断言的关系，不代表任何 AI 模型一次就能生成同样代码，也不构成性能或生产可靠性结论。

matches [('a', 'old'), ('b', 'new')]
match_counts [('a', 1), ('b', 1)]

边界规则需由业务确认；若结束时间包含，应设计不重叠的表示方法，不能随意沿用本文。

历史维度应还有实体键，本文单个虚构实体省略该列，真实多实体连接必须加键。

哪些失败必须停下来处理

维度区间重叠、空洞与开放结束值都要单独验证。本例用明确结束日期，不处理NULL无限未来。

时间精度或时区混用可能让比较错位，先校验输入格式。

接入自己的任务前再核对一次

让AI给出查询时同时提供匹配计数审计SQL，发现0或大于1时停止汇总。

历史口径变化保留版本与边界规则，不把旧记录自动重算成当前口径。

资料与适用范围

SQLite支持连接与比较条件；示例时间字符串比较要求统一可排序格式。以下链接核对于 2026-10-03；运行环境及额外依赖按本文前述说明。

• https://docs.python.org/3.11/library/sqlite3.html
• SQLite 官方语法说明

相关基础可阅读 智能体数据怎么增量同步？用 SQLite 核对版本、重跑与回滚。本文的重点是核对历史版本时间关联，可以把两项检查作为不同步骤保留。