仪表板

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

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

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

查看和整理仪表板

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

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

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

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

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

创建新的仪表板

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

删除仪表板

若要删除仪表板，请执行以下操作：

1. 打开草稿仪表板。

2. 单击 仪表板右上角的 kebab 菜单。 然后单击移动到回收站。

回收站文件夹的内容会在 30 天后自动永久删除。

还可以从工作区文件夹中的位置组织和删除仪表板。 请参阅 “删除对象”。

在仪表板上起草和协作

新仪表板作为草稿打开。 对草稿仪表板的更改会自动保存，但如果已经存在已发布版本，则不会自动与之同步。 有关发布仪表板的详细信息，请参阅 “发布仪表板”。

若要放弃编辑并将草稿还原到最近发布的版本，请单击“ 菜单，然后单击“ 放弃更改”。

您可以通过将草稿与工作区中的用户共享来协作完成。 具有访问权限的用户使用自己的凭据与仪表板交互。 不能与工作区外部的用户共享草稿仪表板。 有关权限级别的详细信息，请参阅 AI/BI 仪表板 ACL。

定义数据集

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

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

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

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

若要在数据集编辑器中设置查询格式，请在编辑器中右键单击并选择 设置文档格式。 若要自定义 SQL 查询的格式设置方式，请参阅 自定义格式 SQL 语句。

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

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

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

创建多页报表

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

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

添加和删除页面

要添加新页面：

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

要删除页面：

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

克隆页面

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

1. 单击页标题将其选中。

2. 单击标题区块中的 ，然后单击克隆。

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

可视化效果

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

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

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

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

生成预测

使用 AI 预测 （公共预览版）将预测预测应用于折线图，以可视化未来的趋势和模式。 折线图必须具有 x 轴上的时态日期字段和 y 轴上的单个数值字段。

通过 AI 预测功能创建图表：

• 选中折线图后，单击可视化编辑器的+”部分。
• 在出现的对话框中单击“使用 AI 预测克隆”。 创建新的折线图，并应用了预测。

可视化效果疑难解答

编辑数据集可能会导致以前配置的可视化效果显示错误消息。 删除或重命名数据集字段时，可能会发生这种情况。 如果可视化效果显示错误，请尝试以下作：

• 刷新仪表板。
• 单击可视化小组件上的 “显示错误 ”以查看可能有助于识别数据集中问题的详细错误消息。
• 查看用于生成与可视化效果关联的数据集的 SQL。
• 删除引用数据集的任何损坏的筛选器。
• 删除使用数据集的任何其他可视化效果。

文本小组件

Markdown 是用于在纯文本编辑器中设置文本格式的标记语言。 可以在文本小组件中使用 Markdown 设置文本格式、插入链接并将图像添加到仪表板。 有关基本 Markdown 语法的详细信息，请参阅 Markdown 指南。

向文本小组件添加图像

若要添加图像，请使用以下 Markdown 语法：

![Description](path-or-URL-to-image)

此语法包括感叹号（!），后跟括号（[ ]）中的描述性文本，以及括号( )（）中的图像路径或 URL。 可以使用卷路径、base64 编码的字符串或公开托管的 URL 在文本小组件中显示图像。 若要调整图像的大小，请调整小组件的宽度和高度。

使用以下方法之一指定图像源。

使用卷路径

使用以下格式，将占位符替换为 Azure Databricks 实例名称和卷中映像的路径：

https://<databricks-instance>/ajax-api/2.0/fs/files/<Volumes/path/to/image>

实例名称位于登录到 Azure Databricks 部署时显示的 URL 的第一部分。 某些部署包含工作区标识符。 构造路径时不要包含工作区 ID。 若要了解详细信息，请参阅 工作区实例名称、URL 和 ID。

若要查找卷路径，请按照以下步骤进行操作：

1. 在边栏中单击，然后单击目录以打开目录资源管理器。

2. 单击架构浏览器中的图像文件。

3. 单击 文件名旁边的 kebab 菜单，然后单击“ 复制路径”。

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

使用本地文件

若要使用本地文件，请先将其编码为 base64 字符串。 然后使用以下 Markdown 语法：

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

使用公开托管的映像

对于公开托管的图像，请插入指向图像的公共 URL。

![description](URL)

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

应用交叉筛选

