将旧仪表板克隆到 AI/BI 仪表板

重要

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

本文介绍如何通过克隆现有旧版仪表板来创建新的草稿仪表板。 “克隆到 AI/BI 仪表板”是 UI 中的一个菜单选项，可用于简化转换过程。对于最多包含 100 个小组件的旧仪表板，支持“克隆到 AI/BI 仪表板”。

使用此按钮来创建新的仪表板不会影响原始旧版仪表板或查询。相反，此过程使用基础查询和小组件设置来创建等效仪表板。

注意

AI/BI 仪表板（以前是 Lakeview 仪表板）不支持所有旧版仪表板功能。请参阅仪表板，了解可用功能。

所需的权限

你必须至少拥有旧版仪表板和所有上游查询（包括支持基于查询的下拉列表参数的查询）的“可以查看”权限。旧版仪表板分别处理 Databricks SQL 查询和仪表板的权限。上游查询的权限不足会导致克隆操作失败。

以下动画演示了一次成功的转换。

显示转换过程的 Gif

完成以下步骤以克隆仪表板：

单击克隆到 AI/BI 仪表板。

可以从 UI 中的以下区域访问“克隆到 AI/BI 仪表板”选项：
- 工作区文件浏览器。
  
  右键单击仪表板标题，然后单击“克隆到 AI/BI 仪表板”。也可使用串形菜单访问相同的选项。
- 旧版仪表板。
  - 查看保存的仪表板时：在现有的旧版仪表板上，从串形菜单中，单击“克隆到 AI/BI 仪表板”。
  - 编辑保存的仪表板时：单击串形菜单，然后单击“克隆到 AI/BI”。
（可选）为新仪表板指定标题和文件夹位置。

默认情况下，将新仪表板保存在与原始旧版仪表板相同的文件夹中，并将 (AI/BI) 追加到原始标题。在此阶段，可以重新命名新仪表板并选择不同的目标文件夹。
单击“克隆”。

操作完成后，在屏幕右上角查找通知。使用该链接导航到新的仪表板。

成功的克隆操作会创建新的草稿仪表板。现有旧版仪表板和相关查询保持不变。这两个仪表板毫无关联，其中一个仪表板的更新不会影响另一个仪表板。

新的仪表板作为草稿创建。它继承在文件夹级别应用的任何共享权限。在源仪表板上设置的权限不会传播。

无论原始旧版仪表板中的现有凭据设置如何，都会向所有仪表板草稿自动授予“以查看者身份运行”凭据。发布仪表板时，可以选择是否嵌入凭据。这会影响其他用户查看仪表板以及与其交互的方式。请参阅 AI/BI 仪表板 ACL，了解如何共享和管理已发布的仪表板的权限。

AI/BI 仪表板为参数提供的支持有限。不支持以下参数类型：

所有受支持的参数类型都保留在新仪表板中。不受支持的参数类型默认为 string 值。以前设置的默认值都会保留。

在执行克隆操作期间，所有旧版仪表板级参数小组件都将转换为筛选器，并显示在新仪表板画布面板顶部。日期和时间参数小组件将添加为“日期选取器”筛选器，所有其他类型的参数小组件将转换为“单值”筛选器。

克隆包含带有参数的查询的仪表板时，克隆会成功创建目标查询，但需要调整查询来使用已命名参数语法，以便查询成功。你必须更新相关数据集查询中的语法，以清除参数筛选器小组件中显示的错误消息。右键单击小组件以打开并编辑连接的数据集查询。有关语法和示例，请参阅使用查询参数。

在“数据”选项卡上，打开要编辑的数据集。在转换时，旧版仪表板中使用的查询中的所有胡须参数 ({{ }}) 都会自动添加到 UI 中显示的参数集合中。

新转换的数据集查询，其中包含使用胡须语法编写的参数和警告消息。

AI/BI 仪表板并不支持旧版仪表板中提供的所有功能或图表类型。当克隆的旧版仪表板包含不受支持的元素时，新仪表板上的小组件会显示错误消息，而不是原始小组件的副本。通常，转换不受支持的可视化效果或筛选器时会出现错误。请参阅向画布添加页面、可视化效果、文本和筛选器，了解支持哪些可视化效果和筛选器。

请参阅仪表板可视化类型，了解如何使用仪表板中支持的图表类型。