• 简体中文

    • 语义层配置

    TBD

    语义层将底层数据表抽象为可复用的指标和维度，是业务建模页面的核心。下文介绍如何配置字段、公式、字典及校验策略，保证业务口径统一。

    1. 指标配置

    1. 在模型编辑器的 指标 区域点击 新增。
    2. 选择来源字段或编写 SQL 表达式，例如：
    SUM(order_amount) FILTER (WHERE order_status = 'paid')
    1. 指定默认聚合（求和、计数、平均值、去重计数等）与度量时间字段。
    2. 设置显示名称、描述、标签，方便业务方查找。
    3. 可选：配置口径说明、对比口径（如去年同期）、舍入与展示格式。

    2. 维度配置

    1. 在 维度 区域点击 新增，选择字段或 SQL 表达式。
    2. 支持多层级维度（例如大区→省份→城市）以及自定义字典映射。
    3. 可开启“数据脱敏”以隐藏敏感值，或启用“默认过滤”限制数据范围。

    3. 计算字段与派生指标

    • 使用 派生指标 组合多个指标，例如：
    SUM(gmv) / NULLIF(SUM(cost), 0)

    用于构建毛利率、转化率等指标。

    • 对于复杂逻辑，推荐在模型中引用 SQL 片段，保持代码可复用。

    4. 模型校验

    在保存或发布模型前，系统会执行以下校验：

    • 字段依赖是否完整、表是否存在。
    • SQL 是否通过语法与权限检查。
    • 指标与维度的组合是否产生循环引用。

    如出现错误，面板会列出详细信息并定位到具体字段。

    5. 权限与口径管理

    • 为字段设置可见性标签，在角色管理中关联标签即可控制访问。
    • 使用 口径版本 功能为不同业务线定义自己的逻辑（例如“财务 GMV” 与 “增长 GMV”）。
    • 通过 注释与变更记录 保持口径透明，便于跨团队沟通。

    6. 发布与测试

    1. 完成配置后点击 保存草稿，然后 发布。
    2. 在预览面板中输入自然语言问题验证效果，如“上周 GMV 与订单量”。
    3. 若需要回滚，打开“历史版本”选择目标版本并恢复。

    语义层配置完成后，模型即可在 智能问答、API 以及自定义应用中复用，保证所有渠道共享统一口径的数据结果。