Databricks SQL 仪表板

使用 Databricks SQL 仪表板可以合并可视化效果和用于提供数据上下文的文本框。

• 查看已保存的仪表板的列表
• 创建仪表板
• 克隆仪表板
• 删除仪表板中的内容
• 编辑仪表板
• 刷新仪表板
• 以 PDF 格式下载
• 将仪表板移至回收站
• 从回收站还原仪表板
• 永久删除仪表板
• 打开查询
• 配置仪表板权限
• 访问管理员视图
• 转让仪表板的所有权

查看已保存的仪表板的列表

若要查看已保存仪表板的列表，请单击边栏中的 仪表板。 默认情况下，仪表板按“创建者”列以时间倒序排序。 可以通过单击列标题重新对列表进行排序。

筛选已保存的仪表板的列表

可按照创建的仪表板列表（“我的仪表板”）、收藏夹和标记来筛选仪表板列表。

创建仪表板

执行下列步骤，创建新的仪表板。 若要克隆现有仪表板，请参阅克隆仪表板。

1. 执行下列操作之一：

   • 单击边栏中的 “创建”，然后选择“仪表板”。
   • 单击边栏中的 “仪表板”，然后单击“+ 新建仪表板”按钮。
   • 如果你不想从空仪表板开始，可以创建一个快速仪表板：
     1. 单击边栏中的 “数据”。
     2. 浏览到表，然后单击“创建”“快速仪表板”。
     3. 在配置页面中，选择感兴趣的列，然后创建仪表板和支持查询，这些查询使用这些列提供一些基本信息，并展示仪表板级参数和其他功能。
     4. 继续执行以下步骤，自定义仪表板。

2. 输入仪表板的名称。

3. 将内容添加到仪表板：

   • 单击“添加文本框”以添加注释。

     输入文字。 可使用 Markdown 为文本框制定样式。 若要在仪表板的文本框中包含静态图像，请使用 Markdown 图像语法：![alt-text](<image-url>)。

   • 单击“添加小组件”，添加查询可视化效果。

     1. 选择查询。 搜索现有查询或从预先填充的列表中选取最近的查询。

     2. 在“选择可视化效果”下拉列表中，选择可视化效果类型。

        

4. 单击“添加到仪表板”。

   

5. 拖放仪表板上的内容块。

6. 单击“完成编辑”。

   

克隆仪表板

如果对仪表板及其每个上游查询具有“可运行”、“可编辑”和“可管理”权限 ，则可以克隆仪表板和所有上游查询。 你已成为新仪表板和查询的所有者。

重要

共享设置、警报和订阅不会复制到新仪表板中。

克隆仪表板：

1. 打开仪表板右上角的垂直省略号 ，然后选择“克隆”。
2. 输入新仪表板的名称，然后单击“确认”。

删除仪表板中的内容

1. 单击小组件右上方的垂直省略号 ，然后选择“从仪表板中删除”。
2. 单击 “删除” 。

编辑仪表板

若要打开仪表板进行编辑，请打开仪表板右上方的垂直省略号 ，然后选择“编辑”。

编辑时，可添加和删除内容并应用筛选器。 要更改参数的显示顺序，可以单击每个参数并将其拖动到所需位置。

将内容添加到仪表板

1. 打开仪表板进行编辑。
2. 单击“添加文本框”或“添加小组件” 。
3. 单击“添加到仪表板”。
4. 单击“完成编辑”。

还可将可视化效果添加到 SQL 编辑器中的仪表板。

删除仪表板中的内容

1. 单击 或将鼠标悬停在对象上，单击小组件右上方的垂直省略号 ，然后选择“从仪表板中删除”。
2. 单击 “删除” 。

仪表板筛选器

当查询具有筛选器时，还必须在仪表板级别应用筛选器。 选择“使用仪表板级别筛选器”复选框以将筛选器应用到所有查询。

自定义仪表板颜色

可以自定义仪表板的调色板。

创建调色板

若要为仪表板创建自定义调色板，请执行以下操作：

1. 单击右上角的 ，然后单击“编辑”。
2. 单击“颜色”。
3. 若要导入现有调色板，单击“导入”并选择调色板。 可以自定义导入的调色板。
4. 若要新建调色板或自定义导入的调色板，请执行以下操作：
   1. 若要添加新的颜色，请单击“添加”。
   2. 对于新添加的颜色或现有颜色，执行以下任一操作指定颜色：
      • 单击正方形，然后在颜色选择器中单击新颜色或使用吸管选择新颜色。
      • 单击正方形旁边的文本字段，然后输入十六进制值。
5. 单击“应用” 。

停止使用自定义调色板

若要删除自定义调色板，请执行以下操作：

1. 单击右上角的 ，然后单击“编辑”。
2. 单击“颜色”。
3. 单击“清除”。
4. 单击“应用” 。

自定义可视化效果的颜色

若要自定义可视化效果的颜色，请参阅自定义可视化效果的颜色。

默认情况下，如果仪表板中已应用调色板，则仪表板的可视化效果将使用仪表板的调色板，而不是可视化效果中指定的颜色。 若要覆盖此行为，请执行以下操作：

1. 单击仪表板中可视化效果的，然后单击“编辑”。
2. 单击 Retain colors specified on visualization 旁边的复选框。
3. 单击 “确定” 。