浏览仪表板时，可能会注意到想要进一步调查的特定趋势或值。 通过交叉筛选，查看者可以通过直接与可视化效果交互来筛选仪表板数据。 这有助于浏览现有筛选器可能无法捕获的数据，并且有助于在不手动编辑筛选器控件的情况下浏览模式、离群值或特定段。

可以使用交叉筛选来：

• 通过选择一个或多个图表中的值来关注特定数据段。
• 通过单击聚合值深入查看分层数据。 例如，单击条形图中的年份可按该年份筛选其他可视化效果。 然后单击一个月或一周以继续缩小范围。

交叉筛选会自动应用于使用相同数据集的受支持可视化效果。

以下图表类型支持交叉筛选：

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

通过选择图表元素应用筛选器时，基于同一数据集的所有其他可视化效果都会自动更新以反映筛选的数据。

筛选相关的可视化效果

使用交叉过滤浏览数据：

1. 单击可视化中的数据点，例如条形图中的条形或热度地图中的单元格。

2. 仪表板应用基于所选值的筛选器。

共享相同数据集的所有其他可视化效果会相应地更新。

使用钻取来筛选数据

通过钻取可以构造报表，以便查看者可以单击特定数据段以打开按所选内容筛选的目标页面。 目标页面必须使用基于源可视化效果的数据集的筛选器。 当目标页打开时，筛选器会自动填充源可视化效果中的所选段。

以下图表类型支持钻取：

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

支持的钻取选择类型和筛选器类型

源图表必须包含与所应用筛选器中的数据类型匹配的数据类型。 例如，数值数据必须具有数值筛选器。

下表概述了兼容的选择类型和筛选器类型：

尚不支持以下钻取事例：

• 具有多个分类维度的多选择。
• 具有多个定量维度的多选择。
• 具有多个日期装箱临时值的多重选择。

使用钻取

若要将钻取设置为仪表板作者，请执行以下作：

1. 使用以下代码片段为示例可视化效果创建数据集。 将所有 行程命名为数据集。

   SELECT
     DATE(tpep_pickup_datetime) AS trip_date,
     HOUR(tpep_pickup_datetime) AS pickup_hour,
     COUNT(*) AS trip_count,
     ROUND(AVG(trip_distance), 2) AS avg_distance,
     ROUND(AVG(fare_amount), 2) AS avg_fare
   FROM samples.nyctaxi.trips
   GROUP BY trip_date, pickup_hour
   ORDER BY trip_date;
   
   

2. 在画布上，将默认页面命名为 “概述”。

3. 使用以下配置创建可视化效果。

   • 数据集： 所有行程
   • 可视化效果： 条形图
   • X 轴： DAILY（trip_date）
   • Y 轴： SUM（avg_fare）

4. 创建新页面并将其命名为 “详细信息”。

5. 单击 。创建筛选器并将其放置在页面顶部。

6. 将标题更改为 “行程日期”。

7. 使用配置面板设置以下值：

   • 筛选器： 日期范围选取器
   • 字段： 所有trips.trip_date

8. 使用以下配置创建可视化效果：

   • 数据集： 所有行程
   • 可视化效果： 表
   • 列：选择 “全部显示/隐藏”

若要以仪表板查看器的形式钻取到目标页面，请执行以下作：

1. 右键单击源图表中的数据段。

2. 单击“ 钻取”， 然后单击要访问的页面名称。

使用筛选器

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

复制小组件

使用键盘快捷方式复制所选小组件，并将其粘贴回画布上。 使用 Command-C （Mac） 或 Ctrl-C （Windows/Linux） 复制，使用 Command-V （Mac） 或 Ctrl-V （Windows/Linux） 进行粘贴。 创建新小组件后，可以像编辑任何其他小组件一样对其进行编辑。

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

1. 右键单击小组件。

2. 单击“克隆”。

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

删除小组件

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

下载结果

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

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

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

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

发布仪表板

发布仪表板可创建当前草稿的干净副本。 发布者的计算凭据嵌入在已发布的仪表板中，用于处理所有后续更新，而不考虑哪个用户或服务启动更新。 必须至少拥有“可编辑”权限才能发布仪表板。

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

已发布的仪表板未进行版本控制，且不应该用于版本控制。 可以将草稿仪表板还原回最新发布的版本。 请参阅在仪表板上起草和协作。

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

