可以使用仪表板生成数据可视化效果并与团队共享报表。 AI/BI 仪表板具有 AI 辅助的创作功能、增强的可视化库和简化的配置体验，使你可以快速将数据转换为可共享的见解。 发布后，可以与注册到 Azure Databricks 帐户的任何人共享仪表板，即使他们无权访问工作区也是如此。 请参阅共享仪表板。
重要
- Databricks 建议使用 AI/BI 仪表板（以前称为 Lakeview 仪表板）。 早期版本的仪表板，以前称为 Databricks SQL 仪表板，现在称为旧仪表板。 自 2025 年 4 月 7 日起，无法再创建或克隆新的旧仪表板。
- 使用迁移工具或 REST API 转换旧仪表板。
- 有关使用内置迁移工具的说明，请参阅将旧版仪表板克隆到 AI/BI 仪表板。
- 有关使用 API 迁移旧仪表板的说明，请参阅 迁移仪表板。
- 请参阅 REST API 参考中的 Migrate 仪表板 POST /api/2.0/lakeview/dashboards/migrate 终结点。
AI/BI 仪表板具有以下组件：
- 数据：“数据”选项卡允许用户定义要在仪表板中使用的数据集。 使用 UI 或 API 共享、导入或导出数据集时，数据集与仪表板捆绑在一起。
- 画布： “画布 ”选项卡可以组织成多页报表。 仪表板编辑器可以通过添加可视化效果、筛选器、文本和图像等小组件来生成和配置其仪表板。
注意
每个仪表板最多可以定义 100 个数据集。 画布最多可以包含 10 页。 仪表板可跨所有页面包含最多 100 个小组件。
查看和整理仪表板
可以从工作区浏览器和其他 Azure Databricks 对象访问仪表板。
单击边栏中的
“工作区”，从工作区浏览器查看仪表板。 默认情况下，仪表板存储在 /Workspace/Users/<username>目录中。 用户可将仪表板连同其他 Azure Databricks 对象一起组织到工作区浏览器的文件夹中。 请参阅工作区浏览器。若要查看仪表板列表页，请单击边栏中的
“仪表板”。默认情况下，仪表板列表页面按相反的时间顺序显示你有权访问的仪表板。 可以通过在搜索栏中输入标题来筛选列表、按时间段内上次修改进行筛选，或按所有者进行筛选。
点击仪表板标题以打开它。 如果之前已发布仪表板，则会打开已发布的版本。 否则，将打开草稿仪表板。
创建新的仪表板
若要从仪表板列表页创建新仪表板，请单击页面右上角附近的“创建”。
删除仪表板
若要删除仪表板，请执行以下操作：
- 打开草稿仪表板。
- 单击
仪表板右上角的 kebab 菜单。 然后单击移动到回收站。
回收站文件夹的内容会在 30 天后自动永久删除。
还可以从工作区文件夹中的位置对仪表板进行整理和删除。 请参阅 “删除对象”。
在仪表板上起草和协作
新仪表板作为草稿打开。 对草稿仪表板的更改会自动保存，但如果已经存在已发布版本，则不会自动与之同步。 有关发布仪表板的详细信息，请参阅 “发布仪表板”。
要放弃编辑并恢复草稿到最近发布的版本，请单击仪表板右上角的 kebab 菜单，然后单击“放弃更改”。
您可以通过将草稿与工作区中的用户共享来协作完成。 具有访问权限的用户使用自己的凭据与仪表板交互。 不能与工作区外部的用户共享草稿仪表板。 有关权限级别的详细信息，请参阅 AI/BI 仪表板 ACL。
定义数据集
使用“数据”选项卡定义仪表板的基础数据集。
可以将数据集定义为以下任意一种：
- 针对一个或多个表或视图的新查询。
- Unity Catalog 表或视图。
注意
每个数据集都由查询定义。 对于大多数表和视图，该数据集的默认查询是 SELECT * 表或视图上的语句。 可以修改查询以优化数据集。 对于指标视图，不能编辑视图定义。 但是，可以添加自定义计算（公共预览版），以可视化仪表板的新度量值和维度。 请参阅什么是自定义计算？
可以通过添加查询或选择其他表或视图来创建多个数据集。 若要调整数据集的显示顺序，请将其名称拖放到所需位置。
若要在数据集编辑器中设置查询格式，请在编辑器中右键单击并选择 设置文档格式。 若要自定义 SQL 查询的格式设置方式，请参阅 自定义格式 SQL 语句。
有关创建和管理仪表板数据集的更多详细信息，请参阅 创建和管理仪表板数据集。
向画布添加页面、可视化效果、文本和筛选器
使用“画布”选项卡构造仪表板。 画布最多可以包含十五页。 可以将可视化效果、文本和筛选器部件添加到每个页面。 使用多个页面来组织内容演示文稿、最小化滚动并提高仪表板可读性。 使用每个页面底部的工具栏添加小组件，如可视化效果、文本框和筛选器。
创建多页报表
新仪表板从名为 “无标题”页面的单页开始。 若要编辑页面的名称，请双击标题，并在文本字段中输入新名称。 命名冲突通过向标题追加数字自动解决。
若要查看页面上的内容，请单击标题将其选中。
添加和删除页面
若要添加新页面，请执行以下操作：
- 单击画布上当前页标题右侧的
。 默认情况下，新页面名为 “无标题”页。 - （可选）双击页面标题并输入新名称以重命名页面。
删除页面：
- 单击 页面标题右侧的“烤肉串”菜单。
- 单击“删除”以删除页面。
注意
删除页面也会删除该页面上的所有小组件。 如果删除所有页面，请单击“ 创建页面 ”以重新生成仪表板。
克隆页面
若要克隆页面，请执行以下步骤：
- 单击页标题将其选中。
- 单击标题磁贴中的 ，然后单击“克隆”。
新页面是原始页面的确切副本，包括所有小组件。 基础数据集保持不变。
可视化效果
在画布页面上添加可视化组件以生成可视化图形。 支持的可视化效果包括面积图、条形图、箱形图、组合图、计数器、热度地图、直方图、折线图、饼图、透视图、Sankey、散点图和表图类型。 关于可用可视化效果类型的完整列表和示例配置值，请参阅仪表板可视化效果类型。
注意
可视化效果使用的查询并不总是与数据集精确对应。 例如，如果将聚合应用于可视化效果，可视化效果将显示聚合值。
要创建可视化效果，请使用以下方法之一：
- AI 辅助的可视化效果：使用自然语言描述你想要查看的图表，然后要求 Databricks 助手生成图表。 创建后，可以使用配置面板修改生成的图表。 不能使用助手创建表或数据透视表图表类型。
- 使用配置面板：在可视化配置中应用其他聚合或时间箱，而无需直接修改数据集。 可以选择数据集、x 轴值、y 轴值和颜色。
若要详细了解如何将自定义格式设置应用于图表，请参阅仪表板可视化效果。 请参阅表选项，了解如何在表可视化效果中控制数据呈现。
注意
在可视化配置中应用时态转换时，可视化效果中显示的日期表示该时间段的开始。
生成预测
如果您的工作区中启用了AI 预测 （公开预览），则可以将预测分析应用于折线图，以可视化未来的趋势和模式。 折线图必须具有 x 轴上的时态日期字段和 y 轴上的单个数值字段。
通过 AI 预测功能创建图表：
- 选中折线图后，单击可视化编辑器的+”部分。
- 在出现的对话框中单击“使用 AI 预测进行克隆”。 创建新的折线图，并应用了预测。
若要详细了解生成预测的函数，请参阅 ai_forecast 函数。
可视化效果疑难解答
编辑数据集可能会导致以前配置的可视化效果显示错误消息。 删除或重命名数据集字段时，可能会发生这种情况。 如果可视化效果显示错误，请尝试以下作：
- 刷新仪表板。
- 单击可视化小组件上的 “显示错误 ”以查看可能有助于识别数据集中问题的详细错误消息。
- 查看用于生成与可视化效果关联的数据集的 SQL。
- 删除引用数据集的任何损坏的筛选器。
- 删除使用数据集的任何其他可视化效果。
文本小组件
Markdown 是用于在纯文本编辑器中设置文本格式的标记语言。 可以在文本小组件中使用 Markdown 设置文本格式、插入链接并将图像添加到仪表板。 有关基本 Markdown 语法的详细信息，请参阅 Markdown 指南。
向文本小部件添加图像
若要添加图像，请使用以下 Markdown 语法：
此语法包括感叹号（!），后跟括号（[ ]）中的描述性文本，以及括号( )（）中的图像路径或 URL。 可以在文本小组件中使用卷路径、Base64 编码字符串或公开托管的 URL 来显示图像。 要调整图像大小，请调整小组件的尺寸。
使用以下方法之一指定图像源。
使用卷路径
请使用以下格式，将占位符替换为在 Azure Databricks 中的实例名称以及卷中映像的路径：
https://<databricks-instance>/ajax-api/2.0/fs/files/<Volumes/path/to/image>
实例名称位于登录到 Azure Databricks 部署时显示的 URL 的第一部分。 某些部署包含一个工作区 ID。 构造路径时不要包含工作区 ID。 若要了解详细信息，请参阅 工作区实例名称、URL 和 ID。
要查找卷路径，请执行以下操作：
- 在边栏中单击
，然后单击目录以打开目录资源管理器。 - 单击架构浏览器中的图像文件。
- 单击 文件名旁边的 kebab 菜单，然后单击“ 复制路径”。
请参阅 什么是 Unity 目录卷？ 详细了解如何在卷中存储数据。
使用本地文件
若要使用本地文件，请先将其编码为 base64 字符串。 然后使用以下 Markdown 语法：
注意
如果您熟悉命令行实用工具，可以使用 base64 工具来转换您的文件。 或者，有许多可用于 base64 编码文件的免费联机资源。
使用公开托管的映像
对于公开托管的图像，请插入指向图像的公共 URL。
将示例文本替换为要显示的图像的描述和 URL。 例如，以下 markdown 将插入 Databricks 徽标的图像：。
注意
当你使用嵌入凭证发布仪表板时，观看者会使用你的凭证来访问所包含的图像。 如果仪表板未使用嵌入凭据发布，则必须显式授予对存储在 Azure Databricks 上的图像文件的用户的访问权限。 可使用目录资源管理器检查、授予和撤销对要包含的图像文件的权限。 单击边栏中的 “目录”以打开目录资源管理器 UI。
应用交叉筛选
浏览仪表板时，可能会注意到想要进一步调查的特定趋势或值。 尽管筛选器可能已经应用，但它们可能不会捕获每个查看器的兴趣。 通过交叉筛选，查看者可以通过直接与可视化效果交互来筛选仪表板数据。 这对于探索模式、离群值或特定段而无需手动调整筛选控件非常有用。
可以使用交叉筛选来：
- 通过选择一个或多个图表中的值来关注特定数据段。
- 通过单击聚合值深入查看分层数据。 例如，单击条形图中的年份可按该年份筛选其他可视化效果。 然后单击月份或周，以便继续缩小范围。
交叉筛选会自动应用于使用相同数据集的受支持可视化效果。
以下图表类型支持交叉筛选：
- 条形图
- 箱形图
- 热度地图
- 直方图
- 馅饼
- 散点图
- 点图
通过选择图表元素应用筛选器时，基于同一数据集的所有其他可视化效果都会自动更新以反映筛选的数据。
筛选相关可视化内容
使用交叉筛选功能探索数据：
- 在可视化图表中单击一个数据点，例如条形图中的一个条形或热力图中的一个单元格。
- 仪表板应用基于所选值的筛选器。
共享相同数据集的所有其他可视化效果会相应地更新。
使用筛选器
筛选器可以在全局范围内应用，也可以在单个页面上的小组件中应用。 它们可帮助仪表板查看者缩小结果范围，并优化可视化效果中的数据，类似于其他 BI 工具中的切片器。 可以将它们配置为基于一个或多个数据集列（也称为字段）或创建数据集的 SQL 查询中定义的参数来筛选值。 若要了解如何为仪表板上的可视化效果配置筛选器，请参阅 使用仪表板筛选器。
复制小组件
使用键盘快捷方式复制所选小组件，并将其粘贴回画布上。 使用 Command-C （Mac） 或 Ctrl-C （Windows/Linux） 复制，使用 Command-V （Mac） 或 Ctrl-V （Windows/Linux） 进行粘贴。 创建新小组件后，可以像编辑任何其他小组件一样对其进行编辑。
若要在草稿仪表板画布上克隆小组件，请完成以下步骤：
- 右键单击小组件。
- 单击“克隆”。
小组件的克隆将显示在原始小组件下方。
删除小组件
通过选择小组件并按下键盘上的 Delete 键来删除该小组件。 或者，右键单击小组件。 然后单击“删除”。
下载结果
可以将数据集下载为 CSV、TSV 或 Excel 文件。 可以将画布上的可视化效果下载为 PNG 文件。
- 若要从“画布”选项卡打开下载选项，请单击小组件右上角的 三点菜单。
- 若要从 “数据 ”选项卡打开下载选项，请单击 数据集右侧的“烤肉串”菜单。
可以以 CSV 和 TSV 格式下载最多约 1GB 的结果数据，并将最多 100,000 行数据下载到 Excel 文件中。 最终文件下载大小可能略大于或小于 1 GB，因为 1 GB 限制应用于最终文件下载之前的步骤。
若要了解如何将已发布的仪表板下载为 PDF，请参阅 下载已发布的仪表板。
发布仪表板
发布仪表板可创建当前草稿的干净副本。 发布者的计算凭据嵌入在已发布的仪表板中，用于处理所有后续更新，而不考虑哪个用户或服务启动更新。 必须至少拥有 CAN EDIT 权限才能发布仪表板。
发布后，即使对草稿进行更改，发布版本仍保持不变，直到再次发布。 可以继续在草稿版本中进行修改和改进，而不会影响已发布的副本。 具有访问权限的注册用户可以查看已发布的版本，如果存在，它将继续通过电子邮件发送给订阅者。 有关管理仪表板访问的详细信息，请参阅共享仪表板。
已发布的仪表板未进行版本控制，且不应该用于版本控制。 可以将草稿仪表板还原回最新发布的版本。 请参阅在仪表板上起草和协作。
发布时，请选择以下选项之一：
- 嵌入凭据（默认值）： 查看者使用发布者的数据权限运行查询。 这允许用户查看仪表板，即使他们无权直接访问基础数据。 这种情况可能会向尚未被授予直接访问权限的用户公开数据。 这是默认选项。
- 不要嵌入凭据： 查看者使用自己的凭据运行查询。 其数据权限确定他们可以看到的内容，并且必须有权访问基础数据才能查看结果。 对于有权访问仪表板工作区的用户，仪表板发布者的计算凭据用于处理更新。 没有工作区访问权限的用户没有访问运行仪表板查询或查看所呈现数据的计算所需的权限。
注意
无论凭据设置如何，所有仪表板查看器都必须进行身份验证才能访问仪表板。 若要更改凭据设置，请使用更新的选择重新发布仪表板。
请参阅共享已发布的仪表板，获取有关选择哪个设置的建议。
要发布仪表板，请完成以下步骤：
- 打开一个控制面板。 如果仪表板以前已发布，则将打开已发布的版本。 如有必要，请使用页面顶部的切换器查看当前草稿版本。
- 单击“发布” 。 此时将显示“发布”对话框。
- 选择已发布仪表板使用的凭据。 可以选择是否嵌入凭据。
- 单击“发布” 。 如果仪表板首次发布，则会打开“共享”对话框，并提示你共享已发布的仪表板。 有关共享的详细信息和建议，请参阅共享仪表板。
若要访问已发布的仪表板，请单击仪表板顶部附近的下拉菜单中的“已发布”。
使用服务主体发布和共享仪表板
使用 REST API 来发布和共享带有与服务主体关联的嵌入的凭据的仪表板。 使用服务主体的令牌运行 API 调用时，用户会基于服务主体的权限访问数据。 这样，用户无需直接数据或计算权限即可查看仪表板并运行查询。 用户必须注册到 Databricks 帐户。 有关使用 REST API 管理仪表板的详细信息，请参阅 REST API 参考中的 Lakeview。
下载已发布仪表板
加载已发布的仪表板后，使用以下步骤将其下载为 PDF：
- 单击“ 位于仪表板右上角附近。
- 单击“以 PDF 格式下载”。
从仪表板启用 Genie 空间
重要
此功能目前以公共预览版提供。
当你创建仪表板时，系统会自动为你创建一个 Genie 空间。 Genie 空间是一个无代码接口，支持业务用户使用自然语言进行自助数据分析。 自动创建的 Genie 空间最初处于草稿状态，你可以使用它来预览该空间。 添加和删除数据集和可视化效果时，草稿 Genie 空间与草稿仪表板会保持同步。
发布仪表板时，可以选择发布关联的草稿 Genie 空间，或链接到现有的 Genie 空间。
发布与仪表板关联的 Genie 空间允许查看者以不同的方式浏览仪表板数据。 查看者可通过提出自己的问题与数据互动来进行更深入的分析，而不是仅基于仪表板上提供的信息获取见解。 请参阅什么是 AI/BI Genie 空间。
发布 Genie 空间会在已发布的仪表板上添加一个“询问 Genie”按钮。 当仪表板查看器单击该按钮时，仪表板上将打开聊天界面，并提示用户询问有关数据的问题。
要发布关联的 Genie 空间，请使用以下步骤：
- 单击“发布” 。
- “启用 Genie”开关默认处于打开状态。 单击该切换开关可将其打开。
- （可选）若要链接现有 Genie 空间，请选择“链接现有 Genie 空间”单选按钮并粘贴关联 URL。 如果未选择此选项，则会基于仪表板自动为你生成新的 Genie 空间。
- 在“发布”对话框中单击“发布”。
注意
草稿和已发布的 Genie 空间相互独立，就像仪表板草稿版和已发布版本一样。 只有在重新发布仪表板时，对草稿仪表板所做的任何更改才会反映在已发布的Genie空间中。 草稿和已发布的 Genie 空间是仪表板的伴生组件。 它们不会显示在文件浏览器或 Genie 页面中。
若要在新窗口中打开已发布的 Genie 空间：
- 单击 聊天窗口右上角的烤肉串菜单
- 单击“ 打开 Genie 空间”。
若要预览 Genie 空间草稿，请执行以下操作：
- 单击 仪表板右上角的 kebab 菜单。
- 单击“打开草稿 Genie 空间”。
注意
无法通过 Genie 空间 UI 来编辑此 Genie 空间的指令。 只有当您对草稿仪表板进行更改时，草稿的Genie空间才会发生变化。
向 Genie 询问特定图表
若要向 Genie 咨询有关特定仪表板图表的问题，请执行以下操作：
- 在已启用 Genie 的已发布仪表板中单击“询问 Genie”。
- 单击仪表板上的图表以选择它。 Genie 在聊天窗口中显示所选图表标题。
- 询问有关所选图表中表示的数据的问题。
对链接 Genie 空间的权限
关联的 Genie 空间权限与仪表板上的权限一致，但仅限具有工作区访问权限的用户访问。 即使仪表板与嵌入凭据共享，也只有拥有工作区访问权限的用户能够与 Genie 空间交互。
查看者可使用自己的凭据访问为 Genie 空间提供支持所需的计算和数据。 查看者对在 Genie 空间中使用的表必须至少具有 SELECT 权限。
共享仪表板
可以安全地与帐户中的任何人共享仪表板。 对于分配给自己工作区的用户，你可以授予访问权限并设置不同的权限级别，就像对待其他工作区对象那样。 对于未分配到自己工作区的用户，你可以在帐户级别上共享仪表板，允许已注册的用户查看和运行仪表板。
有关如何在帐户级别设置帐户以便共享的详细信息，请参阅 AI/BI 管理指南。 有关在帐户和工作区级别共享仪表板的详细信息，请参阅共享仪表板。
在网站和应用程序中嵌入仪表板
可以使用 iframe 将已发布的仪表板嵌入到外部网站和应用程序中。 请参阅嵌入仪表板。
如果你是工作区管理员，想要管理可嵌入仪表板的外部站点，请参阅管理仪表板嵌入。
计划和订阅
可以设置计划更新以自动刷新仪表板的缓存，并可选择向订阅该计划的用户发送包含最新仪表板 PDF 的电子邮件。 具有至少“可编辑”权限的用户可以创建计划，让使用嵌入凭据的已发布仪表板能定期运行。 每个仪表板最多可以有 10 个计划。
请参阅管理计划的仪表板更新和订阅。
使用 Lakeflow 作业计划更新
可以将任务配置为定期更新现有的已发布仪表板。 若要详细了解如何使用 Lakeflow 作业协调工作流，请参阅 Lakeflow 作业。 若要了解如何配置仪表板任务，请参阅作业的仪表板任务。
注意
使用仪表板 UI 或 API 创建的计划和订阅者列表不同于与作业关联的计划和自动化。 请参阅 利用计划和触发器自动化作业。
导出、导入或替换仪表板
为了便于在不同工作区之间共享可编辑的仪表板，可以将仪表板作为文件进行导出和导入操作。 要将仪表板传输到其他工作区，请将其导出为文件，然后将其导入新工作区。 还可以就地替换仪表板文件。 这意味着，当您直接编辑仪表板文件时，可以将该文件上传到原始工作区，并覆盖现有文件，同时保持现有的共享设置不变。
以下部分说明如何在 UI 中导出和导入仪表板。 还可以使用 Databricks API 以编程方式导入和导出仪表板。 请参阅 POST /api/2.0/workspace/import。
导出仪表板文件
- 在草稿仪表板中，单击屏幕右上角的 垂直三点菜单，然后单击“导出仪表板”。
- 使用“导出仪表板”对话框确认或取消操作。 导出成功后，
.lvdash.json文件将保存到 Web 浏览器的默认下载目录。
导入仪表板文件
- 在仪表板列表页面中，单击
>“从文件导入仪表板”。 - 单击“选择文件”以打开本地文件对话框，然后选择要导入的
.lvdash.json文件。 - 单击“导入仪表板”以确认并创建仪表板。
导入的仪表板将保存到你的用户文件夹。 如果与导入的仪表板同名的项已在该位置中存在，则会通过追加带括号的数字来创建唯一名称，从而自动解决冲突。
从文件替换仪表板
- 在草稿仪表板中，单击屏幕右上角的 垂直三点菜单，然后单击“替换仪表板”。
- 单击“选择文件”以打开文件对话框，然后选择要导入的
.lvdash.json文件。 - 单击“覆盖”以覆盖现有仪表板。
编辑仪表板文件
导出仪表板后生成的序列化 lvdash.json 文件包括完整的查询语法和小组件设置。 在某些情况下，例如编辑自动生成的页面或小组件 name 值，直接编辑此文件非常有用。
编辑自动生成的值页和小组件 ID 值：
- 导出草稿仪表板并在文本编辑器中打开
.lvdash.json该文件。 - 编辑与页面和小组件关联的
name值。 保存文件。 - 将文件导入工作区并重新发布。
注意
name JSON 文件中的值与displayName字段分开，该字段定义 UI 中显示的页面名称。
管理仪表板版本的最佳做法
仪表板的源代码管理现在以公共预览版提供。 工作区管理员可以从 预览页面控制对公共预览版的工作区访问权限。 默认情况下， Git 文件夹预览中的支持仪表板 为 On。 请参阅 源代码管理仪表板。
如果无法启用公共预览版，建议的工作流如下所示：
- 将仪表板导出为 JSON 文件。 文件格式为
lvdash.json。 - 将该文件添加到版本控制系统，例如 Git。
- 编辑文件。 可以直接编辑文本文件中的值，也可以将其上传回工作区并在 UI 中进行更改。
- 保存该新文件。 如果在 UI 中进行了更改，请导出新文件。 使用版本控制系统跟踪仪表板更改和版本。
- 更新现有仪表板。 在现有的草稿仪表板中：
- 单击 右上角的 kebab 菜单，然后单击“ 替换仪表板”。
- 在“从文件替换仪表板”对话框中，单击“选择文件”。 然后单击“覆盖”。
- 单击
以编程方式管理仪表板
有关演示如何使用 Azure Databricks REST API 管理仪表板的教程，请参阅使用 Azure Databricks API 管理仪表板。 包含的教程介绍如何将旧版仪表板转换为 Lakeview 仪表板，以及如何创建、管理和共享它们。
若要了解如何使用 Databricks 资产捆绑管理 AI/BI 仪表板，请参阅 仪表板。 有关定义仪表板的示例捆绑包，请参阅 捆绑包示例 GitHub 存储库。
Databricks 还提供 Terraform 提供程序。 请参阅 Databricks Terraform 文档。