将旧仪表板克隆到 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，了解如何共享和管理已发布的仪表板的权限。

克隆包含具有参数的查询的仪表板时，必须将这些查询更新为使用命名参数语法。迁移工具会尝试自动进行此转换。若要手动更新语法，请右键单击小组件以打开和编辑查询。请参阅语法和示例的语法更改。

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

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

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

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

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