创建您的第一个仪表板
本节主要面向将 Superset 用于数据分析和探索工作流程的最终用户(数据分析师、业务分析师、数据科学家等)提供文档。
除了本网站,Preset.io还在docs.preset.io上维护了一套最新的最终用户文档。
本教程面向希望在 Superset 中创建图表和仪表板的用户。我们将向您展示如何将 Superset 连接到新数据库,并配置该数据库中的表以进行分析。您还将探索已公开的数据,并将可视化添加到仪表板,以便您体验端到端的用户流程。
连接到新数据库
Superset 本身没有用于存储数据的存储层,而是与您现有的支持 SQL 的数据库或数据存储配合使用。
首先,我们需要将连接凭据添加到您的数据库,以便能够从中查询和可视化数据。如果您通过Docker Compose在本地使用 Superset,则可以跳过此步骤,因为 Superset 中已包含并预配置了一个名为examples的 Postgres 数据库。
在右上角的+菜单下,选择“数据”,然后选择“连接数据库”选项

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

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

请注意,如果您尝试连接到另一个本地运行的数据库(无论是在主机上还是在另一个容器中),并且收到消息The port is closed.
,那么您需要将 HOST 调整为host.docker.internal
点击该链接后,您只需指定两项内容(数据库名称和 SQLAlchemy URI)

如表单下方文字所述,您应参考 SQLAlchemy 文档中关于创建新连接 URI的部分,以了解您的目标数据库。
单击测试连接按钮以确认端到端连接是否正常。如果连接良好,请单击模态窗口右下角的连接按钮保存配置
恭喜,您刚刚在 Superset 中添加了一个新数据源!
注册新表
现在您已配置数据源,您可以选择要通过 Superset 进行查询的特定表(在 Superset 中称为数据集)。
导航到数据 ‣ 数据集,然后单击右上角的+ 数据集按钮。

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

最后,单击右下角的添加按钮。您现在应该在数据集列表中看到您的数据集。
自定义列属性
现在您已注册数据集,您可以配置列属性,以确定该列在探索工作流程中的处理方式
- 该列是时间性的吗?(它应该用于时间序列图表的切片和切块吗?)
- 该列是否应该可过滤?
- 该列是维度型的吗?
- 如果它是一个日期时间列,Superset 应该如何解析日期时间格式?(使用ISO-8601 字符串模式)

Superset 语义层
Superset 拥有一个轻量级语义层,为分析师提供了许多生活质量改进。Superset 语义层可以存储两种类型的计算数据
- 虚拟指标:您可以编写 SQL 查询,聚合多个列的值(例如
SUM(recovered) / SUM(confirmed)
),并将其作为列(例如recovery_rate
)在探索中进行可视化。指标允许并鼓励使用聚合函数。

您还可以在此视图中为您团队的指标进行认证(如果需要)。
- 虚拟计算列:您可以编写 SQL 查询来自定义特定列的显示和行为(例如
CAST(recovery_rate as float)
)。计算列中不允许使用聚合函数。

在探索视图中创建图表
Superset 有两个主要的数据探索界面
- 探索:无代码可视化构建器。选择您的数据集,选择图表,自定义外观,然后发布。
- SQL Lab:用于清理、连接和准备数据以供探索工作流程使用的 SQL IDE
我们现在将专注于使用探索视图创建图表。要从数据集选项卡开始探索工作流程,请单击将为您的图表提供支持的数据集名称。

您现在将看到一个用于探索数据和迭代图表的强大工作流程。
- 左侧的数据集视图列出了与您当前选定数据集相关的列和指标。
- 图表下方的数据预览也为您提供了有用的数据上下文。
- 使用数据选项卡和自定义选项卡,您可以更改可视化类型、选择时间列、选择要分组的指标,并自定义图表的美观性。
当您使用下拉菜单自定义图表时,请务必单击运行按钮以获取视觉反馈。

在以下截图中,我们通过点击下拉菜单中的选项,制作了一个分组时间序列柱状图,以按产品线可视化我们的季度销售数据。

创建切片和仪表板
要保存图表,首先单击保存按钮。您可以选择
- 保存您的图表并将其添加到现有仪表板
- 保存您的图表并将其添加到新仪表板
在以下截图中,我们将图表保存到新的“Superset 超级销售仪表板”

要发布,请单击保存并转到仪表板。
在后台,Superset 将创建一个切片,并在其轻量级数据层中存储创建图表所需的所有信息(查询、图表类型、所选选项、名称等)。

要调整图表大小,首先单击右上角的“编辑仪表板”按钮。

然后,单击并拖动图表的右下角,直到图表布局对齐到您喜欢的底层网格位置。

单击保存以保留更改。
恭喜!您已成功在 Superset 中连接、分析和可视化数据。还有大量其他表格配置和可视化选项,请开始探索并创建您自己的切片和仪表板吧。
管理仪表板访问权限
仪表板的访问权限通过所有者(拥有仪表板编辑权限的用户)进行管理。
非所有者用户的访问权限可以通过两种不同方式管理。仪表板需要发布才能对其他用户可见。
- 数据集权限 - 如果您向相关角色添加数据集权限,它将自动授予对所有使用这些被许可数据集的仪表板的隐式访问权限。
- 仪表板角色 - 如果您启用DASHBOARD_RBAC 功能标志,则您将能够管理哪些角色可以访问仪表板
- 授予某个角色对仪表板的访问权限将绕过数据集级别的检查。拥有仪表板访问权限将隐式授予对仪表板中所有特色图表的读取权限,从而也授予对所有相关数据集的读取权限。
- 如果未为仪表板指定任何角色,则将应用常规的数据集权限。

发布仪表板
如果您希望让其他用户看到您的仪表板,请点击仪表板标题旁边的Draft
(草稿)按钮。

草稿仪表板仅对仪表板所有者和管理员可见。已发布的仪表板对所有有权访问底层数据集的用户可见,或者如果启用了 RBAC,则对已获得仪表板访问权限的角色可见。
将仪表板标记为收藏
您可以点击仪表板标题旁边的星形图标,将仪表板标记为收藏。这使得在仪表板列表或主页上更容易找到它。
自定义仪表板
以下 URL 参数可用于修改仪表板的渲染方式
独立显示 (standalone)
:0
(默认):仪表板正常显示1
:顶部导航栏隐藏2
:顶部导航栏 + 标题隐藏3
:顶部导航栏 + 标题 + 顶级选项卡隐藏
显示过滤器 (show_filters)
:0
:渲染仪表板时不带过滤器栏1
(默认):如果启用了原生过滤器,则渲染仪表板时带过滤器栏
展开过滤器 (expand_filters)
:- (默认):如果存在原生过滤器,则渲染仪表板时过滤器栏展开
0
:渲染仪表板时过滤器栏折叠1
:渲染仪表板时过滤器栏展开
例如,在运行本地开发版本时,以下操作将禁用顶部导航并移除过滤器栏:http://localhost:8088/superset/dashboard/my-dashboard/?standalone=1&show_filters=0