概述
本文介绍如何在 DataBuddy 中创建一个新的仪表盘，并在画布上完成基本的布局工作：组织页面（Tab）、调整组件位置、设置主题，以及对仪表盘文件本身进行重命名、克隆、移动、导入导出等操作。
前提条件
在开始本操作前，请确保满足以下条件：
已开通 DataBuddy 服务并完成空间初始化。
当前账号在目标 Workspace 中至少拥有 可编辑 权限（角色权限说明详见 管理仪表盘权限）。
已准备好至少一份「数据分析型」计算资源（详见 配置数据源与查询 中的「选择计算资源」章节）。
使用限制
限制项 | 说明 |
仪表盘标题长度 | 后台限制 100 字符列表，展示超长时省略号显示 |
仪表盘标题字符 | 不支持 /、\\、: 等特殊字符 |
单个仪表盘页面（Tab）数量 | 最多 15 个页面 |
Tab 名称长度 | 最长100个字符 |
导入文件大小 | 单个 JSON 文件不超过 100 MB |
多人协同编辑 | 同一页面同时仅支持一人编辑，第二人会收到冲突提示 |
操作步骤
步骤 1：进入仪表盘列表
1. 登录 DataBuddy 控制台。
2. 在顶部切换到目标 Workspace。
3. 在左侧导航栏选择 数据分析 > 仪表盘 。
支持按 仪表盘名称 进行模糊搜索，并支持按 更新时间 排序、按 所有者 筛选。
步骤 2：创建仪表盘
在仪表盘列表页右上角，您可以选择以下任一方式创建：
创建空白仪表盘 ：单击创建仪表盘，系统按「新仪表盘、当前日期时间」格式生成默认名称，并立即进入编辑态。
导入仪表盘 ：单击导入 ，上传 JSON 文件（支持从 DataBuddy 导出的仪表盘文件）。导入成功后会新建一个名为「导入的 {原仪表盘名称} YYYY-MM-DD HH:MM:SS」的仪表盘。
说明：
仪表盘名称稍后可在编辑态点击标题直接修改。
步骤 3：组织画布与页面
进入编辑态后，画布的主要区域如下：
顶部 ：仪表盘标题、收藏、全局筛选器区域、页面（Tab）选项卡、刷新按钮、发布、分享、计算资源选择器、更多操作菜单。
画布主区 ：组件编辑区，可拖拽放置图表、表格、文本框、筛选器等。
画布下方居中 ：常驻工具栏，提供 添加可视化组件、文本框、页面筛选器、撤销和前进操作等入口。
新增、重命名、删除页面（Tab）
1. 单击 Tab 行末的 + 按钮可新增页面。
2. 在 Tab 名称上点击 ⋯ 可执行 重命名、删除、拖动调整顺序 操作。
3. 拖拽 Tab 即可调整顺序。
注意：
单个仪表盘最多 15 个 Tab，名称最长 100 字符。
在画布上添加组件
在画布下方工具栏中：
点击图表 ：选择图表类型后，鼠标拖拽到画布上对应区域松开即可创建组件。详见 添加图表组件。
点击文本框 ：在画布上拖拽出一块区域，用于添加章节标题或说明性文字。
点击页面筛选器 ：添加只对当前 Tab 生效的筛选器。
多人协同编辑的冲突处理
同一 Tab 同时只能有一人在编辑组件。当其他成员同时操作时，您会看到提示：「{用户名} 也在同时编辑该 Tab 页面，请稍后重试或联系您的同事」。
如果对方正在新增 Tab，而您执行了「撤回」，操作会失败并提示「上一步操作新增的页面已经被他人更新，请刷新页面再试」。
步骤 4：管理仪表盘文件
重命名 ：点击仪表盘标题直接编辑。
在仪表盘编辑态右上角的 更多 菜单中，提供以下文件级操作：
导出仪表盘：导出为 JSON 文件，文件名以仪表盘标题为基础。
转让所有者：作为该仪表盘的所有者，支持对所有者进行转让。
移动仪表盘：在同一 Workspace 内将仪表盘移动到另一个文件夹。仅 可管理 权限以上的用户可发起移动；移动后对象 ID、URL、权限、分享链接、嵌出配置均保持不变。
复制仪表盘 ：复制当前仪表盘的全部内容（含组件、布局、数据集、参数、联动规则、配置）。新仪表盘默认命名为「原名称、副本」，所有者为当前用户，仅当前用户与 Admin 拥有「可管理」权限，不继承原仪表盘的其他权限 。
删除仪表盘：点击后进行二次确认是否删除，支持确认和取消。
撤销所有变更 ：将当前草稿态的内容还原到最近发布的版本，需二次确认。平台仅保留最近一次发布版本，多次发布之间的版本历史对用户不可见。
步骤 5：保存与发布
仪表盘的所有改动自动以草稿形式保存 ，无需手动单击保存。
完成布局与配置后，点击右上角发布，进入发布流程。
参数说明
仪表盘文件属性
参数 | 说明 | 是否必填 | 默认值 | 取值范围 |
仪表盘标题 | 仪表盘的显示名称 | 是 | 「新仪表盘 + 当前日期时间」 | 后台 ≤ 100 字符 |
所在文件夹 | 仪表盘在 Workspace 文件树中的位置 | 是 | 当前用户个人文件夹 | 当前 Workspace 下任意文件夹 |
主题 | 仪表盘整体配色方案 | 否 | 系统默认主题 | 浅色 / 深色 / 自定义 |
时区 | 影响数据查询与定时刷新计划的时区 | 否 | Workspace 默认时区 | IANA 时区数据库 |
Tab（页面）属性
参数 | 说明 | 是否必填 | 默认值 | 取值范围 |
Tab 名称 | 页面显示名称 | 是 | 「无标题页面 N」 | ≤ 100字 |
Tab 数量上限 | 单个仪表盘的最大页面数 | - | - | 15个 |
验证结果
完成创建与布局后，您可以通过以下方式确认：
1. 在仪表盘列表中可以看到新建的仪表盘，更新时间 列显示当前操作时间。
2. 进入仪表盘编辑态，画布上的组件按预期排布；Tab 顺序与名称符合您的设置。
3. 切换浏览器主题或刷新页面后，仪表盘配色与全局、页面筛选器仍然保留。
常见问题
Q：仪表盘的内容什么时候算「已更新」？
A：所有改变仪表盘内容的操作都会刷新 更新时间 ，包括：调整数据集、调整页面、调整组件、调整计算资源配置、修改标题、重新导入覆盖、撤销草稿到已发布版本、移动文件位置、复制仪表盘等。收藏、分享、刷新、导出 等操作不会刷新更新时间。
Q：导入 Databricks 导出的仪表盘 JSON，能直接生效吗？
A：导入文件需符合 DataBuddy 仪表盘 JSON 结构。Databricks 导出的 JSON 主要结构（
result.datasets、result.pages、widget.spec 等）在结构上与 DataBuddy 高度相似，详细兼容性以实际版本为准；如导入失败，平台会在弹窗中提示「文件内容错误或无法匹配」。Q：上传非 JSON 文件或 JSON 超过 100 MB 会怎样？
A：会在上传弹窗内直接提示，分别为「文件格式不匹配，请使用从 DataBuddy 导出的仪表盘文件。」和「文件大小不能超过 100MB」。
Q：账号试用结束或欠费时，仪表盘会怎样？
A：仪表盘列表中所有创建、运行类按钮置灰；通过分享、嵌入链接访问时，会显示「该仪表盘当前不可用」，并保留仪表盘标题。
相关文档
管理仪表盘权限
