仪表板
可以使用仪表板生成数据可视化，并与团队共享详细的数据见解。 AI/BI 仪表板具有 AI 辅助的创作功能、增强的可视化库和简化的配置体验，使你可以快速将数据转换为可共享的见解。 发布后，可以与注册到 Azure Databricks 帐户的任何人共享仪表板，即使他们无权访问工作区也是如此。 请参阅共享仪表板。
注意
AI/BI 仪表板（以前是 Lakeview 仪表板）现已正式发布。
- 原始 Databricks SQL 仪表板现在称为“旧版仪表板”。 它们将继续得到支持并通过关键的 bug 修复进行更新，但新功能将受到限制。 你可以继续使用旧版仪表板进行创作和消耗。
- 使用迁移工具或 REST API 转换旧版仪表板。 有关使用内置迁移工具的说明，请参阅将旧版仪表板克隆到 Lakeview 仪表板。 有关使用 REST API 创建和管理仪表板的教程，请参阅仪表板教程。
AI/BI 仪表板具有以下组件：
- 数据：“数据”选项卡允许用户定义要在仪表板中使用的数据集。 使用 UI 或 API 共享、导入或导出数据集时，数据集与仪表板捆绑在一起。
- 画布：“画布”选项卡允许用户创建可视化效果并构造其仪表板。 画布包含多个小组件，你可将它们配置为显示可视化效果、筛选器、文本或图像。
注意
每个仪表板最多可以定义 100 个数据集。 “画布”对于每个仪表板最多可包含 100 个小组件。
查看和整理仪表板
可以从工作区浏览器和其他 Azure Databricks 对象访问仪表板。
单击边栏中的
“工作区”，从工作区浏览器查看仪表板。 默认情况下，仪表板存储在 /Workspace/Users/<username>目录中。 用户可将仪表板连同其他 Azure Databricks 对象一起组织到工作区浏览器的文件夹中。 请参阅工作区浏览器。若要查看仪表板列表页，请单击边栏中的
“仪表板”。默认情况下，仪表板列表页面按相反的时间顺序显示你有权访问的仪表板。 可以通过在搜索栏中输入标题来筛选列表、按时间段内上次修改进行筛选，或按所有者进行筛选。
单击仪表板标题以打开仪表板。 如果之前已发布仪表板，则将打开已发布的版本。 否则，将打开草稿仪表板。
创建新的仪表板
若要从仪表板列表页创建新仪表板，请单击页面右上角附近的“创建”。
在仪表板上起草和协作
新仪表板从草稿开始。 可以与工作区中的其他用户共享草稿以进行协作。 不得将草稿仪表板与相应工作区之外的用户共享。 所有用户都使用自己的凭据与仪表板草稿中的数据和可视化效果进行交互。
有关权限级别的详细信息，请参阅 AI/BI 仪表板 ACL。
定义数据集
使用“数据”选项卡定义仪表板的基础数据集。
可以将数据集定义为以下任意一种：
- 针对一个或多个表或视图的新查询。
- 现有的 Unity Catalog 表或视图。
可以在任何类型的表或视图中定义数据集。 可以通过编写其他查询或选择其他表或视图来定义多个数据集。 定义数据集后，可以使用数据集名称右侧的 
垂直三点菜单以重命名、克隆或删除它。 还可以将数据集下载为 CSV、TSV 或 Excel 文件。
使用 SQL 限制数据访问
仪表板数据集中的所有数据都可供仪表板查看者访问，即使它未显示在可视化效果中也是如此。 若要防止敏感数据被发送到浏览器，请限制在定义该数据集的 SQL 查询中指定的列。 例如，不从表中选择所有列，而是仅选择 SQL 语句（而非表配置）中可视化效果所需的特定列。
在画布上添加或删除可视化效果、文本和筛选小组件
使用“画布”选项卡构造仪表板。 使用画布底部的工具栏添加小组件，如可视化效果、文本框和筛选器。
可视化效果
通过将可视化小组件添加到画布来创建可视化效果。 支持的可视化效果包括区域、条形图、组合图、计数器、热度地图、直方图、折线图、饼图、透视图、散点图和表格图表类型。
注意
可视化效果使用的查询并不总是与数据集精确对应。 例如，如果将聚合应用于可视化效果，可视化效果将显示聚合值。
要创建可视化效果，请使用以下方法之一：
- AI 辅助的可视化效果：用自然语言描述你想要查看的图表，并让 Databricks 助手生成图表。 创建后，可以使用配置面板修改生成的图表。 不能使用助手创建表或数据透视表图表类型。
- 使用配置面板：在可视化配置中应用其他聚合或时间箱，而无需直接修改数据集。 可以选择数据集、x 轴值、y 轴值和颜色。 有关每个受支持的可视化类型的配置详细信息和示例，请参阅仪表板可视化类型。 请参阅表选项，了解如何在表可视化效果中控制数据呈现。
注意
在可视化配置中应用时态转换时，可视化效果中显示的日期表示该时间段的开始。
静态小组件参数
使用参数，你可以在运行时将不同的值替换到数据集查询中。 要了解如何在查询中设置参数，请参阅使用仪表板参数。
静态小组件参数直接在可视化效果小组件中配置，允许作者重用数据集，同时在不同的可视化效果小组件中呈现同一结果集的不同视图。 例如，考虑一个显示所有业务区域随时间变化的销售趋势的数据集。 若要比较区域 A 和区域 B 之间的趋势，可以创建两个引用相同数据集且具有相同图表类型的可视化效果。 通过向每个可视化效果添加一个参数并选择要显示的特定值，可以在仪表板上显示比较结果。 静态小组件参数是非交互式的，因此仪表板视图无法调整其值。
有关示例，请参阅静态小组件参数。
若要了解如何在筛选器小组件中设置参数，请参阅按参数筛选。
文本小组件
Markdown 是用于在纯文本编辑器中设置文本格式的标记语言。 可以在文本小组件中使用 Markdown 设置文本格式、插入链接并将图像添加到仪表板。
- 要在文本小组件中添加静态图像，请从公开的 URL 添加带有所需说明和 URL
的 Markdown 图像语法。 例如，以下 markdown 将插入 Databricks 徽标的图像：。 若要调整图像大小，请调整小组件尺寸的大小。 - 若要从 DBFS 添加图像，请添加带有所需说明和 FileStore 路径的 markdown 图像语法：
。 若要调整图像大小，请调整小组件尺寸的大小。 有关 DBFS 的详细信息，请参阅什么是 DBFS？。
有关 Markdown 语法的详细信息，请参阅本指南。
筛选器
筛选器是仪表板小组件，可帮助查看者缩小结果范围并优化可视化效果中的数据，其类似于其他 BI 工具中的切片器。 可以将它们配置为基于一个或多个数据集列（也称为字段）或创建数据集的 SQL 查询中定义的参数来筛选值。 使用基于查询的参数时，可以在单个小组件中组合使用字段筛选器和参数。 请参阅使用基于查询的参数，了解如何应用基于查询的参数。
设置默认值
可以在小组件中为大多数筛选器类型设置默认值，如以下筛选器类型列表中所示。 为此，请从筛选器小组件的配置设置的“默认值”下拉列表中选择一个值。 筛选器始终应用于整个数据集。 如果数据集较小，则筛选器将直接在浏览器中应用，以提高性能。 如果数据集较大，则会将筛选器添加到在 SQL 仓库中运行的查询。 请参阅数据集优化和缓存。
筛选字段
字段筛选器通过筛选特定数据集字段来优化可视化效果中呈现的数据。 例如，字段筛选器可能会根据数据集中的日期字段将数据限制到特定的日期范围。 筛选器可以应用于一个或多个数据集的字段。 若要将筛选器连接到多个数据集中的字段，请添加多个字段，每个数据集最多添加一个字段。 此筛选器适用于基于所选数据集构建的所有可视化效果。 为一个筛选器选择值时，它可以动态更改其他筛选器的下拉菜单中显示的可用值。 下图显示了一个筛选器配置面板，该面板设置为对两个字段进行筛选。
仪表板支持使用以下筛选器类型对字段进行筛选：
- 单值
- 多个值
- 日期选取器
- 日期范围选取器
- 文本输入
- 范围滑块（不接受默认值）
按参数筛选
与直接筛选数据字段的字段筛选器不同，参数筛选器会更改 SQL 查询本身，从而基于用户输入对查询进行动态调整。 筛选器可以应用于一个或多个参数。 若要将筛选器连接到多个参数，请在筛选器配置面板中添加多个参数。
对于接受在小组件中设置默认值的筛选器类型，默认值将替代“数据”选项卡上的查询编辑器中设置的默认值。如果筛选器连接到参数，则无论数据集大小如何，它都会针对 SQL 仓库运行查询。 请参阅使用仪表板参数。
仪表板支持使用以下筛选器类型对参数进行筛选：
- 单值
- 日期选取器
可以将参数值设置为接受以下数据类型之一：
- 字符串
- 日期
- 日期和时间
- Decimal
- Integer
注意
不支持使用参数指定日期范围。 若要指定日期范围，请对包含所需范围的开始日期和结束日期的字段应用筛选器。
在已发布的仪表板 URL 中的筛选器和参数
筛选器和参数选择存储在 URL 中。 用户可以为这些 URL 添加书签以保存仪表板的状态，包括所有筛选器和参数。 这样，仪表板的设置将保持不变，允许其他人在访问链接时使用相同的配置进行查看。
复制小组件
使用键盘快捷方式复制所选小组件，并将其粘贴回画布上。 创建新小组件后，可以像编辑任何其他小组件一样对其进行编辑。
若要在草稿仪表板画布上克隆小组件，请完成以下步骤：
- 右键单击小组件。
- 单击“克隆”。
小组件的克隆显示在原始小组件下方。
删除小组件
通过选择小组件并按键盘上的删除键来删除小组件。 或者右键单击小组件。 然后单击“删除”。
交叉筛选
交叉筛选让用户可以向下钻取到所选数据子集，也能以交互方式浏览多个可视化效果之间的关系和模式。 当仪表板查看者单击一个图表中的一个元素时，基于同一数据集的所有其他图表都会根据该值自动筛选。
作为仪表板编辑者，请通过创建共享同一数据集的两个或多个图表来设置交叉筛选。 以下图表类型支持查看者通过单击图表元素来筛选数据集：
- 条形图
- 热度地图
- 饼图
- 散点图
选择后，基于同一数据集的所有其他可视化效果都将使用筛选的值自动更新。
下载结果
可以将数据集下载为 CSV、TSV 或 Excel 文件。 可以将画布上的可视化效果下载为 PNG 文件。
- 若要从“画布”选项卡打开下载选项，请单击小组件右上角的 三点菜单。
- 若要从“数据”选项卡打开下载选项，请单击数据集右侧的 三点菜单。
可以以 CSV 和 TSV 格式下载最多约 1GB 的结果数据，并将最多 100,000 行数据下载到 Excel 文件中。 最终文件下载大小可能略大于或小于 1 GB，因为 1 GB 限制应用于最终文件下载之前的步骤。
发布仪表板
发布仪表板以创建当前草稿的干净副本。 必须至少拥有“可编辑”权限才能发布仪表板。
发布仪表板后，即使对草稿进行更改，已发布的版本也会保持不变，直到再次发布。 可以继续在草稿版本中进行修改和改进，而不会影响已发布的副本。 任何可访问已发布仪表板的已注册用户都可以继续查看已发布版本。 如果存在，已发布的版本将继续通过电子邮件发送给订阅者。 有关管理仪表板访问的详细信息，请参阅共享仪表板。
发布仪表板时，可以选择是否嵌入凭据。
重要
已发布的仪表板未进行版本控制，且不应该用于版本控制。 无法将草稿仪表板还原回以前发布的状态。
- 嵌入凭据：已发布仪表板的所有查看者都可以使用数据和计算凭据运行查询。 这样，即使用户无权访问原始工作区、基础数据或 SQL 仓库，也可以查看仪表板。 这种情况可能会向尚未被授予直接访问权限的用户公开数据。 这是默认选项。
- 不嵌入凭据：已发布仪表板的所有观看者都使用自己的数据和计算凭据运行查询。 若要在仪表板中查看结果，查看者需要访问工作区、附加的 SQL 仓库和关联数据。
有关要选择的设置的建议，请参阅共享已发布的仪表板。
要发布仪表板，请完成以下步骤：
- 打开一个仪表板。 如果仪表板以前已发布，则将打开已发布的版本。 如有必要，请使用页面顶部的切换器查看当前草稿版本。
- 单击“发布” 。 此时将显示“发布”对话框。
- 选择要用于已发布仪表板的凭据。 可以选择是否嵌入凭据。
- 单击“发布” 。 如果仪表板首次发布，则会打开“共享”对话框，并提示你共享已发布的仪表板。 有关共享的详细信息和建议，请参阅共享仪表板。
若要访问已发布的仪表板，请单击仪表板顶部附近的下拉菜单中的“已发布”。
共享仪表板
可以安全地与帐户中的任何人共享仪表板。 对于分配给自己工作区的用户，你可以授予访问权限并设置不同的权限级别，就像对待其他工作区对象那样。 对于未分配到自己工作区的用户，你可以在帐户级别上共享仪表板，允许已注册的用户查看和运行仪表板。
有关管理员如何在帐户级别设置帐户以便共享的详细信息，请参阅仪表板管理指南。 有关在帐户和工作区级别共享仪表板的详细信息，请参阅共享仪表板。
嵌入仪表板
重要
此功能目前以公共预览版提供。
可以使用 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 仪表板，以及如何创建、管理和共享它们。
还可以使用 Terraform 管理仪表板。 有关详细信息，请参阅 Databricks Terraform 文档。