1 概述

1.1 背景

在数据模型的编辑、使用过程中，因表结构错误、计算逻辑异常、参数配置不当等问题，常导致查询或抽取数据时出现报错。为解决这一痛点，Smartbi针对数据模型”校验“功能进行增强，旨在帮助用户快速定位并修复模型问题，减少问题排查成本，提升数据处理效率。

1.2 核心价值

• 自主解决问题：支持用户和运维人员在编辑模型时,通过“校验”能直接发现问题，减少对技术支持的依赖。
• 精准定位异常：通过可视化界面清晰展示错误类型与位置，辅助快速修复。

2 具体操作

2.1 进入校验界面

1. 在数据模型编辑页面，点击工具栏的【校验】按钮。
2. 弹出「数据模型校验」对话框，显示所有待检查项目（如：表 / 查询信息、计算逻辑、参数设置等）。

...

以为产品内置的nortthwind 数据库为例，创建的数据模型如下
Image Added

设置了关联关系、创建计算度量、计算列等，保存之后，想要看一下有无异常问题：

1、在数据模型编辑页面，点击工具栏的 校验 按钮。

2、弹出 数据模型校验 对话框，显示所有待检查项目（如：表 / 查询信息、计算逻辑、参数设置等），会自动依据顺序检查：

Image Added

• 单个检查：在列表中找到需检查的项目，点击【检查】按钮。
• 全部检查：点击右上角【检查全部】按钮，系统将批量执行所有项目的校验。
• 取消检查：校验过程中可点击【取消检查】终止当前任务。

2.3 查看校验结果

1. 状态标识：
   • 检查中：显示「正在检查」及进度图标。
   • 完成：显示「完成」，结果列标注「正常」或异常数量。
2. 查看详情：
   • 若存在异常，点击【查看检查结果】按钮，查看具体错误信息（如异常来源、引擎报错日志等）。
   • 示例：orders表下的计算列A表达式错误：at smartbix.augmenteddataset.util.AugmentedDataSetException.create(...)

2.4 处理异常

1. 标识修复：
   • 异常字段 / 表 / 参数会在模型中用黄色告警图标（⚠️）标注。
   • 点击异常项可跳转至对应位置，根据提示修改配置（如调整表达式、修复字段关联等）。
2. 重新校验：修改后可再次执行校验，直至所有项目显示「正常」。

2.5 历史记录

• 校验结果自动保存，下次进入对话框时可直接查看上一次的检测结果。

附录

• 适用场景：数据模型编辑、异常排查、版本发布前验证。
• 注意事项：当前功能仅支持数据模型引擎 V2.0，旧引擎（V1.0）仍沿用原有校验逻辑。

...

• 若存在异常，点击【查看检查结果】Image Added按钮，查看具体错误信息（如异常来源、引擎报错日志等）。
  以下是“表/查询信息检查”异常信息：

          Image Added

        以下是“表/查询信息检查”异常信息：
       Image Added

        其他的项目检查结果也是类似显示效果。