# 分析画卷

将分析组织为多个步骤，查看中间结果，保存并复用分析流程。

对话适合一问一答。当问题需要拆成几步、需要看中间结果、需要反复调整假设时，用分析画卷：每个步骤是一个节点，节点之间由数据依赖自动连线，整个过程留在画布上。

| 你的情况                   | 用哪个                                          |
| ---------------------- | -------------------------------------------- |
| 一个问题，要一个答案，可能追问几轮      | [对话](https://docs.asktable.com/conversation) |
| 要看中间结果、比较不同假设、把推导过程留下来 | 分析画卷                                         |
| 结论要长期盯着，定期刷新           | [数据看板](https://docs.asktable.com/dashboard)  |

画卷和对话共用同一套数据语义和权限，所以画卷里查到的口径和对话里一致。

## 开始前

| 项目 | 要求                                                                                |
| -- | --------------------------------------------------------------------------------- |
| 权限 | 能访问要用的数据源。分析画卷需要相应授权等级，未启用时入口不可用，见[商业授权](https://docs.asktable.com/admin/license) |
| 前置 | 已连接数据源；要分析本地文件的话，文件不超过 10MB                                                       |
| 入口 | 左侧主导航 → 分析画卷                                                                      |

## 创建画卷

左侧主导航点「分析画卷」进入列表页，标题是「所有画卷」。点「创建画卷」新建，或打开已有画卷。

列表支持按名称搜索画卷，以及用「排序」按最近修改 / 名称 / 创建时间排列。没有画卷时页面为空，用上方按钮创建第一个画卷。

## 在画布上工作

**从欢迎区开始**

新画卷中间是欢迎区，带一段引导文案，下面有三个示例入口：「查询数据库中的销售数据」「导入并分析Excel文件」「生成数据可视化图表」。

输入框里描述你想做的事情，左侧可「添加附件」。也可以把 `.xlsx`、`.xls` 或 `.csv` 文件直接拖到画布上，导入后会创建 Excel 节点；空画布和已有节点的画布都支持拖入。

**用右键菜单添加节点**

在画布空白处右键，菜单提供「查数」「联网搜索」「导入 Excel」「自动布局」「删除」。节点也可以由输入框直接产生。

五种节点：数据、图表、Python、Excel、联网搜索。输入框的提示语会随节点类型变化，例如数据节点提示描述数据查询需求，图表节点提示希望生成什么样的图表，Python 节点提示描述数据处理需求，联网搜索节点提示要搜索的数据。

**看节点的执行过程**

节点上直接显示状态，例如处理中、联网搜索中、生成图表中。查询类节点执行完会显示结果，并标出行数与列数。

展开节点能看到它调用了哪些工具，例如读取表结构、查看数据源、搜索元数据、查找表、探索数据库、执行 SQL、更新数据、生成图表、执行 Python、提交代码。

**打开详情面板看中间结果**

选中节点后打开「详情面板」。面板按节点类型给出不同页签：「数据」「图表」「代码」「配置」「SQL」「日志」「描述」。没选节点时面板为空。

**在节点上继续操作**

节点自带操作：「打开详情」「创建图表」（画布上简写为「生图」）「追问」「刷新数据」「删除」。

选中数据后，画布工具栏提供「基于选中数据追问」和「使用 Python 处理选中数据」。

**调整图表和连线**

「图表主题」里可选「风格」（「现代」＝圆角、柔和曲线；「科技」＝直角、锐利线条）和「配色」（含「自定义颜色」），另有图表偏好文本框，例如填“始终显示坐标轴标签和单位”。

连线由数据依赖自动生成。工具栏可「隐藏引用连线」或「显示引用连线」。

**用对话面板讨论整个画布**

画布右侧是对话面板，有「节点详情」和「历史对话」两个入口，可「新建对话」。空态时面板给出开始对话的引导。

针对整个画布提问时，用「对话列表」里的「新建对话」，在输入框里对画卷中的数据提问。

## 从一份销售表完成一次分析

例如，你想知道“上月哪些门店的销售额下降了”：

1. 把包含日期、门店和销售额的 Excel 或 CSV 拖入画布，确认导入节点里的列和数据正确。
2. 选中数据，点「基于选中数据追问」，输入“按门店比较上月和前月销售额，列出降幅最大的门店”。
3. 在结果节点的详情面板检查统计范围和中间结果，再点「创建图表」，把各门店的变化画出来。
4. 需要继续分析时，对结果追问“按商品类别拆分这些门店的降幅”。原始数据、比较结果和图表都留在画布上，便于回看每一步的依据。

## 刷新数据和复用画卷

左上角画卷菜单提供「刷新数据」和「克隆画卷」。刷新会重新获取画卷中的数据节点，完成后提示成功或失败情况；它不等于把所有分析步骤自动重跑一遍。克隆会创建并打开一份画卷副本，适合在保留原分析的同时尝试另一种假设。

## 关键约束

| 项目      | 值                                   | 在哪里改        |
| ------- | ----------------------------------- | ----------- |
| 单文件导入上限 | 默认 10MB，超限时导入被拒绝                    | 管理后台的文件限额设置 |
| 支持的文件格式 | `.xlsx`、`.xls`、`.csv`               | —           |
| 合并单元格   | 不支持跨行复合表头；检测到合并单元格时导入被拒绝，需改用数据源页面上传 | 改用数据源页面上传   |
| 重复列名    | 自动重命名，并列出被改名的列                      | —           |
| 联网搜索    | 需要系统管理员先在系统设置中配置，否则不可用              | 系统设置        |
| 旧版图表节点  | 不支持编辑，需删除后重新创建；可点「升级」在旁边新建新版节点      | —           |

## 出问题怎么判断

| 现象             | 判定条件                  | 处理                                   |
| -------------- | --------------------- | ------------------------------------ |
| 节点执行失败         | 节点上有红色错误标记，展开可见具体信息   | 点「打开详情」看「日志」页签定位；常见原因是 SQL 引用了不可见的字段 |
| 图表渲染失败         | 节点上标出失败并给出原因          | 点「创建图表」重新生成，或在「配置」页签调整               |
| 导入 Excel 后数据为空 | 导入后行数为 0，或提示表为空       | 检查文件是否只有表头；多工作表时在「选择要导入的工作表」里确认勾选    |
| 导入时列名报错        | 导入被拒绝，指出列名重复或没有有效的表头列 | 先在源文件里改掉重复列名                         |
| 刷新数据失败         | 刷新操作报错，节点数据没有更新       | 确认数据源仍可连接；数据源侧改动过表结构时先在数据源页「重新同步」    |
| 画卷打不开          | 提示画卷不存在或无权访问          | 确认账号有该项目的访问权；分析画卷需相应授权等级             |

## 下一步

- 只要几个指标、不需要过程：用[对话](https://docs.asktable.com/conversation)更快
- 结果要长期盯着：加进[数据看板](https://docs.asktable.com/dashboard)
- 让团队也能用这套分析：把方法沉淀为[技能](https://docs.asktable.com/agent/skill)