• 嵌入凭据（默认值）： 查看者使用发布者的数据权限运行查询。 这允许用户查看仪表板，即使他们无权直接访问基础数据。 这种情况可能会向尚未被授予直接访问权限的用户公开数据。 这是默认选项。
• 不要嵌入凭据： 查看者使用自己的凭据运行查询。 其数据权限确定他们可以看到的内容，并且必须有权访问基础数据才能查看结果。 对于有权访问仪表板工作区的用户，仪表板发布者的计算凭据用于处理更新。 没有工作区访问权限的用户没有访问运行仪表板查询或查看所呈现数据的计算所需的权限。

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

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

1. 打开一个仪表板。 如果仪表板以前已发布，则将打开已发布的版本。 如有必要，请使用页面顶部的切换器查看当前草稿版本。

2. 单击“发布” 。 此时将显示“发布”对话框。

3. 选择要用于已发布仪表板的凭据。 可以选择是否嵌入凭据。

4. 单击“发布” 。 如果仪表板首次发布，则会打开“共享”对话框，并提示你共享已发布的仪表板。 有关共享的详细信息和建议，请参阅共享仪表板。

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

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

使用 REST API 来发布和共享带有与服务主体关联的嵌入的凭据的仪表板。 使用服务主体的令牌运行 API 调用时，用户会基于服务主体的权限访问数据。 这样，用户无需直接数据或计算权限即可查看仪表板并运行查询。 用户必须注册到 Databricks 帐户。 有关使用 REST API 管理仪表板的详细信息，请参阅 REST API 参考中的 Lakeview。

下载已发布的仪表板

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

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

共享仪表板

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

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

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

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

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

计划和订阅

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

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

使用 Lakeflow Jobs 计划更新

可以将任务配置为定期更新现有的已发布仪表板。 若要详细了解如何使用 Lakeflow 作业协调工作流，请参阅 Lakeflow 作业。 若要了解如何配置仪表板任务，请参阅作业的仪表板任务。

导出、导入或替换仪表板

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

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

导出仪表板文件

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

导入仪表板文件

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

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

从文件替换仪表板

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

编辑仪表板文件

导出仪表板后生成的序列化 lvdash.json 文件包括完整的查询语法和小组件设置。 在某些情况下，例如编辑自动生成的页面或小组件 name 值，直接编辑此文件非常有用。

编辑自动生成的值页和小组件 ID 值：

1. 导出草稿仪表板并在文本编辑器中打开 .lvdash.json 该文件。

2. 编辑与页面和小组件关联的 name 值。 保存文件。

3. 将文件导入工作区并重新发布。

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

仪表板的源代码管理现在以公共预览版提供。 工作区管理员可以从 预览页面控制对公共预览版的工作区访问权限。 默认情况下， Git 文件夹预览中的支持仪表板 为 On。 请参阅 源代码管理仪表板。

如果无法启用公共预览版，建议的工作流如下所示：

1. 将仪表板导出为 JSON 文件。 文件格式为 lvdash.json。

2. 将该文件添加到版本控制系统，例如 Git。

3. 编辑 文件。 可以直接编辑文本文件中的值，也可以将其上传回工作区并在 UI 中进行更改。

4. 保存新文件。 如果在 UI 中进行了更改，请导出新文件。 使用版本控制系统跟踪仪表板更改和版本。

5. 更新现有仪表板。 在现有草稿仪表板中：

   1. 单击 右上角的 kebab 菜单，然后单击“ 替换仪表板”。
   2. 在“从文件替换仪表板”对话框中单击“选择文件”。 然后单击“覆盖”。

以编程方式管理仪表板

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

若要了解如何使用 Databricks 资产捆绑管理 AI/BI 仪表板，请参阅 仪表板。 有关定义仪表板的示例捆绑包，请参阅 捆绑包示例 GitHub 存储库。

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

后续步骤

• 与团队共享仪表板：控制访问权限并设置仪表板协作的权限级别。 请参阅共享仪表板。
• 计划自动更新：为已发布的仪表板设置自动刷新计划和电子邮件订阅。 请参阅管理计划的仪表板更新和订阅。
• 为仪表板创建数据集：生成和管理支持仪表板可视化效果的数据源。 请参阅 “创建和管理仪表板数据集”。
• 在应用程序中嵌入仪表板：使用 iframe 将已发布的仪表板集成到外部网站和应用程序中。 请参阅嵌入仪表板。
• 自动化仪表板工作流：使用 Lakeflow 作业来计划和安排仪表板更新。 请参阅 作业的仪表板任务。