NL2SQL：配置指标与筛选条件¶
指标把业务人员的叫法与可执行的数值计算口径对应起来。进入知识库“语义配置 → NL2SQL 语义 → 指标”，点击新建。
开始前准备¶
知识库需要有可用的结构化数据表。新建按钮不可用并提示先配置数据源时，先导入并核对表，再回到语义配置。请准备指标名称、计算来源、金额单位、时间范围和过滤条件。
基础指标¶
基础指标从一张来源表进行聚合计算，例如从订单金额计算销售额。
填写指标标识和业务名称，按需补充说明与同义词。
选择基础指标和来源表。
选择聚合函数、聚合字段，检查乘数与单位。
如果口径有固定条件，添加筛选条件。
检查预览与校验结果后保存，再用可人工核对的数据范围验证。
字段 |
填写示例与含义 |
|---|---|
指标标识 |
|
名称 |
“净销售额”，使用业务人员能识别的名称 |
指标说明 |
写清单位、退款处理及适用范围 |
同义词 |
只加入相同口径的叫法，不把含义不同的指标混在一起 |
来源表 |
选择真正承载目标业务的数据表 |
聚合函数与字段 |
按页面选项决定如何汇总哪个字段 |
乘数 |
用于数值换算，应与金额单位等口径一致 |
固定筛选条件 |
排除取消订单、限制业务范围等 |
派生指标¶
派生指标引用已有指标进行四则运算，适合比率或差额。先建立需要的基础指标，再新建派生指标。
选择来源表。
从可引用列表插入基础指标，并通过运算符、数字和括号组合公式。
查看公式预览和错误提示。
保存后对照基础指标结果检查计算。
例如在同一来源表已有 revenue 和 cost 时，可用 (revenue - cost) / revenue 表示毛利率口径；业务上还应明确收入为零时如何处理。
当前公式仅支持同一来源表内的基础指标，切换来源表会清空当前公式。公式不能引用自身或不存在的标识；最多 200 字符，至少包含两个指标或数值并以运算符连接。
筛选条件与条件组¶
每条条件选择字段、比较方式和值。集合条件可输入多个值；区间条件要填完整起止值；为空或不为空无需填写比较值。
条件之间使用 AND／OR 连接。复杂逻辑先建立条件组，让组内条件先计算，再与外层条件组合。例如“已支付 AND（渠道为直销 OR 渠道为合作伙伴）”。检查 SQL 层级预览中的括号，避免把 OR 放在错误层级扩大范围。
未填完的条件或空条件组应补全或删除后再提交。
验证指标¶
用少量已知数据提出标准问题和同义问法，核对数值、单位、过滤范围及零值情况。公式通过校验只说明格式可接受，不等于业务口径正确。