仪表板

可以使用仪表板生成数据可视化效果并与团队共享报表。 AI/BI 仪表板具有 AI 辅助的创作功能、增强的可视化库和简化的配置体验，使你可以快速将数据转换为可共享的见解。 发布后，仪表板可以与注册 Azure Databricks 帐户的任何人共享，即使他们无权访问工作区。 请参阅共享仪表板。

重要

• Databricks 建议使用 AI/BI 仪表板（以前称为 Lakeview 仪表板）。 早期版本的仪表板，以前称为 Databricks SQL 仪表板，现在称为旧仪表板。 Databricks 不建议创建新的旧版仪表板。
• 使用迁移工具或 REST API 转换旧仪表板。
  • 有关使用内置迁移工具的说明，请参阅将旧版仪表板克隆到 AI/BI 仪表板。
  • 有关使用 API 迁移旧仪表板的说明，请参阅 迁移仪表板。
  • 请参阅 REST API 参考中的迁移仪表板 POST /api/2.0/lakeview/dashboards/migrate 终结点。

AI/BI 仪表板具有以下组件：

• 数据：“数据”选项卡允许用户定义要在仪表板中使用的数据集。 使用 UI 或 API 共享、导入或导出数据集时，数据集与仪表板捆绑在一起。
• 画布： “画布 ”选项卡可以组织成多页报表。 仪表板编辑器可以通过添加可视化效果、筛选器、文本和图像等小组件来生成和配置其仪表板。

注意

每个仪表板最多可以定义 100 个数据集。 画布最多可以包含 10 页。 仪表板可跨所有页面最多容纳 100 个小组件。

查看和整理仪表板

可以从工作区浏览器和其他 Azure Databricks 对象访问仪表板。

• 单击边栏中的 “工作区”，从工作区浏览器查看仪表板。 默认情况下，仪表板存储在 /Workspace/Users/<username> 目录中。 用户可将仪表板连同其他 Azure Databricks 对象一起组织到工作区浏览器的文件夹中。 请参阅工作区浏览器。

• 若要查看仪表板列表页，请单击边栏中的 “仪表板”。

  默认情况下，仪表板列表页面按相反的时间顺序显示你有权访问的仪表板。 可以通过在搜索栏中输入标题来筛选列表、按时间段内上次修改进行筛选，或按所有者进行筛选。

• 单击仪表板标题以打开仪表板。 如果之前已发布仪表板，则将打开已发布的版本。 否则，将打开草稿仪表板。

创建新的仪表板

若要从仪表板列表页创建新仪表板，请单击页面右上角附近的“创建”。

在仪表板上起草和协作

新仪表板从草稿开始。 可以与工作区中的其他用户共享草稿以进行协作。 不得将草稿仪表板与相应工作区之外的用户共享。 所有用户都使用自己的凭据与仪表板草稿中的数据和可视化效果进行交互。

有关权限级别的详细信息，请参阅 AI/BI 仪表板 ACL。

定义数据集

使用“数据”选项卡定义仪表板的基础数据集。

可以将数据集定义为以下任意一种：

• 针对一个或多个表或视图的新查询。
• 现有的 Unity Catalog 表或视图。

注意

每个数据集都由查询定义。 选择现有的 Unity Catalog 表或视图时，查询会默认设置为该对象上的 SELECT *，您可以修改此设置以优化该数据集。

可以通过添加查询或选择其他表或视图来创建多个数据集。 若要调整数据集的显示顺序，请将其名称拖放到所需位置。

若要在数据集编辑器中设置查询格式，请在编辑器中右键单击并选择 设置文档格式。

有关创建和管理仪表板数据集的更多详细信息，请参阅 创建和管理仪表板数据集。

向画布添加页面、可视化效果、文本和筛选器

使用“画布”选项卡构造仪表板。 画布最多可以包含十页。 可以将可视化效果、文本和筛选器小组件添加到每个页面。 使用多个页面来组织内容演示文稿、最小化滚动并提高仪表板可读性。 使用每个页面底部的工具栏添加小组件，如可视化效果、文本框和筛选器。

