创建您的第一个仪表板

本节重点介绍面向最终用户的文档，这些用户将使用 Superset 进行数据分析和探索工作流（数据分析师、业务分析师、数据科学家等）。

提示

除了本网站，Preset.io 在 docs.preset.io 维护一套更新的最终用户文档。

本教程面向希望在 Superset 中创建图表和仪表板的用户。我们将向您展示如何将 Superset 连接到新数据库并配置该数据库中的表进行分析。您还将探索您公开的数据并将可视化添加到仪表板，以便您体验端到端的用户体验。

连接到新数据库

Superset 本身没有存储层来存储您的数据，而是与您现有的支持 SQL 的数据库或数据存储配对。

首先，我们需要将连接凭据添加到您的数据库，以便能够从中查询和可视化数据。如果您通过 Docker Compose 在本地使用 Superset，则可以跳过此步骤，因为 Superset 中已包含并预配置了一个名为 examples 的 Postgres 数据库。

在右上角的 + 菜单下，选择“数据”，然后选择“连接数据库”选项

然后在弹出的模态框中选择您的数据库类型

选择数据库后，您可以在此窗口中配置许多高级选项，或者为了本教程的目的，您可以单击所有这些字段下方的链接

请注意，如果您尝试连接到另一个本地运行的数据库（无论是在主机还是另一个容器上），并且收到消息 端口已关闭。，则需要将 HOST 调整为 host.docker.internal

单击该链接后，您只需指定两件事（数据库名称和 SQLAlchemy URI）

如表单下方的文本所示，您应该参考 SQLAlchemy 文档中关于 为您的目标数据库创建新的连接 URI 的内容。

点击 测试连接 按钮以确认一切正常。如果连接良好，请点击模态窗口右下角的 连接 按钮保存配置

恭喜您，您刚刚在 Superset 中添加了一个新的数据源！

注册新表

配置数据源后，您可以选择要在 Superset 中公开以进行查询的特定表（在 Superset 中称为 数据集）。

导航到 数据 ‣ 数据集，然后点击右上角的 + 数据集 按钮。

一个模态窗口应该弹出。使用出现的下拉菜单选择您的 数据库、模式 和 表。在下面的示例中，我们注册了 examples 数据库中的 cleaned_sales_data 表。

最后，点击右下角的 添加 按钮。您现在应该在数据集列表中看到您的数据集。

自定义列属性

注册数据集后，您可以配置列属性，以决定该列在探索工作流中的处理方式

• 该列是时间性的吗？（是否应该用于时间序列图表的切片和切块？）
• 该列是否可过滤？
• 该列是否具有维度性？
• 如果它是日期时间列，Superset 应该如何解析日期时间格式？（使用 ISO-8601 字符串模式）

Superset 语义层

Superset 拥有一个轻量级的语义层，为分析师带来了许多生活质量上的改进。Superset 语义层可以存储 2 种类型的计算数据

1. 虚拟度量：您可以编写 SQL 查询来聚合来自多个列的值（例如 SUM(recovered) / SUM(confirmed)），并将其作为列（例如 recovery_rate）在探索中进行可视化。度量允许并鼓励使用聚合函数。

您也可以在此视图中为您的团队认证指标。

1. 虚拟计算列：您可以编写 SQL 查询来自定义特定列的显示和行为（例如 CAST(recovery_rate as float)）。计算列中不允许使用聚合函数。

在探索视图中创建图表

Superset 有 2 个主要的数据探索界面

• 探索：无代码可视化构建器。选择您的数据集，选择图表，自定义外观，然后发布。
• SQL Lab：SQL IDE，用于清洗、连接和准备数据以用于探索工作流

我们现在将专注于探索视图来创建图表。要从 数据集 选项卡开始探索工作流，请单击将为您的图表提供数据的数据集的名称。

您现在将看到一个强大的工作流，用于探索数据和迭代图表。

• 左侧的 数据集 视图包含列和度量列表，范围限定为您当前选择的数据集。
• 图表区域下方的 数据 预览还为您提供了有用的数据上下文。
• 使用 数据 选项卡和 自定义 选项卡，您可以更改可视化类型，选择时间列，选择要分组的度量，并自定义图表的美学。

当您使用下拉菜单自定义图表时，请务必点击 运行 按钮以获取视觉反馈。

在下面的截图中，我们只需点击下拉菜单中的选项，即可制作一个分组的时间序列条形图，以按产品线可视化我们的季度销售数据。

创建切片和仪表板

要保存图表，请先点击 保存 按钮。您可以选择

• 保存您的图表并将其添加到现有仪表板
• 保存您的图表并将其添加到新仪表板

在下面的截图中，我们将图表保存到一个新的“Superset 超级销售仪表板”中

要发布，请点击 保存并转到仪表板。

在幕后，Superset 将创建一个切片并将其所有创建图表所需的信息存储在其轻量级数据层中（查询、图表类型、选定的选项、名称等）。

要调整图表大小，请点击右上角的“编辑仪表板”按钮。

然后，点击并拖动图表的右下角，直到图表布局捕捉到您喜欢的基础网格位置。

点击 保存 以保留更改。

恭喜！您已成功在 Superset 中链接、分析和可视化数据。还有大量的其他表格配置和可视化选项，请开始探索并创建您自己的切片和仪表板。

管理仪表板访问权限

仪表板的访问权限由所有者（拥有仪表板编辑权限的用户）管理。

非所有者用户的访问权限可以通过两种不同的方式进行管理。仪表板需要发布才能对其他用户可见。

1. 数据集权限 - 如果您向相关角色添加数据集权限，它会自动授予对使用这些允许数据集的所有仪表板的隐式访问权限。
2. 仪表板角色 - 如果您启用 DASHBOARD_RBAC 功能标志，那么您将能够管理哪些角色可以访问仪表板
   • 授予角色对仪表板的访问权限将绕过数据集级别检查。拥有仪表板访问权限隐式授予对仪表板中所有特色图表的读取访问权限，从而也授予对所有相关数据集的读取访问权限。
   • 如果仪表板未指定任何角色，则将应用常规 数据集权限。

发布仪表板

如果您想让您的仪表板对其他用户可用，请点击仪表板标题旁边的 草稿 按钮。

警告

草稿仪表板仅对仪表板所有者和管理员可见。已发布的仪表板对所有有权访问底层数据集的用户可见，或者如果启用了 RBAC，则对已获得仪表板访问权限的角色可见。

将仪表板标记为收藏

您可以点击仪表板标题旁边的星形图标，将仪表板标记为收藏。这使得在仪表板列表或主页上更容易找到它。

自定义仪表板

以下 URL 参数可用于修改仪表板的渲染方式

• 独立:
  • 0（默认）：仪表板正常显示
  • 1：顶部导航栏隐藏
  • 2：顶部导航栏 + 标题隐藏
  • 3：顶部导航栏 + 标题 + 顶级选项卡隐藏
• 显示过滤器:
  • 0：渲染不带筛选器栏的仪表板
  • 1（默认）：如果启用了原生过滤器，则渲染带筛选器栏的仪表板
• 展开过滤器:
  • （默认）：如果存在原生过滤器，则渲染展开过滤器栏的仪表板
  • 0：渲染带折叠过滤器栏的仪表板
  • 1：渲染带展开过滤器栏的仪表板

例如，当运行本地开发版本时，以下将禁用顶部导航并删除过滤器栏：https://:8088/superset/dashboard/my-dashboard/?standalone=1&show_filters=0