# 数据探索中心 数脉平台用户手册 V2.0 · 数据探索中心 # 仪表盘看板 ## 功能定位 仪表盘看板用于浏览 Superset 6.1.0 中已创建的分析仪表盘。用户可以组合趋势、对比、占比、明细和筛选器，在同一页面回答一个完整业务问题。 ![仪表盘看板](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-ercdxtfz.png) *图 4-1　Superset 仪表盘工作区* ## 适用角色 BI 分析师、业务分析人员和经营管理人员。 ## 页面入口 数据探索中心 → 仪表盘看板（`/bi/superset/dashboard`）。 ## 操作步骤 1. 打开看板列表，选择与业务主题匹配的仪表盘。 2. 使用日期、区域、渠道、产品线等筛选器限定分析范围。 3. 将鼠标移到图表上查看数值、单位和时间点；必要时点击图表联动其他组件。 4. 使用图表右上角菜单导出图片或查看数据；导出范围不得超出当前数据权限。 5. 需要调整布局或新增图表时，进入编辑模式；无编辑权限时只能查看和筛选。 6. 完成后返回列表，避免在公共终端保留登录会话。 ## 输入与输出 输入是数据集、图表定义和筛选条件；输出是可交互看板、图表明细和可导出的分析结果。 ## 宏澜家电示例 销售运营打开“区域销售与毛利看板”，筛选 2026 年第三季度和华南区域。趋势图显示销售额增长但毛利率下降，再按产品线联动发现高端空调促销折扣过高，于是转到 SQL 工作台或 AI 对话分析继续验证。 ## 客户应用演示：销售例会前查看“销售业绩全景看板” **业务情境：** 销售负责人需要在会议前确认区域销售额、毛利率和订单趋势。 ### 第一步：进入“数据探索中心 → 仪表盘看板” ![第1步重点操作：进入“数据探索中心 → 仪表盘看板”](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-k6mltcjk.jpeg) *步骤图 17-01　第1步：进入“数据探索中心 → 仪表盘看板”。红框标出进入数据探索中心 → 仪表盘看板。* 进入“数据探索中心 → 仪表盘看板”，在列表搜索“销售业绩全景看板”。 ### 第二步：点击已发布看板 ![第2步重点操作：点击已发布看板](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-nxxp55uv.jpeg) *步骤图 17-02　第2步：点击已发布看板。红框标出点击已发布看板。* 点击已发布看板，查看标题、筛选器和数据更新时间。 ### 第三步：选择时间范围“最近 6 个月” ![第3步重点操作：选择时间范围“最近 6 个月”](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-4kmnavqr.jpeg) *步骤图 17-03　第3步：选择时间范围“最近 6 个月”。红框标出选择时间范围最近 6 个月。* 选择时间范围“最近 6 个月”，按区域和渠道筛选。 ### 第四步：将鼠标移到趋势或柱状图上查看明细提示 ![第4步重点操作：将鼠标移到趋势或柱状图上查看明细提示](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-yrl4m0ce.jpeg) *步骤图 17-04　第4步：将鼠标移到趋势或柱状图上查看明细提示。红框标出将鼠标移到趋势或柱状图上查看明细提示。* 将鼠标移到趋势或柱状图上查看明细提示，必要时进入关联明细图表。 ### 第五步：整理需要跟进的异常区域 ![第5步重点操作：整理需要跟进的异常区域](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-nypp3spk.jpeg) *步骤图 17-05　第5步：整理需要跟进的异常区域。红框标出整理需要跟进的异常区域。* 整理需要跟进的异常区域，并记录看板名称和筛选条件，便于复盘。 ## 最终结果与效果 看板按所选时间、区域和渠道展示最新分析结果，图表之间保持同一筛选口径。业务用户无需再次登录数据探索工具。 > **操作提示：** 看板中的“草稿”状态不等于已发布；正式会议请使用“已发布”版本。 ## 常见问题 **页面显示“正在加载数据探索页面”较久。** 先等待首次初始化；若超过提示时间，检查 Superset 服务和后端免登录通道。 **看板打开后又要求登录。** 这是安全票据过期或会话失效。返回数脉平台重新点击菜单，不要在新窗口手工输入第三方凭据。 **图表无数据。** 检查筛选期间、数据集权限和源表是否有该期间数据。 ## 开发人员参考 - 页面：`ui/src/views/bi/superset/index.vue` - 接口：`GET /bi/superset/status?page=dashboard`、`GET /bi/superset/launch?page=dashboard` - 权限：`bi:sup:dashboard` - 目标路径由后端白名单生成；安全票据约 45 秒有效且一次性使用。 # 数据集与指标 ## 功能定位 数据集与指标页面承载 Superset 的数据集模型和指标定义，是图表、SQL 工作台和 AI 看板共同使用的数据语义层。 ![数据集与指标](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-wwxz9xpm.png) *图 4-2　数据集、字段与指标管理入口* ## 适用角色 BI 分析师、数据开发人员和指标管理员。 ## 页面入口 数据探索中心 → 数据集&指标（`/bi/superset/dataset`）。 ## 操作步骤 1. 新建或打开数据集，选择已登记且经审核的物理表或 SQL 数据集。 2. 检查字段类型、中文名称、是否可分组、是否可过滤和是否可聚合。 3. 创建指标时写明业务口径、计算公式、单位、时间粒度和负责人。 4. 设置数据集权限和行级安全规则，确保不同角色只看到授权范围。 5. 保存前预览字段和数据量；发布后在仪表盘或 AI 分析中引用。 6. 口径变更应形成新版本并更新业务字典，不要直接覆盖历史解释。 ## 输入与输出 输入是数据源、表字段、SQL 和指标定义；输出是可复用数据集、维度、指标与权限规则。 ## 宏澜家电示例 建立“销售订单分析数据集”，包含订单日期、区域、渠道、产品品类、销售额、销量、折扣额和毛利额。指标“成交金额”明确为含税订单金额扣除取消订单，“毛利率”按毛利额除以净销售额计算。 ## 结果说明 数据集是“单一事实来源”的入口。若同一指标在多个图表中口径不同，应先修正数据集和业务字典，而不是在每个图表内分别写公式。 ## 客户应用演示：维护“销售订单分析数据集” **业务情境：** BI 分析师需要为销售趋势、品类占比和客户排行提供统一的数据集。 ### 第一步：进入“数据探索中心 → 数据集&指标” ![第1步重点操作：进入“数据探索中心 → 数据集&指标”](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-ictogwj2.jpeg) *步骤图 18-01　第1步：进入“数据探索中心 → 数据集&指标”。红框标出进入数据探索中心 → 数据集&指标。* 进入“数据探索中心 → 数据集&指标”，找到销售订单主题数据集。 ### 第二步：打开数据集详情 ![第2步重点操作：打开数据集详情](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-qoihdrfq.jpeg) *步骤图 18-02　第2步：打开数据集详情。红框标出打开数据集详情。* 打开数据集详情，检查来源表、字段类型、指标定义和默认过滤条件。 ### 第三步：确认“销售额、订单数、毛利额、毛利率”等指标的计算口径 ![第3步重点操作：确认“销售额、订单数、毛利额、毛利率”等指标的计算口径](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-tv2mlngl.jpeg) *步骤图 18-03　第3步：确认“销售额、订单数、毛利额、毛利率”等指标的计算口径。红框标出确认销售额、订单数、毛利额、毛利率等指标的计算口径。* 确认“销售额、订单数、毛利额、毛利率”等指标的计算口径。 ### 第四步：在数据集预览中抽查一个区域和月份 ![第4步重点操作：在数据集预览中抽查一个区域和月份](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-y0ajemqe.jpeg) *步骤图 18-04　第4步：在数据集预览中抽查一个区域和月份。红框标出在数据集预览中抽查一个区域和月份。* 在数据集预览中抽查一个区域和月份，确认数据行数与合计合理。 ### 第五步：保存变更并记录修改原因 ![第5步重点操作：保存变更并记录修改原因](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-bmzxkqu8.jpeg) *步骤图 18-05　第5步：保存变更并记录修改原因。红框标出保存变更并记录修改原因。* 保存变更并记录修改原因；如口径发生变化，提交相应审核。 ## 最终结果与效果 数据集字段和指标可被多个图表复用，预览结果与业务口径一致。下游图表不需要重复编写相同计算。 > **操作提示：** 不要直接在数据集里加入未授权的敏感字段；字段和行级权限应在服务端控制。 ## 开发人员参考 - 页面入口：`/bi/superset/dataset` - 权限：`bi:sup:dataset` - 通过 Superset 原生数据集管理能力维护字段、指标和 RLS；数脉统一负责门户身份与免登录跳转。 - 受控 SQL 仍需遵循只读、字段白名单和行数限制。 # SQL 工作台 ## 功能定位 SQL 工作台面向具备 SQL 能力的分析人员，用于直接查询已授权数据、验证口径和保存可复用查询。它适合探索性分析，不应替代经过审核的固定报表。 ![SQL 工作台](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-7w0mcmwq.png) *图 4-3　SQL 查询、结果与保存入口* ## 适用角色 BI 分析师、数据开发和数据治理人员。 ## 页面入口 数据探索中心 → SQL 工作台（`/bi/superset/sqllab`）。 ## 操作步骤 1. 在左侧选择数据库和数据集范围。 2. 输入只读 SQL，先使用 `LIMIT` 控制结果规模。 3. 点击运行，检查执行状态、耗时、返回行数和字段类型。 4. 将结果保存为查询或数据集，补充名称、业务说明和责任人。 5. 需要复用时，将稳定查询转化为数据集和指标，并提交审核。 6. 分析完成后退出，不在查询中保存口令、令牌或个人敏感信息。 ## 输入与输出 输入是只读 SQL 和授权数据源；输出是查询结果、执行日志和可保存的查询资产。 ## 宏澜家电示例 分析师验证“华南区域毛利率下降”时，按月份、产品线和渠道分组查询销售额、折扣额与毛利额，确认异常来自高端空调的促销折扣，而不是退货或汇率因素。 ## 安全边界 - 只允许只读查询；写操作、DDL 和危险函数应被拒绝。 - 查询结果受行数限制，导出还需额外权限。 - 结果中如含个人信息，应遵守最小必要原则，不复制到聊天工具或公共文档。 ## 客户应用演示：核对华南区域毛利率异常 **业务情境：** 分析师发现华南区域毛利率下降，需要用只读 SQL 验证品类和折扣因素。 ### 第一步：进入“数据探索中心 → SQL 工作台” ![第1步重点操作：进入“数据探索中心 → SQL 工作台”](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-fqoroyie.jpeg) *步骤图 19-01　第1步：进入“数据探索中心 → SQL 工作台”。红框标出进入数据探索中心 → SQL 工作台。* 进入“数据探索中心 → SQL 工作台”，选择销售分析数据库。 ### 第二步：输入只读查询 ![第2步重点操作：输入只读查询](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-8om71lje.jpeg) *步骤图 19-02　第2步：输入只读查询。红框标出输入只读查询。* 输入只读查询，按月份、产品线和渠道汇总销售额、折扣额、毛利额。 ### 第三步：在查询中加入时间范围和 `LIMIT` ![第3步重点操作：在查询中加入时间范围和 `LIMIT`](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-qnirvfkn.jpeg) *步骤图 19-03　第3步：在查询中加入时间范围和 `LIMIT`。红框标出在查询中加入时间范围和 LIMIT。* 在查询中加入时间范围和 `LIMIT`，先控制结果规模后运行。 ### 第四步：检查返回行数、字段类型、执行耗时和异常空值 ![第4步重点操作：检查返回行数、字段类型、执行耗时和异常空值](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-fzij8zms.jpeg) *步骤图 19-04　第4步：检查返回行数、字段类型、执行耗时和异常空值。红框标出检查返回行数、字段类型、执行耗时和异常空值。* 检查返回行数、字段类型、执行耗时和异常空值。 ### 第五步：把稳定查询保存为查询或数据集 ![第5步重点操作：把稳定查询保存为查询或数据集](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-gx9rieqx.jpeg) *步骤图 19-05　第5步：把稳定查询保存为查询或数据集。红框标出把稳定查询保存为查询或数据集。* 把稳定查询保存为查询或数据集，补充名称、业务说明和责任人。 ## 最终结果与效果 查询结果定位到具体月份、产品线和渠道，能够验证或排除毛利率下降原因；稳定查询可被后续分析复用。 > **操作提示：** SQL 工作台只用于只读分析，不应尝试建表、更新、删除或导出敏感明细。 ## 开发人员参考 - 页面入口：`/bi/superset/sqllab` - 权限：`bi:sup:sqllab` - SQL 校验在服务端完成；前端限制不能替代数据库只读账号、网络边界和审计。 - 查询异常应记录 SQL 摘要、耗时和错误码，但不得记录凭据或完整敏感结果。 # AI 对话分析 ## 功能定位 AI 对话分析让业务用户用自然语言描述分析目标，由大模型结合受控数据集和 MCP 工具生成多图表看板方案。系统先给出方案，用户二次确认后才真正创建数据集、图表和看板。 ![AI 对话分析](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-wqqj4qay.png) *图 4-4　输入问题、查看步骤并确认看板方案* ## 适用角色 业务分析人员、经营管理人员和 BI 分析师。当前演示环境页面显示模型为 `DeepSeek-V4.1-Flash`，由企业模型网关调用。 ## 页面入口 数据探索中心 → AI 对话分析（`/bi/superset/ai`）。 ## 操作步骤 1. 在输入框描述业务问题，建议同时写明**分析对象、时间范围、对比维度和关注指标**。 2. 点击“开始分析”或按 `Ctrl + Enter`。系统展示 AI 工具调用轨迹和看板方案。 3. 检查方案中的数据范围、图表数量、字段、指标、筛选条件和单位。一次最多生成 5 张图表，并放入同一看板。 4. 点击“确认创建看板”。方案只能消费一次，重复提交会提示过期或已执行。 5. 创建完成后点击“打开看板”，在 Superset 中查看结果。 6. 需要调整样式时，输入“把背景改成深蓝色”“图表使用青蓝色系”“标题字号调大”等指令，系统解析后应用到看板。 7. 任何 AI 结果都必须人工复核后再用于经营判断。 ## 推荐提问模板 ```text 分析【时间范围】内【业务对象】的【指标】， 按【维度一】和【维度二】拆分， 展示趋势、占比和排行，并标注异常。 ``` **宏澜家电示例：**“分析最近 6 个月各区域销售额趋势、品类销售占比和前 10 名客户，使用青蓝色主题。”AI 返回趋势图、占比图、客户排行等多图表方案；确认后形成一个看板，再要求“标题字号调大、图表文字使用深灰色”。 ## 输入与输出 | 项目 | 规则 | |---|---| | 问题长度 | 最多 500 字 | | 分析边界 | 只读分析，不直接修改业务库 | | SQL 安全 | 数据集范围、字段白名单、只读和行数限制 | | 方案确认 | 一次性消费，创建前必须人工确认 | | 输出 | 一个最多 5 图表的看板、分析步骤和审计记录 | ## 客户应用演示：一次生成多图表销售复盘看板 **业务情境：** 经营会需要同时查看销售趋势、区域占比、品类结构和客户排行。 ### 第一步：进入“数据探索中心 → AI 对话分析” ![第1步重点操作：进入“数据探索中心 → AI 对话分析”](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-wujvxlrh.jpeg) *步骤图 20-01　第1步：进入“数据探索中心 → AI 对话分析”。红框标出进入数据探索中心 → AI 对话分析。* 进入“数据探索中心 → AI 对话分析”，确认模型和 AI 状态可用。 ### 第二步：输入“分析最近 6 个月销售额、毛利额和订单数 ![第2步重点操作：输入“分析最近 6 个月销售额、毛利额和订单数](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-vyxrqj6x.jpeg) *步骤图 20-02　第2步：输入“分析最近 6 个月销售额、毛利额和订单数。红框标出输入分析最近 6 个月销售额、毛利额和订单数。* 输入“分析最近 6 个月销售额、毛利额和订单数，按月份看趋势、按区域和品类看占比，列出前 10 名客户”。 ### 第三步：查看分析步骤 ![第3步重点操作：查看分析步骤](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-3dfqdofk.jpeg) *步骤图 20-03　第3步：查看分析步骤。红框标出查看分析步骤。* 查看分析步骤，确认数据范围、指标口径和只读边界。 ### 第四步：在看板方案中核对最多 5 张图表的类型、字段、筛选和单位 ![第4步重点操作：在看板方案中核对最多 5 张图表的类型、字段、筛选和单位](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-xehqqc0f.jpeg) *步骤图 20-04　第4步：在看板方案中核对最多 5 张图表的类型、字段、筛选和单位。红框标出在看板方案中核对最多 5 张图表的类型、字段、筛选和单位。* 在看板方案中核对最多 5 张图表的类型、字段、筛选和单位。 ### 第五步：点击“确认创建看板” ![第5步重点操作：点击“确认创建看板”](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-2auwhdtg.jpeg) *步骤图 20-05　第5步：点击“确认创建看板”。红框标出点击确认创建看板。* 点击“确认创建看板”，再点击“打开看板”查看结果。 ### 第六步：输入“背景改为深蓝色 ![第6步重点操作：输入“背景改为深蓝色](https://help.bigdata365.net/uploads/images/gallery/2026-11/embedded-image-mtlc9lqw.jpeg) *步骤图 20-06　第6步：输入“背景改为深蓝色。红框标出输入背景改为深蓝色。* 输入“背景改为深蓝色，图表用青蓝色系，标题字号 18”，复核后保存。 ## 最终结果与效果 同一看板生成趋势、占比、品类和客户排行等多张图表，配色和文字样式可按自然语言调整。方案需人工确认，不会自动发布。 > **操作提示：** 方案约 30 分钟有效且只能消费一次；样式调整不改变底层数据。 ## 常见问题 **点击后没有生成看板。** 检查是否已经点击二次确认；只有方案阶段不会创建资产。 **提示方案已过期。** 重新发起分析并生成新方案，不要重复使用旧方案。 **样式指令没有生效。** 使用明确的对象和值，例如“看板背景改为 #0B1F3A，图表标题字号 18”；若仍失败，检查看板 ID 和权限。 **AI 回答看似合理但数据异常。** 核对字段、时间范围、筛选条件和指标口径；AI 输出不能替代数据校验。 ## 开发人员参考 - 页面：`ui/src/views/bi/ai/index.vue` - 接口：`GET /bi/ai/status`、`POST /bi/ai/chat`、`POST /bi/ai/execute`、`POST /bi/ai/style` - 权限：`bi:sup:ai` - 方案包含 `planId` 且一次性有效；服务端校验数据集范围、字段白名单、只读 SQL 和行数限制。 - 模型网关配置通过环境变量管理，文档和日志不得出现真实 API Key。