创建多页报表

新仪表板从名为 “无标题”页面的单页开始。 若要编辑页面的名称，请双击标题，并在文本字段中输入新名称。 命名冲突通过向标题追加数字自动解决。

若要查看页面上的内容，请单击标题将其选中。

添加和删除页面

若要添加新页面，请执行以下操作：

• 单击 画布上当前页标题的右侧。 默认情况下，新页面名为 “无标题”页。
• （可选）双击页面标题并输入新名称以重命名页面。

删除页面：

• 单击页面标题右侧的烤肉串菜单。
• 单击“删除”以删除页面。

注意

删除页面也会删除该页面上的所有小组件。 如果删除所有页面，请单击“ 创建页面 ”以重新生成仪表板。

克隆页面

若要克隆页面，请执行以下步骤：

1. 单击页面标题将其选中。
2. 单击标题磁贴中的 ，然后单击“克隆”。

新页面是原始页面的精确副本，包括所有小组件。 基础数据集保持不变。

可视化效果

通过将可视化小组件添加到画布上的页面来创建可视化效果。 支持的可视化效果包括面积图、条形图、箱形图、组合图、计数器、热度地图、直方图、折线图、饼图、透视图、散点图和表格图表类型。 关于可用可视化效果类型的完整列表和示例配置值，请参阅仪表板可视化效果类型。

注意

可视化效果使用的查询并不总是与数据集精确对应。 例如，如果将聚合应用于可视化效果，可视化效果将显示聚合值。

要创建可视化效果，请使用以下方法之一：

• AI 辅助可视化效果：描述想要以自然语言查看的图表，让 Databricks 助手生成图表。 创建后，可以使用配置面板修改生成的图表。 不能使用助手创建表或数据透视表图表类型。
• 使用配置面板：在可视化配置中应用其他聚合或时间箱，而无需直接修改数据集。 可以选择数据集、x 轴值、y 轴值和颜色。

若要详细了解如何将自定义格式设置应用于图表，请参阅仪表板可视化效果。 请参阅表选项，了解如何在表可视化效果中控制数据呈现。

注意

在可视化配置中应用时态转换时，可视化效果中显示的日期表示该时间段的开始。

文本小组件

Markdown 是用于在纯文本编辑器中设置文本格式的标记语言。 可以在文本小组件中使用 Markdown 设置文本格式、插入链接并将图像添加到仪表板。

向文本小组件添加图像

使用以下任意一种方法将图像添加到仪表板。 每种方法都包含示例可以编辑的 markdown 语法，以用来显示图像。 要调整图像大小，只需调整小组件尺寸即可。

• 使用本地文件：

  若要显示本地文件，请先将其编码为 base64 字符串。 然后，使用以下 Markdown 语法，将 <base64-encoded-string> 替换为编码的字符串。

  ![description](data:image/webp;base64,<base64-encoded-string>)
  

  注意

  如果熟悉命令行实用工具，请使用 base64 工具来转换文件。 或者，有许多可用于 base64 编码文件的免费联机资源。

• 来自卷：

  <WorkspaceURL>/ajax-api/2.0/fs/files/<Volumes/path/to/image>
  

  将此示例中的示例文本替换为工作区 URL 和卷中存储的图像路径。

  使用以下步骤获取图像的路径：

  1. 单击边栏中的 “目录”以打开目录资源管理器 UI。
  2. 单击架构浏览器中的图像文件。
  3. 单击文件名称右侧的 kebab 菜单。 然后单击“复制路径”。

  请参阅什么是 Unity Catalog 卷？，以详细了解如何在卷中存储数据。

• 公开托管的图像：

  对于公开托管的图像，请使用以下 markdown 语法并插入指向图像的公共 URL。

  ![description](URL)
  