有关详细信息，请参阅自定义可视化效果的颜色。

刷新仪表板

由于仪表板从缓存中提取数据，而只要运行查询，就会更新缓存，因此仪表板的加载速度会很快。 但是，如果你最近没有运行查询，则仪表板可能已过时。 如果最近运行了某些查询而未运行其他查询，仪表板甚至可以将旧数据与新数据混合在一起。

每次手动或按计划刷新仪表板时，都会刷新仪表板和上游中的所有查询（包括参数使用的查询）。 刷新单个可视化效果时，将刷新所有上游查询（包括参数使用的查询）。

手动刷新仪表板

若要强制刷新，请单击仪表板右上方的“刷新”按钮。 此操作将运行所有仪表板查询并更新其可视化效果。

自动刷新仪表板

仪表板的所有者和具有“可编辑”权限的用户可将仪表板配置为按计划自动刷新。 若要自动刷新仪表板，请执行以下操作：

1. 单击仪表板右上方的“计划”按钮。 随即将出现计划对话框。

   

2. 在“刷新间隔”下拉列表中，选择一个时段。

3. 在“SQL 仓库”下拉列表中，根据需要选择要用于所有查询的 SQL 仓库。 如果没有选择仓库，则将在上次使用的 SQL 仓库上执行查询。

4. 在“订阅者”旁，可选择输入在自动更新仪表板时要通知的电子邮件地址列表。

   输入的每个电子邮件地址都必须与 Azure Databricks 帐户相关联，或者配置为警报目标。

5. 单击“保存”。 “计划”按钮标签更改为“已计划” 。

仪表板快照订阅

你可以定期导出仪表板快照并发送电子邮件。 仪表板快照是从默认仪表板状态拍摄的，这意味着快照中不存在与筛选器和可视化效果的任何交互。

如果你是仪表板的所有者，或者具有“可编辑”权限，则可以创建刷新计划并订阅其他用户，这些用户将在每次刷新仪表板时收到仪表板的电子邮件快照。

注意

如果你具有“可编辑”权限，则只能订阅已有权访问仪表板的用户，或订阅已配置的警报目标。 如果你具有“可管理”权限，则可以订阅有权访问工作区的任何用户。

若要添加订阅者，请在“订阅者”字段中输入仪表板用户的一个或多个电子邮件地址或警报目标。

如果具有对仪表板的“可查看”或“可编辑”权限，则可以订阅现有的刷新计划 。 若要订阅，单击“订阅”按钮。

临时暂停计划的仪表板更新

如果仪表板配置为自动更新，它的顶部会有一个“已计划”按钮，而不是一个“计划”按钮 。 可以暂时暂停仪表板更新并将其计划导出到订阅。 这有助于避免在测试对仪表板的更改时发送更新。 暂时暂停计划的仪表板更新而不修改订阅者列表：

1. 单击“已计划”。
2. 单击“已启用”切换开关。
3. 单击“保存”。

停止自动更新仪表板

如果仪表板配置为自动更新，它的顶部会有一个“已计划”按钮，而不是一个“计划”按钮 。 停止自动更新仪表板并删除其订阅：

1. 单击“已计划”。
2. 在“刷新间隔”下拉列表中，选择“从不” 。
3. 单击“保存” 。 “已计划”按钮标签将更改为“计划” 。

以 PDF 格式下载

若要将仪表板下载为 PDF 文件，请单击仪表板右上方的垂直省略号 ，然后选择“下载为 PDF”。

将仪表板移至回收站

若要将仪表板移至回收站，请单击仪表板右上方的垂直省略号 ，然后选择“移至回收站”。 单击“移至回收站”进行确认。

从回收站还原仪表板

1. 单击边栏中的 “仪表板”。
2. 单击 。
3. 单击仪表板。
4. 单击仪表板右上方的垂直省略号 ，然后选择“还原”。

永久删除仪表板

1. 在“所有仪表板”列表中，单击 。
2. 单击仪表板。
3. 单击仪表板右上方的垂直省略号 ，然后选择“删除”。

打开查询

若要打开 SQL 编辑器的小组件中显示的查询，请单击小组件右上方的垂直省略号，然后选择“查看查询”。

配置仪表板权限

若要配置可以管理和运行仪表板的人员，请参阅仪表板访问控制。

访问管理员视图

Azure Databricks 管理员用户可查看所有仪表板。 在此视图中，管理员可查看和删除任何仪表板。 但是，如果仪表板未与管理员共享，则管理员将无法编辑它们。

若要查看所有仪表板：

1. 单击边栏中的 “仪表板”。
2. 在右侧面板中单击“管理员视图”。

转让仪表板的所有权

如果从工作区中删除仪表板的所有者，则仪表板不再具有所有者，并且只有管理员用户可以管理仪表板的权限。 管理员用户可以将任何仪表板的所有权（包括没有所有者的仪表板）转让给其他用户。 若要使用 Databricks SQL UI 转让所有权，请执行以下操作：

1. 打开仪表板。
2. 单击“共享”。
3. 单击“分配新所有者”。
4. 从下拉列表中选择要设为所有者的新用户，然后单击“确认”。

若要使用 REST API 转让所有权，请参阅转让仪表板的所有权。

如果此仪表板以前具有所有者，则该用户不再具有对仪表板的“可管理”权限。 你授予“可管理”权限的用户现在成为所有者。