是否必定有值

属性配置中的【是否必定有值】用于说明:这个属性在业务上是否对每条记录都成立。 维度和基础指标都可以配置,对应 Schema Property 的 constraints.required。

这是一项业务事实声明,系统据此决定查询时是否排除不存在该属性或指标的记录。它不用于校验录入是否必填,也不要求修改数据库字段的非空约束。

「是」与「否」的区别

选项业务含义系统如何处理
是声明该属性对每条记录都成立,信任它始终存在不因为这项配置添加空值过滤;即使实际数据出现 NULL,也不会仅因此过滤记录或报错
否该属性只对部分记录成立,NULL 表示这条记录在业务上不存在这个属性或指标直接按该属性分组,或计算符合条件的直接字段指标时,自动排除相应的不存在记录

尚未配置这项信息的已有属性保持原有查询行为,不会自动过滤 NULL。未配置与显式选择「否」不同。

选择依据是 NULL 的业务含义,而不是物理列是否允许为空。如果 NULL 表示“尚未上报”“数值未知”,或本身表达有效的业务状态,不要仅因为数据中有 NULL 就选择「否」。例如结束日期为空可以表示“仍然有效”;将其配置为「否」,会在直接按结束日期分组时排除这些记录。

系统只把 NULL 视为不存在,0、false(布尔值假)和空字符串仍然是有值。选择「是」也不会把 NULL 自动填成 0。

用作分组维度

例如,某些业务记录没有「渠道」这一概念,这些记录的渠道为 NULL。将渠道的【是否必定有值】设为「否」后,直接按渠道分组时,系统只统计渠道有值的记录,不再返回渠道为 NULL 的分组。

同时按多个配置为「否」的属性分组时,要求这些维度都有值。例如按部门和渠道分组,仅保留部门、渠道均非 NULL 的记录。

这个过滤发生在聚合之前,所以按可选维度分组后的汇总之和,可能小于没有该维度过滤的总计。

用作指标

假设一张表保存各部门的两个指标,NULL 明确表示该部门不存在这个指标:

部门指标 A指标 B
一部100NULL
二部NULL200
三部NULLNULL

将指标 A、B 的【是否必定有值】都设为「否」后:

  • 按部门只查 A:返回一部。
  • 按部门只查 B:返回二部。
  • 按部门同时查 A、B:返回一部、二部,各自没有的指标保留 NULL;三部没有任何所查指标,予以排除。

多指标的原则是:至少一个所查指标存在,就保留记录。 系统不会要求 A、B 同时有值,也不会把缺失指标当成 0。

如果本次所查指标中有一个设为「是」,系统信任至少这个指标始终存在,不再添加整段指标存在性过滤。若其中有未配置的指标,也保持原行为,避免仅根据其他可选指标删掉记录。

适用范围与实施建议

  • 默认过滤适用于直接属性分组,以及直接对字段求和、平均值、最小值、最大值、非空计数和去重计数。字段指标不要求查询一定带有分组。
  • 明细展示、表达式分组(例如自定义分段)不触发这套默认过滤。所查指标包含总行数、复杂计算表达式或其他不支持的计算方式时,不根据其余可选指标缩小主查询范围。
  • 指标自带筛选条件时,存在性同时考虑该指标的条件与字段是否非空;多个指标之间仍按“至少一个存在”处理。跨模型指标分别判断,再按公共维度对齐。
  • 查询明确要求属性为空或非空时,显式存在性条件优先,不被默认规则覆盖。

实施时先确认“NULL 是没有这个指标,还是指标存在但数值未知”,再选择「是」或「否」。不要为了让报表少几行就改变这项业务声明,也不要提前把所有可选字段的 NULL 记录从数据源中删除,以免影响其他指标的查询。

配置示例

下面表示「指标 B 只对部分记录成立,NULL 表示不存在」:

{
  "id": "amount_b",
  "name": "指标B",
  "type": "number",
  "constraints": { "required": false }
}

配置在属性上,业务取值由 Schema Mapping 对接来源。原有 groupby_exclude_null: true 配置迁移为 constraints.required: false 后,还应核对该属性用作指标时是否同样符合上述业务含义。