仪表板

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

重要

• Databricks 建议使用 AI/BI 仪表板（以前称为 Lakeview 仪表板）。 早期版本的仪表板（以前称为 Databricks SQL 仪表板）现在称为 旧仪表板。 Databricks 不建议创建新的旧版仪表板。
• 使用迁移工具或 REST API 转换旧版仪表板。 有关使用内置迁移工具的说明，请参阅将旧版仪表板克隆到 AI/BI 仪表板。 有关使用 REST API 创建和管理仪表板的教程，请参阅仪表板教程。

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

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

注意

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

查看和整理仪表板

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

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

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

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

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

创建新的仪表板

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

在仪表板上起草和协作

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

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

定义数据集

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

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

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

可以使用任何类型的表或视图定义数据集。 可以通过编写其他查询或选择其他表或视图来定义多个数据集。 定义数据集后，可以使用数据集名称右侧的 垂直三点菜单以重命名、克隆或删除它。 还可以将数据集下载为 CSV、TSV 或 Excel 文件。

使用 SQL 限制数据访问

仪表板数据集中的所有数据都可供仪表板查看者访问，即使它未显示在可视化效果中也是如此。 若要防止敏感数据被发送到浏览器，请限制在定义该数据集的 SQL 查询中指定的列。 例如，不从表中选择所有列，而是仅选择 SQL 语句（而非表配置）中可视化效果所需的特定列。

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

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

创建多页报表

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

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

添加和删除页面

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

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

删除页面：

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

注意

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

可视化效果

通过将可视化小组件添加到画布上的页面来创建可视化效果。 支持的可视化效果包括面积图、条形图、箱形图、组合图、计数器、热度地图、直方图、折线图、饼图、透视图、散点图和表格图表类型。

注意

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

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

• AI 辅助可视化效果：描述想要以自然语言查看的图表，让 Databricks 助手生成图表。 创建后，可以使用配置面板修改生成的图表。 不能使用助手创建表或数据透视表图表类型。
• 使用配置面板：在可视化配置中应用其他聚合或时间箱，而无需直接修改数据集。 可以选择数据集、x 轴值、y 轴值和颜色。 有关每个受支持的可视化类型的配置详细信息和示例，请参阅仪表板可视化类型。 请参阅表选项，了解如何在表可视化效果中控制数据呈现。

注意

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

文本小组件

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

向文本小组件添加图像

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

• 来自卷：

  <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 查询中定义的参数来筛选值。 使用基于查询的参数时，可以在单个小组件中组合使用字段筛选器和参数。 请参阅使用基于查询的参数，了解如何应用基于查询的参数。

注意

字段和参数上的筛选器仅影响与筛选器小组件位于同一页上的可视化效果。 筛选器应用于共享同一数据集的页面上的所有可视化效果。

设置默认筛选器值

刷新仪表板时不使用新的筛选器值来使用默认值。 若要设置默认值，请从 筛选器小组件的配置设置中的“默认值 ”下拉列表中选择一个值。

筛选器始终应用于整个数据集。 如果数据集较小，则筛选器将直接在浏览器中应用，以提高性能。 如果数据集较大，则会将筛选器添加到在 SQL 仓库中运行的查询。 请参阅数据集优化和缓存。

筛选字段

字段筛选器通过筛选特定数据集字段来优化可视化效果中呈现的数据。 例如，字段筛选器可能会根据数据集中的日期字段将数据限制到特定的日期范围。 筛选器可以应用于一个或多个数据集的字段。 若要将筛选器连接到多个数据集中的字段，请添加多个字段，每个数据集最多添加一个字段。 此筛选器适用于基于所选数据集构建的所有可视化效果。 为一个筛选器选择值时，它可以动态更改其他筛选器的下拉菜单中显示的可用值。 下图显示了一个筛选器配置面板，该面板设置为对两个字段进行筛选。

仪表板支持使用以下筛选器类型对字段进行筛选：

• 单值
• 多个值
• 日期选取器
• 日期范围选取器
• 文本输入
• 范围滑块

按参数筛选

与直接筛选数据字段的字段筛选器不同，参数筛选器会更改 SQL 查询本身，从而基于用户输入对查询进行动态调整。 筛选器可以应用于一个或多个参数。 若要将筛选器连接到多个参数，请在筛选器配置面板中添加多个参数。

对于接受在小组件中设置默认值的筛选器类型，默认值将替代“数据”选项卡上的查询编辑器中设置的默认值。如果筛选器连接到参数，则无论数据集大小如何，它都会针对 SQL 仓库运行查询。 请参阅使用仪表板参数。

仪表板支持使用以下筛选器类型对参数进行筛选：

• 单值
• 日期选取器

可以将参数值设置为接受以下数据类型之一：

• 字符串
• 日期
• 日期和时间
• Decimal
• Integer

注意

不支持使用参数指定日期范围。 若要选择日期范围，请对包含所需范围的开始日期和结束日期的字段应用筛选器。

已发布仪表板 URL 中的筛选器和参数

筛选器和参数选择存储在 URL 中。 用户可以为这些 URL 添加书签以保存仪表板的状态，包括所有筛选器和参数。 这样，仪表板的设置将保持不变，允许其他人在访问链接时使用相同的配置进行查看。

