# NL2SQL：配置指标与筛选条件

指标把业务人员的叫法与可执行的数值计算口径对应起来。进入知识库“语义配置 → NL2SQL 语义 → 指标”，点击新建。

## 开始前准备

知识库需要有可用的结构化数据表。新建按钮不可用并提示先配置数据源时，先导入并核对表，再回到语义配置。请准备指标名称、计算来源、金额单位、时间范围和过滤条件。

## 基础指标

基础指标从一张来源表进行聚合计算，例如从订单金额计算销售额。

1. 填写指标标识和业务名称，按需补充说明与同义词。
2. 选择基础指标和来源表。
3. 选择聚合函数、聚合字段，检查乘数与单位。
4. 如果口径有固定条件，添加筛选条件。
5. 检查预览与校验结果后保存，再用可人工核对的数据范围验证。

| 字段 | 填写示例与含义 |
| --- | --- |
| 指标标识 | `net_revenue`，作为公式引用的标识 |
| 名称 | “净销售额”，使用业务人员能识别的名称 |
| 指标说明 | 写清单位、退款处理及适用范围 |
| 同义词 | 只加入相同口径的叫法，不把含义不同的指标混在一起 |
| 来源表 | 选择真正承载目标业务的数据表 |
| 聚合函数与字段 | 按页面选项决定如何汇总哪个字段 |
| 乘数 | 用于数值换算，应与金额单位等口径一致 |
| 固定筛选条件 | 排除取消订单、限制业务范围等 |

## 派生指标

派生指标引用已有指标进行四则运算，适合比率或差额。先建立需要的基础指标，再新建派生指标。

1. 选择来源表。
2. 从可引用列表插入基础指标，并通过运算符、数字和括号组合公式。
3. 查看公式预览和错误提示。
4. 保存后对照基础指标结果检查计算。

例如在同一来源表已有 `revenue` 和 `cost` 时，可用 `(revenue - cost) / revenue` 表示毛利率口径；业务上还应明确收入为零时如何处理。

当前公式仅支持同一来源表内的基础指标，切换来源表会清空当前公式。公式不能引用自身或不存在的标识；最多 200 字符，至少包含两个指标或数值并以运算符连接。

## 筛选条件与条件组

每条条件选择字段、比较方式和值。集合条件可输入多个值；区间条件要填完整起止值；为空或不为空无需填写比较值。

条件之间使用 AND／OR 连接。复杂逻辑先建立条件组，让组内条件先计算，再与外层条件组合。例如“已支付 AND（渠道为直销 OR 渠道为合作伙伴）”。检查 SQL 层级预览中的括号，避免把 OR 放在错误层级扩大范围。

未填完的条件或空条件组应补全或删除后再提交。

## 验证指标

用少量已知数据提出标准问题和同义问法，核对数值、单位、过滤范围及零值情况。公式通过校验只说明格式可接受，不等于业务口径正确。