创建和管理仪表板数据集

2025-09-01

本文介绍如何使用 AI/BI 仪表板中的数据集编辑器创建和管理仪表板数据集。

定义数据集

若要定义或访问现有数据集，请单击仪表板左上角附近的数据选项卡。每个仪表板最多可以定义 100 个数据集。

注释

仪表板查询是只读的。诸如DESCRIBE、EXPLAIN、CREATE TABLE或INSERTDELETE不支持定义数据集等命令。只有可以包装在其他 SQL 中的查询才有效。

定义数据集：

单击仪表板左上角的“ 数据 ”选项卡。
选择以下选项之一：
- 从 SQL 创建： 使用此选项可对任何数据源编写新的 SQL 查询。
- 添加数据源： 使用此选项可以选择基于数据集的 Unity 目录表或视图。对于大多数表和视图，数据集由默认 SELECT * 查询定义，可以对其进行修改以优化数据集。修改查询以删除或转换仪表板数据集中的可用字段。选择指标视图（公共预览版）作为数据源时，数据集会显示指标视图中定义的结果表和架构。请参阅 “使用指标视图 ”和 “创建指标”视图。
- 上传文件： 使用此选项可将新资产上传到 Unity 目录。使用文件上传对话框选择目录、架构和 表名称。可以设置特定的 SQL 仓库来处理与此上传关联的计算。还可以选择 创建新表 或 覆盖现有表。必须在所选架构上具有 MANAGE 特权才能覆盖掉现有表。

文件上传对话框。

从 SQL 创建数据集

可以定义从任何可用数据源拉取的数据集。在查询中，在查询本身中使用完全限定的表名称或从下拉列表选择器中选择目录和架构的组合以及查询中的表名称来标识数据源。查询中的完全限定表名将替代编辑器中的目录和架构选择器。如果表或列名称包含空格，请将这些标识符包装在 SQL 查询中的反引号中。

使用指标视图

可以通过选择指标视图作为数据源或在 SQL 查询中引用指标视图，在仪表板中使用指标视图。

选择指标视图作为数据源： 直接选择指标视图时，数据集包括所有定义的维度和度量值。不能修改数据集查询以排除列或应用筛选器。可以添加自定义计算，以创建其他度量值或维度进行可视化。请参阅什么是自定义计算？
在查询中引用指标视图： 可以像引用任何其他视图一样，在 SQL 查询中引用指标视图。如果要筛选或重塑数据集，请使用此方法。必须使用聚合函数访问 MEASURE 所有指标视图度量值。请参阅 measure 聚合函数。

若要在创作仪表板时创建新的指标视图，请参阅 “创建指标”视图。

管理数据集

定义数据集后，使用 Kebab 菜单图标。数据集名称右侧的 kebab 菜单可访问以下选项：

重命名： 为数据集提供描述性名称，以便你和你的团队可以快速识别要编辑或审阅的查询。
建议名称： 根据查询自动生成建议的名称。可以在生成此名称后对其进行编辑。
克隆：创建查询的就地副本。克隆查询后，可以对其进行编辑。
删除： 删除数据集。如果在画布上使用数据集，则此选项不可用。
下载： 可以将数据集下载为 CSV、TSV 或 Excel 文件。

注释

画布上当前使用的数据集以带有蓝色图标的粗体文本显示，而未使用的数据集具有灰色图标和非加粗名称。

查看结果表

创建数据集时，查询会自动运行，结果会在编辑器下方的窗格中显示为表。每列都包含一个指示其数据类型的图标。

对列值进行排序：

将鼠标悬停在每个列上以显示排序图标。
单击图标以升序或降序对值进行排序。

查看查询结果架构

若要查看已定义的数据集的架构，请单击 结果表右侧架构。架构选项卡列出定义数据集中的所有字段。每个字段都标有一个图表，表示列的数据类型。如果基础表或视图包含注释，它们将显示在架构选项卡中。

创建指标视图

重要

此功能目前以公共预览版提供。

