#指标定义

系统内，指标配置有三种常用方式：

进入 系统搭建 > 数据管理 > 指标配置，右上角有两个按钮：「通过提问添加」和「手动添加」。

#自然语言定义

点击「通过提问添加」按钮，将业务逻辑通过自然语言描述出来，系统会根据描述自动生成对应的指标配置。

示例：

#SQL 定义

1. 点击「手动添加」按钮
2. 勾选「SQL 定义」选项
3. 选择对应的 Schema
4. 输入指标的 SQL 语句（仅需描述计算逻辑）

系统支持导入模板：点击「Snippets」按钮查看系统内置模板，选择合适的模板后点击「导入」，再根据实际业务需求调整即可。

示例：

-- 均价 = 总金额 / 总销量
SUM(amount) / SUM(qty)

-- 成交率 = 成交数 / 订单总数
SUM(CASE WHEN status = '成交' THEN 1 ELSE 0 END) / COUNT(1)

#跨表查询

当指标涉及多表关联计算时，SQL 定义分为两个输入区域：

示例：计算加权销售额

场景：销售明细表 tb_sales 中的 sales_amount 需要乘以产品权重表 tb_product_weight 中的 weight 系数。

Schema： tb_sales

SQL 逻辑：

sum(t1.sales_amount * t2.weight)

Left Join：

t1 left join tb_product_weight t2 on t1.product_id = t2.product_id

系统会将以上三部分组装为完整 SQL：

SELECT sum(t1.sales_amount * t2.weight)
FROM tb_sales t1
LEFT JOIN tb_product_weight t2 on t1.product_id = t2.product_id

要点：SQL 逻辑区域只写计算表达式，表关联信息统一在 Left Join 区域管理，两者分离便于维护。

#JS 代码定义（复合指标）

对于复合指标，选择「手动配置」方式。通过自然语言描述的指标，在此处会有对应的 JS 表达方式。同样支持通过导入模板来快速配置。

#计算因子配置

模板示例：

(predItem, { schema, logicform, helperFunctions }) => {
  const preds = [];

  preds.push({
    ...predItem,
    pred: "金额",
    operator: "$sum",
    name: "总金额",
    query: {
      "订单状态": { "$ne": "已取消" }
    },
    schema: "dwd_sales_detail_d370d1",
  });

  preds.push({
    ...predItem,
    pred: "目标金额",
    operator: "$sum",
    name: "总目标金额",
    query: {},
    schema: "dwd_shop_target_odo5tj",
  });

  return preds;
};

模板逻辑说明：

该模板构建了两个计算因子：

配置字段说明：

如需更多计算因子，继续在 preds 数组中添加配置即可。

#子指标计算代码

子指标计算代码用于将上述定义的计算因子进行运算，通过因子的 name 属性引用对应的值。

示例：

// 计算达成率：总金额 / 总目标金额
(m) => (m['总金额'] || 0) / (m['总目标金额'] || 0)

// 计算均价：总金额 / 总销量
(m) => (m['总金额'] || 0) / (m['总销量'] || 0)

// 多因子复合运算
(m) => (m['因子1'] || 0) / ((m['因子2'] || 0) * (m['因子3'] || 0))