Superset 安装

Superset 是大数据平台里很常见的数据可视化入口。前面已经把 HDFS、Hive、Trino、Spark、Atlas 等组件装好，这时再补 Superset，后面就可以逐步接入 Hive、Trino、Doris 等查询引擎，做仪表盘和交互式分析。

本篇继续使用三台 FQDN 主机，Superset Server 放在 hadoop1.test.com：

主机	Superset 角色
hadoop1.test.com	SUPERSET
hadoop2.test.com	无
hadoop3.test.com	无

Superset 需要一套独立的元数据库，用来保存用户、权限、数据源连接、图表、看板和查询记录。本文使用 hadoop1.test.com 上的 MySQL / MariaDB，演示库名、用户名和密码都使用 superset。生产环境请使用高复杂度密码，并按组件单独授权。

1. 准备 Superset 元数据库

先在 hadoop1.test.com 上用数据库管理员账号创建 Superset 元库和访问用户。演示环境里数据库管理员账号是 root / root：

CREATE DATABASE IF NOT EXISTS superset
  DEFAULT CHARACTER SET utf8mb4
  COLLATE utf8mb4_unicode_ci;

CREATE USER IF NOT EXISTS 'superset'@'%' IDENTIFIED BY 'superset';
ALTER USER 'superset'@'%' IDENTIFIED BY 'superset';
GRANT ALL PRIVILEGES ON superset.* TO 'superset'@'%';
FLUSH PRIVILEGES;

这里我建议把 Superset 元库和 Hive、Ranger、DolphinScheduler 这些组件的元库分开。以后做备份、迁移、权限收敛时，边界会清楚很多。

2. 选择 Superset 服务

进入 服务与组件，点击 新增服务，在服务列表里找到并勾选 Superset。

页面里可以看到 Superset 版本是 4.1.2，状态为“否”。本篇只安装 Superset 一个服务，安装后的问题更容易定位。

3. 分配 Superset Server

Master 分配页会出现 SUPERSET。

本次把 Superset Server 放在 hadoop1.test.com：

组件	分配主机	说明
SUPERSET	hadoop1.test.com	Superset Web、初始化任务和后台运行进程。

教程环境里 Superset 和数据库放在同一台机器，方便先把安装链路跑通。生产环境可以根据访问量、网关、负载均衡和数据库压力，把 Superset 放到独立的应用节点。

4. Slave / Client 页面直接下一步

Superset 没有 Slave 组件，也没有 Client 组件。

这个页面保持空即可。Superset 是单实例 Web 服务，真正要关注的是数据库、SECRET_KEY、监听端口和服务启动状态。

5. 填写数据库配置

进入自定义配置页后，切到 元数据存储配置。页面会自动推荐一部分配置，本篇按下面这样填写：

配置项	本文填写
Superset 数据库名	superset
Superset 数据库用户名	superset
Superset 数据库密码	superset
Superset Database type	MYSQL
数据库主机名	hadoop1.test.com
Superset 数据库端口	3306
启用 Flask 调试模式	FALSE

填写完成后，可以点击 测试数据库连接。只要数据库主机、端口、账号、密码和授权都正确，测试会很快完成。这里不建议把测试日志截图直接放到公开文档里，因为日志里可能会出现连接串和演示账号信息。

6. 生成 SECRET_KEY

Superset 需要 SECRET_KEY 来保护会话、签名和部分安全相关数据。页面提供了 一键生成。

点击 生成并填入 后，页面会把生成结果写回配置框。这个值后续不要随意更换，也不要贴到公开文档或截图里。生产环境建议把它纳入密钥管理，升级、迁移和恢复时保持一致。

7. 确认安装清单

确认页会列出本次新增服务、Master 分配、Slave / Client 分配和配置校验结果。

本次确认结果如下：

检查项	本次结果
新增服务	SUPERSET
Master 分配	SUPERSET -> hadoop1.test.com
Slave 分配	无
Client 分配	无
配置校验	必填项已填写

确认无误后点击 开始安装。

8. 提交 Kerberos 凭据并等待安装

当前集群已经开启 Kerberos，新增 Superset 时会要求提交 KDC 管理员凭据。这里填写 KDC 管理员 Principal 和密码，用于生成并分发服务需要的凭据。

凭据提交后进入安装进度页。Superset 的安装任务会完成软件包安装、配置下发、Kerberos Client 刷新等动作。

安装完成后，Superset 有时会先停留在“已安装”状态。这个时候不要以为失败了，回到服务页启动 Superset Server，启动阶段会继续完成元库初始化、管理员用户创建和 Web 进程拉起。

9. 启动后确认服务卡片

回到 服务与组件，搜索 superset。服务卡片里能看到 Superset Server 显示“运行中”。

这一步我会重点确认三件事：

检查项	期望结果
服务总数	新增后服务总数增加到 29。
Superset Server	状态为“运行中”。
已停止服务	数量为 0。

如果卡片显示“已停止”，进入服务操作里启动 Superset。启动失败时，优先看 hadoop1.test.com 上的 Superset 日志和数据库连接配置。

10. 访问 Superset Web 页面

Superset 默认监听端口是 18088，浏览器访问：

http://hadoop1.test.com:18088/

能看到 Superset 登录页，就说明 Web 入口已经起来。

演示环境里初始管理员使用默认的 admin / admin。第一次登录后建议马上修改密码，生产环境更不要保留默认密码。

登录后进入 Superset Home 页面，可以看到看板、图表、数据集、SQL 等入口。

到这里，Superset 的基础安装完成。下一篇继续安装 Alluxio，给集群补一个数据编排与缓存层。