筛选器选择不存储为命名值。 而是转换为 URL 字符串中嵌入的唯一标识符。 这些标识符设置为 URL 中的值，允许将特定筛选器选择直接传递到 URL，以加载具有所选值的仪表板。

将值传递到 URL

以下示例显示了指向已发布仪表板的 URL。 若要创建类似的示例仪表板，请参阅 “创建仪表板”。

示例仪表板包括三个筛选器： 时间范围、 取件 Zip 和 Dropoff Zip。 在示例 URL 中，已选择所选 的“取件 ZIP ”值。

<databricks-instance>/dashboardsv3/<dashboard-id>/published?o=<workspace-id>&f_01ef60cd2a3c11818750488d57e7a1bb=10013

在 URL 的末尾，观察此示例中的筛选器标识符是字符串，该字符串 f_01ef60cd2a3c11818750488d57e7a1bb设置为值 10013。

在 URL 中指定相对日期范围值

选择特定日期值后，它们将显示在 URL 中。 还可以指定相对日期值，例如 过去 5 分钟 或 过去 12 小时。

以下示例显示了一个 URL，其中选择了“过去 12 小时”的相对时间。

<databricks-instance>/dashboardsv3/<dashboard-id>/published?o=<workspace-id>&f_01ef60cd29f81d1aacc19a7312fb10a4=now-12h

在 URL 的末尾，观察此示例中的筛选器标识符是字符串，该字符串 f_01ef60cd29f81d1aacc19a7312fb10a4设置为值 now-12h。

静态小组件筛选器

静态小组件筛选器直接在可视化小组件中配置，允许作者单独筛选共享相同数据集的可视化小组件。 这样，同一数据集就可以在画布上显示不同的视图。 已发布的仪表板查看器无法调整静态小组件筛选器的值。

将静态小组件筛选器添加到可视化效果：

1. 向草稿仪表板画布添加可视化小组件。

2. 选择新小组件后，从配置面板中的 “数据集”下拉列表中选择数据集 。

3. 单击“ 显示筛选器”。 “ 筛选器字段 ”选项显示在数据集标题下。 对于包含参数的数据集，还会显示“ 参数” 部分。

   

若要添加字段筛选器，请执行以下操作：

1. 单击筛选器字段标题右侧的加号，然后从下拉菜单中选择一个字段。
2. 默认情况下，筛选器值设置为“ 全部”。 使用下拉菜单选择新值。 导航离开下拉菜单以显示应用了新筛选器的可视化效果。
3. 查看你的仪表板。

静态小组件参数

使用参数，你可以在运行时将不同的值替换到数据集查询中。 请参阅 “使用仪表板参数 ”了解如何在查询中设置参数。

静态小组件参数直接在可视化效果小组件中配置，允许作者重用数据集，同时在不同的可视化效果小组件中呈现同一结果集的不同视图。 例如，考虑一个显示所有业务区域随时间变化的销售趋势的数据集。 若要比较区域 A 和区域 B 之间的趋势，可以创建两个引用相同数据集且具有相同图表类型的可视化效果。 通过向每个可视化效果添加一个参数并选择要显示的特定值，可以在仪表板上显示比较结果。 静态小组件参数是非交互式的，因此仪表板视图无法调整其值。

有关示例，请参阅静态小组件参数。

若要了解如何在筛选器小组件中设置参数，请参阅按参数筛选。

复制小组件

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

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

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

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

删除小组件

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

下载结果

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

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

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

发布仪表板

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

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

发布仪表板时，可以选择是否嵌入凭据。

重要

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

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

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

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

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

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

从仪表板启用 Genie 空间

重要

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

创建仪表板时，会自动为你创建草稿 Genie 空间。 Genie 空间是一个无代码接口，支持业务用户使用自然语言进行自助数据分析。 发布关联的 Genie 空间，此操作允许查看者以不同的方式浏览仪表板数据。 他们通过提出自己的问题，进行更深入的分析，进行数据交互，而不是仅基于仪表板上提供的信息来获取见解。 请参阅使用 AI/BI Genie 空间。

添加和删除数据集和可视化效果时，草稿 Genie 空间与草稿仪表板会保持同步。 发布之前，可以使用草稿 Genie 空间，来预览 Genie 空间并与其进行交互。

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

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

注意

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

发布仪表板时，此辅助 Genie 空间可供查看者使用。 这将添加一个“向 Genie 提问”按钮，该按钮链接到 Genie 空间的已发布副本，用户可以在其中提出后续问题。

若要控制 Genie 空间是否在已发布的仪表板上可用，请执行以下操作：

1. 单击“发布”。
2. “启用 Genie”开关默认处于打开状态。 单击开关可将其切换为打开或关闭。
3. 单击“发布”。

注意

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

共享仪表板

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

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

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

重要

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

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

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

计划和订阅

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

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

导出、导入或替换仪表板

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

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

导出仪表板文件

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

导入仪表板文件

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

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

从文件替换仪表板

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

使用 REST API 管理仪表板

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

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

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