指标视图将复杂的业务逻辑抽象化为集中式定义，使组织能够定义关键绩效指标一次，并在各种报告图面上一致地使用这些指标。请参阅 Unity 目录指标视图。可以从现有仪表板数据集创建指标视图，或使用助手帮助创建指标视图。如果已为现有数据集定义了度量值和维度，它们将自动显示在生成的指标视图定义中。

将数据集提升到指标视图

将数据集提升到指标视图：

单击烤肉串菜单要转换为指标视图的数据集右侧。
在 “创建指标视图 ”面板中，使用目录和架构下拉列表选择器选择存储指标视图的架构和目录。这会影响谁可以访问和使用指标视图。请参阅 Unity Catalog 特权和安全对象。
（可选）输入指标视图的名称。默认情况下，数据集标题根据命名要求转换为有效的指标视图名称。
（可选）通过调整 YAML 定义 部分中生成的内容来编辑指标视图。
单击“ 保存”。

注释

默认情况下，创建指标视图时会添加到仪表板。若要创建未添加到仪表板的指标视图，请关闭“创建指标视图”面板底部附近的“向仪表板添加指标视图”。

使用 Databricks 助手创建指标视图

使用 Databricks 助手创建新的指标视图：

单击数据集编辑器左侧栏中的。然后单击“ 导出到指标视图”。
输入要创建的指标视图的说明。
助手返回一个示例指标视图定义，并简要说明其中定义的维度和度量值。
单击“ 打开指标视图编辑器 ”编辑并保存指标视图。

有关如何创建指标视图的更多信息，请参阅 “创建指标视图”。

自定义计算

自定义计算提供了一种将计算应用于现有数据集的方法，而无需修改创建数据集的 SQL。若要详细了解如何创建和使用自定义计算，请参阅什么是自定义计算？

编写多语句查询

有时，你可能想要使用多个 SQL 语句构造数据集。若要运行多个语句，请使用分号结束每个语句（;）。运行这些命令来创建数据集时，输出会显示编辑器中最后一条语句的结果。此数据集用于画布上的任何相关可视化效果。

语句仅对发出它们的数据集有效。例如，如果使用 USE 语句创建数据集来设置目录或架构，该设置仅适用于该数据集。

例子

以下示例演示了多语句查询的常见用途。

设置目录与架构

可编写一条 USE 语句以声明查询中表的目录和架构。以下查询包含三条语句。第一条设置目录名称。第二个定义架构。由于已设置目录和架构，因此 SELECT 语句仅引用表名。请参阅 USE CATALOG。


USE CATALOG samples;
USE SCHEMA tpch;
SELECT * FROM customer;

设置 ANSI 模式

可以将查询设置为在 ANSI_MODE 设置为 TRUE 或 FALSE 的情况下运行。对于 Databricks SQL，ANSI_MODE 的系统默认值为 TRUE。请参阅 ANSI_MODE。

以下查询将 ANSI_MODE 设置为 FALSE，使无效的数据类型输入返回 NULL，而不是引发错误。

SET ANSI_MODE = FALSE;
SELECT cast('a' AS INTEGER);

将复杂查询参数化

可使用多条语句将公用表表达式或其他复杂查询的视图名称参数化。

以下查询创建两个临时视图。 SELECT 语句使用 IDENTIFIER 子句将输入字符串解释为表名。请参阅 IDENTIFIER 子句。

CREATE TEMPORARY VIEW v1 AS SELECT 1;
CREATE TEMPORARY VIEW v2 AS SELECT 2;
SELECT * FROM IDENTIFIER(:view_name)

设置变量

以下查询在第一条语句中声明一个变量和值。第二个语句更改变量的值。第三条语句会显示该变量的结束值为 5。有关使用临时变量的详细信息和完整语法，请参阅 SET 变量。

DECLARE VARIABLE myvar1 INT DEFAULT 7;
SET VAR myvar1 = 5;
VALUES (myvar1);

使用 SQL 限制数据访问

仪表板查看器可以访问数据集中的所有数据，即使它未显示在可视化效果中。若要防止在浏览器中公开敏感数据，请限制定义数据集的 SQL 查询中的列。例如，不要从表中选择所有列，而只包括可视化效果所需的特定字段。

共用方式為