通过

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

  • 项目

重要

  • Databricks 建议使用 AI/BI 仪表板（以前称为 Lakeview 仪表板）。
  • 原始 Databricks SQL 仪表板现在称为“旧版仪表板”。 它们将继续收到关键的缺陷修复，但不会进行新功能更新。 旧版仪表板预计将在 2025 年底终止。 Databricks 不建议创建新的旧版仪表板。

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

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

注意

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

所需的权限

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

克隆到 AI/BI 仪表板

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

显示转换过程的 Gif

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

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

    可以从 UI 中的以下区域访问“克隆到 AI/BI 仪表板”选项：

    • 工作区文件浏览器。

      右键单击仪表板标题，然后单击“克隆到 AI/BI 仪表板”。 也可使用 Kebab 菜单 串形菜单访问相同的选项。

    • 旧版仪表板。

      • 查看保存的仪表板时：在现有的旧版仪表板上，从 Kebab 菜单 串形菜单中，单击“克隆到 AI/BI 仪表板”。
      • 编辑保存的仪表板时：单击 Kebab 菜单 串形菜单，然后单击“克隆到 AI/BI”。

  2. （可选）为新仪表板指定标题和文件夹位置。

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

  3. 单击“克隆”。

    包含指向新仪表板链接的成功消息。

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

查看克隆的仪表板结果

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

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

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

调整旧版参数

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

  • 多值下拉列表
  • 日期范围

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

使用参数小组件

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

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

在数据集中使用参数

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

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

故障排除和手动调整

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

仪表板包括带有错误的小组件。

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