将示例文本替换为要显示的图像的描述和 URL。 例如，以下 markdown 将插入 Databricks 徽标的图像：![The Databricks Logo](https://upload.wikimedia.org/wikipedia/commons/6/63/Databricks_Logo.png)。

有关 Markdown 语法的详细信息，请参阅本指南。

注意

使用嵌入凭证发布仪表板时，查看者将使用你的凭证访问所包含的图像。 如果仪表板未使用嵌入凭据发布，则必须显式授予对存储在 Azure Databricks 上的图像文件的用户的访问权限。 可使用目录资源管理器检查、授予和撤销对要包含的图像文件的权限。 单击边栏中的 “目录”以打开目录资源管理器 UI。

交叉筛选

通过交叉筛选，可以分析所选的数据子集，并浏览多个可视化效果之间的关系。 单击一个图表中的元素时，使用同一数据集的同一页上的所有图表都会根据所选值自动筛选。

作为仪表板编辑者，请通过创建共享同一数据集的两个或多个图表来设置交叉筛选。 以下图表类型支持查看者通过单击图表元素来筛选数据集：

• 条形图​​
• 盒须图
• 热度地图
• 直方图
• 饼图
• 散点图
• 点图

选择后，基于同一数据集的所有其他可视化效果都会使用筛选的值自动更新。

使用筛选器

筛选器是仪表板小组件，可帮助查看者缩小结果范围并优化可视化效果中的数据，其类似于其他 BI 工具中的切片器。 可以将它们配置为基于一个或多个数据集列（也称为字段）或创建数据集的 SQL 查询中定义的参数来筛选值。 若要了解如何为仪表板上的可视化效果配置筛选器，请参阅 使用仪表板筛选器。

复制小组件

使用键盘快捷方式复制所选小组件，并将其粘贴回画布上。 创建新小组件后，可以像编辑任何其他小组件一样对其进行编辑。

若要在草稿仪表板画布上克隆小组件，请完成以下步骤：

• 右键单击小组件。
• 单击“克隆”。

小组件的克隆显示在原始小组件下方。

删除小组件

通过选择小组件并按键盘上的删除键来删除小组件。 或者右键单击小组件。 然后单击“删除”。

下载结果

可以将数据集下载为 CSV、TSV 或 Excel 文件。 可以将画布上的可视化效果下载为 PNG 文件。

• 若要从“画布”选项卡打开下载选项，请单击小组件右上角的 三点菜单。
• 若要从“数据”选项卡打开下载选项，请单击数据集右侧的 三点菜单。

可以以 CSV 和 TSV 格式下载最多约 1GB 的结果数据，并将最多 100,000 行数据下载到 Excel 文件中。 最终文件下载大小可能略大于或小于 1 GB，因为 1 GB 限制应用于最终文件下载之前的步骤。

若要了解如何将已发布的仪表板下载为 PDF，请参阅 下载已发布的仪表板。

发布仪表板

发布仪表板以创建当前草稿的干净副本。 必须至少拥有“可编辑”权限才能发布仪表板。

发布仪表板后，即使对草稿进行更改，已发布的版本也会保持不变，直到再次发布。 可以继续在草稿版本中进行修改和改进，而不会影响已发布的副本。 任何可访问已发布仪表板的已注册用户都可以继续查看已发布版本。 如果存在，已发布的版本将继续通过电子邮件发送给订阅者。 有关管理仪表板访问的详细信息，请参阅共享仪表板。

重要

已发布的仪表板未进行版本控制，且不应该用于版本控制。 无法将草稿仪表板还原回以前发布的状态。

发布时，请选择以下选项之一：

• 嵌入凭据：已发布仪表板的所有查看者都可以使用您的凭据来运行查询，以访问数据和计算资源。 这允许具有仪表板访问权限的注册用户查看它，即使他们无法访问原始工作区、基础数据或 SQL 仓库也是如此。 这种情况可能会向尚未被授予直接访问权限的用户公开数据。 这是默认选项。
• 不嵌入凭据：已发布仪表板的所有观看者都使用自己的数据和计算凭据运行查询。 若要在仪表板中查看结果，查看者需要访问工作区、附加的 SQL 仓库和关联数据。

注意

无论凭据设置如何，所有仪表板查看器都必须进行身份验证才能访问仪表板。

有关要选择的设置的建议，请参阅共享已发布的仪表板。

要发布仪表板，请完成以下步骤：

1. 打开一个仪表板。 如果仪表板以前已发布，则将打开已发布的版本。 如有必要，请使用页面顶部的切换器查看当前草稿版本。
2. 单击“发布” 。 此时将显示“发布”对话框。
3. 选择要用于已发布仪表板的凭据。 可以选择是否嵌入凭据。
4. 单击“发布” 。 如果仪表板首次发布，则会打开“共享”对话框，并提示你共享已发布的仪表板。 有关共享的详细信息和建议，请参阅共享仪表板。

若要访问已发布的仪表板，请单击仪表板顶部附近的下拉菜单中的“已发布”。

使用服务主体发布和共享仪表板

使用 REST API 来发布和共享带有与服务主体关联的嵌入的凭据的仪表板。 这使没有直接数据或计算权限的用户可以使用服务主体的凭据（而不是自己的凭据）查看仪表板和运行查询。 用户必须注册到 Databricks 帐户。 有关使用 REST API 管理仪表板的详细信息，请参阅 REST API 参考中的 Lakeview。

下载已发布仪表板

加载已发布的仪表板后，使用以下步骤将其下载为 PDF：

• 单击仪表板右上角附近的 。
• 单击“下载为 PDF”。

从仪表板启用 Genie 空间

重要

此功能目前以公共预览版提供。

创建仪表板时，系统会自动创建 Genie 空间。 Genie 空间是一个无代码接口，支持业务用户使用自然语言进行自助数据分析。 自动创建的 Genie 空间以可用于预览空间的草稿开始。 添加和删除数据集和可视化效果时，草稿 Genie 空间与草稿仪表板会保持同步。

发布仪表板时，可以选择发布关联的草稿 Genie 空间，或链接到现有的 Genie 空间。

发布与仪表板关联的 Genie 空间允许查看者以不同的方式浏览仪表板数据。 他们通过提出自己的问题，进行更深入的分析，进行数据交互，而不是仅基于仪表板上提供的信息来获取见解。 请参阅什么是 AI/BI Genie 空间。

发布 Genie 空间会将“询问 Genie”按钮添加到已发布的仪表板。 当仪表板查看器单击该按钮时，仪表板上将打开聊天界面，并提示用户询问有关数据的问题。

若要发布关联的 Genie 空间，请使用以下步骤：

1. 单击“发布” 。
2. “启用 Genie”开关默认处于打开状态。 单击切换开关可将其打开。
3. （可选）若要链接现有 Genie 空间，请选择“链接现有 Genie 空间”单选按钮并粘贴关联 URL。 如果未选择此选项，则会自动为你生成基于仪表板的新 Genie 空间。
4. 在“发布”对话框中单击“发布”。

注意

草稿和已发布的 Genie 空间是独立的，就像仪表板的草稿和已发布版本一样。 只有当重新发布仪表板时，对草稿仪表板所做的任何更改才会反映在已发布的 Genie 空间中。 草稿和已发布的 Genie 空间是仪表板的助手。 两者不会显示在文件浏览器或 Genie 列表页中。

在新窗口中打开已发布的 Genie 空间：

1. 单击聊天窗口右上角的烤肉串菜单
2. 单击“ 打开 Genie 空间”。

若要预览草稿 Genie 空间，请执行以下操作：

1. 单击仪表板右上角的 Kebab 菜单。
2. 单击“打开草稿 Genie 空间”。

注意

无法通过 Genie 空间 UI 来编辑此 Genie 空间的指令。 只有在对草稿仪表板进行更改时，草稿 Genie 空间才会更改。

链接的 Genie 空间的权限

对关联的 Genie 空间的权限反映了仪表板上已就位的权限，但访问权限仅限于具有工作区访问权限的用户。 即使仪表板与嵌入凭据共享，只有具有工作区访问权限的用户才能与 Genie 空间交互。

查看者使用自己的凭据访问为 Genie 空间提供支持所需的计算和数据。 他们在 Genie 空间中使用的表上必须至少具有 SELECT 权限。

共享仪表板

可以安全地与帐户中的任何人共享仪表板。 对于分配给自己工作区的用户，你可以授予访问权限并设置不同的权限级别，就像对待其他工作区对象那样。 对于未分配到自己工作区的用户，你可以在帐户级别上共享仪表板，允许已注册的用户查看和运行仪表板。

有关管理员如何在帐户级别设置帐户以便共享的详细信息，请参阅仪表板管理指南。 有关在帐户和工作区级别共享仪表板的详细信息，请参阅共享仪表板。

在网站和应用程序中嵌入仪表板

可以使用 iframe 将已发布的仪表板嵌入到外部网站和应用程序中。 请参阅嵌入仪表板。

如果你是工作区管理员，想要管理可嵌入仪表板的外部站点，请参阅管理仪表板嵌入。

计划和订阅

可以设置计划更新以自动刷新仪表板的缓存，还可以选择向订阅该计划的用户发送包含最新仪表板 PDF 的电子邮件。 具有至少“可编辑”权限的用户可以创建计划，让使用嵌入凭据的已发布仪表板能定期运行。 每个仪表板最多可以有 10 个计划。

请参阅管理计划的仪表板更新和订阅。

导出、导入或替换仪表板

为了便于在不同工作区之间共享可编辑的仪表板，可以将仪表板作为文件进行导出和导入操作。 要将仪表板传输到其他工作区，请将其导出为文件，然后将其导入新工作区。 还可以就地替换仪表板文件。 这意味着，直接编辑仪表板文件时，可以将该文件上传到原始工作区，并在维护现有共享设置的同时覆盖现有文件。

以下部分说明如何在 UI 中导出和导入仪表板。 还可以使用 Databricks API 以编程方式导入和导出仪表板。 请参阅 POST /api/2.0/workspace/import。

导出仪表板文件

• 在草稿仪表板中，单击屏幕右上角的 串形菜单，然后单击“导出仪表板”。
• 使用“导出仪表板”对话框确认或取消操作。 导出成功后，.lvdash.json 文件将保存到 Web 浏览器的默认下载目录。

导入仪表板文件

• 在仪表板列表页中，单击 “> 从文件导入仪表板”。
• 单击“选择文件”以打开本地文件对话框，然后选择要导入的 .lvdash.json 文件。
• 单击“导入仪表板”以确认并创建仪表板。

导入的仪表板将保存到你的用户文件夹。 如果与导入的仪表板同名的项已在该位置中存在，则会通过追加带括号的数字来创建唯一名称，从而自动解决冲突。

从文件替换仪表板

• 在草稿仪表板中，单击屏幕右上角的 垂直三点菜单，然后单击“替换仪表板”。
• 单击“选择文件”以打开文件对话框，然后选择要导入的 .lvdash.json 文件。
• 单击“覆盖”以覆盖现有仪表板。

管理仪表板版本的最佳做法

若要启用协作和管理不同版本的仪表板，Databricks 建议使用以下步骤：

1. 将仪表板导出为 JSON 文件。 文件格式为 lvdash.json。
2. 将该文件添加到版本控制系统，例如 Git。
3. 编辑文件。 仪表板文件包括完整的查询语法和小组件设置。 可以直接编辑文本文件中的值，也可以将其上传回工作区并在 UI 中进行更改。
4. 保存该新文件。 如果在 UI 中进行了更改，请导出新文件。 使用版本控制系统跟踪仪表板更改和版本。
5. 更新现有仪表板。 从现有的草稿仪表板中：
   1. 单击右上角的 kebab 菜单，然后单击“替换仪表板”。
   2. 在“从文件替换仪表板”对话框中，单击“选择文件”。 然后单击“覆盖”。

使用 REST API 管理仪表板

有关演示如何使用 Azure Databricks REST API 管理仪表板的教程，请参阅使用 Azure Databricks API 管理仪表板。 包含的教程介绍如何将旧仪表板转换为 Lakeview 仪表板，以及如何创建、管理和共享它们。

若要了解如何使用 Databricks 资产捆绑包管理 AI/BI 仪表板，请参阅 仪表板。

Databricks 还提供 Terraform 提供程序。 请参阅 Databricks Terraform 文档。