生效时间与失效时间(start_date / end_date)

基本说明

生效时间与失效时间是一对概念,用来描述一条记录从什么时候开始有效,到什么时候结束有效:

  • 生效时间(start_date):从这一时刻开始有效。
  • 失效时间(end_date):从这一时刻起不再有效;为空时表示该状态还在持续,尚未结束。
业务场景生效时间失效时间
员工在职情况入职时间离职时间
门店营业情况开店时间闭店时间
会员等级变化当前等级开始生效的时间当前等级失效的时间

这两种类型仅适用于实体表,需要配合使用。例如,要查询「2025 年底有多少名在职员工」,系统需要同时检查员工是否已经入职,以及当时是否已经离职。

数据要求

映射后应能得到明确的生效与失效时刻,两者使用一致的时间精度。原始数据的类型或格式不同,可以通过数据映射转换;只有日期时,应明确对应的时刻,例如 2025-01-01 00:00:00。

该状态还在持续、尚未结束时,映射后的失效时间应为空(NULL)。原始数据如果用空字符串或其他值表示尚未结束,可以在映射中统一为空值。

有效区间采用左闭右开规则 [start_date, end_date)。查询时间点为 T 时,有效记录必须满足:

start_date <= T
AND (end_date > T OR end_date IS NULL)

这意味着生效时刻包含在有效区间内,失效时刻不包含。例如,失效时间为 2026-01-01 00:00:00 的记录,在这个时刻已经失效。

同一 ID 的有效区间不能重叠;状态连续切换时,可让上一行的失效时间等于下一行的生效时间。离职后再次入职等场景可以保留区间空档,空档期间该实体不算有效。

配置与问答

配置一个 ID、一个生效时间和一个失效时间属性,共同构成有效时间实体。系统会根据这三个属性自动识别有效时间规则。配置示例如下:

{
  id: 'membership',
  type: 'entity',
  properties: [
    { id: 'member_id', name: '会员ID', type: 'ID' },
    { id: 'valid_from', name: '生效时间', type: 'start_date' },
    { id: 'valid_to', name: '失效时间', type: 'end_date' },
    { id: 'level', name: '会员级别', type: 'category' },
  ],
}

系统会为该实体提供名为「日期」的查询时间轴,可表达「截至去年年底的员工数量」「2025 年底各会员级别的人数」等时间口径。

「截至 2025 年底的门店数量」是在查那一刻仍在营业的门店数量,与「2025 年关闭了多少家门店」的统计口径不同。

未指定时间条件时,默认查询当前有效的版本;按年度分组时,按每年期末选择有效版本并在一条 SQL 中完成统计。

订单关联会员时,还可以根据订单发生的时间选择当时有效的会员等级。完整的配置、查询和周期展开范围见实体属性随时间变化场景解决方案。

使用示例

同一实体的属性版本

会员ID生效时间失效时间会员级别
M0012025-01-01 00:00:002026-01-01 00:00:00银牌
M0012026-01-01 00:00:00NULL金牌

这两行是同一个会员的历史版本。查询 2025 年底的状态时为银牌,查询 2026 年 1 月 1 日零点的状态时为金牌。这类首尾相接的状态版本通常称为拉链表或 SCD Type 2。

多段生命周期

员工ID生效时间失效时间
E0012020-03-01 00:00:002022-06-01 00:00:00
E0012024-02-01 00:00:00NULL

这里表示离职后再次入职。两个区间之间的空档期内,该员工不应统计为在职。

常见问题

员工「6 月 1 日离职」应该怎样存?

先明确业务含义。如果从 6 月 1 日零点起不再在职,失效时间存 2025-06-01 00:00:00;如果 6 月 1 日整天仍算在职,应把失效时间设为次日零点。日期标签与实际失效时刻需要保持一致。

失效时间为空,表示这条记录始终有效吗?

失效时间为空,表示该状态还在持续,尚未结束。查询某个时刻的状态时,还需检查当时是否已经生效。未来才开始生效的记录,不会因为失效时间为空就提前生效。

可以把失效时间设置得比生效时间早吗?

不应这样配置。有效记录需要有合理的时间区间;同时检查同一 ID 的区间是否重叠,避免历史查询重复匹配。

ID 在物理表中可以重复吗?

在有效时间模型中可以。同一 ID 的每一行表示一个有效区间,既可以是状态版本,也可以是一段生命周期。每个 ID 只有一行时,则是最简单的一段式生命周期。

与普通日期时间、快照时间有什么区别?

普通日期时间只是时间属性;生效时间与失效时间一起决定实体在某个时刻是否有效。时间戳在快照中表示离散的观测时间,两种模型的业务含义不同。