简介面向需要在Windows环境中部署SuperSet即Apache Superset数据分析与可视化平台的技术人员这份操作文档从环境准备到服务启动与汉化给出了完整流程。文档以命令行操作为主线依次覆盖pip安装、管理员账号创建、数据库升级、示例数据加载、角色权限初始化和runserver启动服务等关键环节并补充了中文翻译目录搭建、mo文件下载及config.py配置修改等汉化细节可帮助读者快速落地一个可本地访问的中文BI看板环境。资源为1份docx格式说明文档压缩包大小约16KB内容精炼、命令可直接复制适合具备基础Python与数据库知识的数据分析师、开发或运维人员参考。目前已有1474人学习下载能有效减少在Windows下摸索依赖和配置所带来的时间成本。1. 别急着装先搞懂 Superset 到底是什么第一次听说 Superset很多人和我一样会嘀咕这又是一个装完就吃灰的折腾工具其实它和 Excel 里做透视表、画柱状图干的是同一件事只是把这件事搬到了网页上还顺手解决了多人一起看报表的难题。你只需要把数据库连上去剩下的查数、画图、做看板都在浏览器里完成。Superset 是一个开源的数据分析与可视化平台业内常叫它 BI 工具最初由一个做在线短租业务的团队开源主打自助分析、自定义仪表盘、结果可视化导出还内置 SQL 编辑器。它能连的数据库非常多MySQL、Oracle、PostgreSQL、Presto、SparkSQL、Redshift 都在支持列表里。这篇文章适合刚入行的数据分析同学、要给业务方做看板的工程师以及想把看数交给业务的平台使用者。后面全程按零基础路径走跟着敲就能跑通。2. 先弄清三件事数据源、SQL 编辑器和权限控制安装之前建议先花十分钟理解 Superset 的三个核心概念。我不是让你背理论而是想让你知道我们接下来装的不是普通软件而是一个连数据、查数据、展示数据的三层工具分别对应数据源、SQL 编辑器、仪表盘与权限控制。把这三个概念弄明白了后面每一步命令都不会显得莫名其妙。2.1 数据源Superset 的看家本领Superset 最核心的能力是把散落在各种数据库里的数据统一到一个网页里看。它自己并不保存你的数据数据仍然留在原来的数据库里Superset 只是接一条管道过去把表结构读出来再按你的操作把数据取回来画成图。你可以把它理解成一个翻译官MySQL 说 MySQL 的方言Oracle 说 Oracle 的方言翻译官把它们的回答统一翻译成你能看懂的表格和图表。它支持的数据库和数据平台在同类工具里算非常宽的。常见的业务库比如 MySQL、Oracle、PostgreSQL、MSSQL 能连数仓和大数据体系里的 Presto、Impala、SparkSQL、Greenplum 能连轻量的 SQLite以及云上的 Redshift 也都在支持列表里。顺便提一句它最早是为了支持 Druid 的可视化分析而开发的后来才一步步扩展成今天这样的多数据源形态。对新手来说这件事带来的好处很实在你只需要学会一个工具就能同时看开发库、分析库、数仓里的数据不用再像以前那样看 MySQL 开一个客户端看 Oracle 又开另一个客户端。后面第 6 章我会带你连自己的 MySQL到时候你会更明白一个入口看所有库是什么意思。现在只需要记住一个结论数据源连接是 Superset 的地基其他所有功能都建立在它之上。2.2 SQL 编辑器会写也好不会写也好数据源连好之后接下来就是怎么查数据。Superset 自带一个网页版 SQL 编辑器你可以直接在浏览器里写查询语句、查看返回结果几秒钟之内还能把结果转成图表不用在数据库客户端和网页之间来回切换。这就是它和纯报表工具不一样的地方它不是帮你把报表画死的工具而是给了你一个先查后画的工作台。不会写 SQL 怎么办完全不用担心。Superset 也支持不用 SQL 的可视化操作选中一张表拖进要做图的字段选好聚合方式图表就出来了。我的建议是点选用来做快速探索SQL 用来做复杂查询两条路都通。以下是一个最简单的查询示例写给完全没写过 SQL 的同学看-- 按天统计订单数和金额 SELECT DATE(order_time) AS day, -- 把下单时间取到天 COUNT(*) AS order_cnt, -- 统计这一天的订单数量 SUM(amount) AS total_amt -- 把金额加起来 FROM orders GROUP BY DATE(order_time) -- 按天分组 ORDER BY day; -- 按天排序这段查询的意思是从 orders 表里取数按下单日期分组算出每天的订单笔数和总金额最后按日期排好序。刚入门只需要抓住三个关键字SELECT 表示要哪些字段FROM 表示从哪张表取GROUP BY 表示按什么分组。把这段贴进 Superset 的 SQL 编辑器点运行就能看到结果表再从右上角图表按钮选柱状图日订单趋势就出来了。这里有个使用习惯值得从第一天就养成凡是写完的查询顺手保存成数据集后面做图表直接引用。因为 Superset 里查询结果和图表是可以复用的你这次算好的指标下次做仪表盘还能直接用不用重写一遍。我第一次学的时候不懂这个每次画图都重新贴一遍 SQL后来才发现可以先保存后悔没早一点知道这个功能。2.3 仪表盘与权限控制从自己看到给团队看查询结果能画成图表之后更大的需求来了怎么把它们组合成一张能汇报的看板Superset 的仪表盘就是把多张图表放在一个页面里支持拖拽排版、筛选联动、刷新数据也可以把图表导出成图片或 CSV。业务方不用学任何工具打开你发的链接就能自己看数、自己点筛选这是它最打动人的地方。维度再高一层是权限控制。Superset 支持用户和角色两套体系管理员能连数据源、改配置分析师能建图表、做仪表盘普通访客通常只给能看的权限。这样团队协作时不会出现谁都能改别人的看板这种混乱局面。以常见的权限设计为例大致是下面这样的分工角色示例能做什么适合谁管理员连接数据源、管理用户、全局配置负责搭建平台的人分析师写查询、建图表、做仪表盘日常做数据分析的人只读访客看仪表盘、点筛选业务方和领导看到这里你应该明白为什么 Superset 被归为 BI商业智能工具而不是简单的画图插件了它解决的不是单人问题而是一个团队如何围绕数据协作的问题。所以学习它的时候别只盯着怎么画一张好看的图多花一点时间理解数据从哪来、谁能看什么这两点才是它在工作里真正值钱的地方。3. 安装前的自查清单Python、pip 与数据库驱动Windows 下装 Superset说难不难说容易也容易失败。我见过太多人卡在最前面的环境环节还没开始装 Superset 就已经放弃。这一章我给你一份自查清单装之前花十分钟检查三样东西Python、pip、数据库驱动。这三样过关了后面第 4 章的命令基本一路顺畅。3.1 检查 Python 和 pip两条命令看清家底Superset 是 Python 写的所以第一步必须是机器上有一个能用的 Python。打开命令行Windows 下按 Win R输入 cmd 回车依次敲下面两条命令python --version pip --version第一条会打印 Python 版本号比如 Python 3.9.x第二条会打印 pip 的版本并显示它的安装路径。只要两条都正常输出你的 Python 环境就算过关了。如果提示不是内部或外部命令不用慌这是常见的环境变量问题Python 装了但命令行的搜索路径里没有它。最常见的解决方法是重装一次 Python安装向导第一步记得勾选Add Python to PATH这个复选框是新手最容易漏掉的。版本方面建议用 Python 3.x 的 64 位版本不用追求最新稳定版即可。这里多提醒一句如果你机器上同时装了多个 Python 版本敲 python 时不一定是你以为的那个可能指向了旧版本。遇到奇怪问题时先输出 python --version 确认当前用的是哪个这是安装类问题排查的第一步。提示Windows 的 Python 安装向导里Add Python to PATH 务必勾上否则后面 superset 命令大概率找不到。3.2 直接装还是用虚拟环境新手先分清装给谁检查完 Python下一个问题是Superset 装到哪里初学者最容易忽略这一点结果就是装是装上了但命令都找不到因为装到了别的环境里。Python 允许你创建虚拟环境相当于在系统里划出一块独立的工作区里面单独装 Python 和各类库跟全局环境互不干扰这也是很多教程反复强调环境隔离的原因。对新手我的建议是如果你只是在本机学习试玩直接用全局环境安装也够用步骤最少如果你机器上还有别的 Python 项目或者打算长期做数据分析建议花两分钟建一个虚拟环境避免以后库冲突时无从下手。虚拟环境创建很简单在命令行里执行python -m venv superset_env superset_env\Scripts\activate第一行创建名为 superset_env 的虚拟环境目录第二行激活它。激活成功后命令行开头会出现 (superset_env) 字样这时候再执行 pip install装的东西就都进这个环境里了。后面第 4 章里那些命令只要是在这个激活状态下的窗口里敲的就不会出现装了一堆东西却找不到命令的尴尬。还有一个概念建议提前理解Superset 安装后真正执行的脚本在 site-packages\superset\bin 目录下。site-packages 是 Python 存放第三方库的目录虚拟环境和全局环境各有一份。第 4 章初始化数据库时需要先切到那个目录很多新手卡在这一步就是因为在错误的位置执行了命令。现在知道有这个东西就行到时候照着切目录就好。3.3 数据库驱动现在装好后面少一次翻车Superset 本身只管读取数据并展示要和具体数据库打交道还需要一个叫驱动的中间层。打个比方Superset 讲通用语言MySQL 讲 MySQL 的方言驱动就是那个同声传译。缺了驱动数据源就算地址填对了连接也会报错。如果你打算在看完本文后连自己的 MySQL现在就先把驱动装上免得后面连接失败时到处排查。以 MySQL 为例在命令行执行pip install mysql-connector-python这条命令会安装一个让 Python 与 MySQL 对话的驱动。装完后你可以随时用 pip show mysql-connector-python 确认它是否就位。如果你的数据源是其他数据库思路一样Superset 用什么方式访问那类数据库就提前装好对应的驱动。现阶段还没确定数据源的话这步可以先跳过但请记住这个环节的存在因为后面连接失败时八成就是驱动没装。至此三个前置检查就齐了Python 可用、pip 可用、驱动备好。如果你用的是虚拟环境记得保持激活状态再进入下一章。下面我们开始正式安装。4. 安装全流程七条命令跑通第一个登录页这一章进入正题。我把 Superset 在 Windows 上的安装拆成五个小节用到的命令其实就那么几条先给你一张速查表心里有个底再一步步看。命令作用pip install superset安装 Superset 本体fabmanager create-admin --app superset创建管理员账号python superset db upgrade初始化数据库表结构python superset load_examples加载示例数据python superset init初始化角色与权限python superset runserver -d启动服务安装过程有依赖下载可能需要几分钟中途别关窗口。下面每一节我都会说清楚在哪里执行、执行后看到什么、失败了往哪查。4.1 安装 Superset 本体第一步下载依赖确保命令行已经准备好虚拟环境已激活更佳执行pip install superset这条命令让 pip 去 Python 包仓库里找到 Superset并把它依赖的一大批 Python 库一起下载安装。执行过程中你会看到大量进度行这是正常的不要因为刷屏就以为出错了。看到类似 Successfully installed 的提示才算安装完成。这一步最容易出的问题有两个一是网络环境导致下载超时报错一大片红字二是权限不足提示没有写入权限。前者可以换个时间段重试或者换一个速度更好的下载源后者可以在命令末尾加上 --user装到当前用户目录下。都不行的话别硬扛直接去第 5 章对着问题查。4.2 创建管理员账号记住你填的三样信息装完本体先别急着启动还需要一个管理员账号才能登录。执行fabmanager create-admin --app superset命令会依次提示你输入用户名、邮箱、密码、确认密码。用户名和密码是之后每次登录都要用的别随手起一个转身就忘邮箱只是登记用格式像邮箱就行不用真的能收信。填完后会提示创建成功这时管理员就有了。这里想说句实在话如果你安装的是更新的大版本这条命令有可能被改名比如整合到 superset 主命令下面。碰到这种情况不用慌执行 superset --help看输出里有没有 create-admin 或类似的子命令照提示走就行。命令名字会变思路不会变先建管理员再初始化数据库。4.3 初始化数据库先切目录再跑升级接下来这一步新手最容易翻车因为它要求你先换目录。Superset 的初始化脚本在安装目录下的 superset\bin 文件夹里所以要先切过去再执行cd C:\你的Python目录\Lib\site-packages\superset\bin python superset db upgrade注意把路径换成你自己机器上真实的 Python 安装目录如果你用了虚拟环境这个路径就在虚拟环境的 Lib\site-packages 下。db upgrade 的作用是创建或更新 Superset 内部的元数据库表结构默认使用 SQLite不需要你额外安装数据库。如果命令执行完没有报错就说明表结构初始化成功。这一步可能会卡几十秒属于正常现象。切目录时建议直接复制粘贴路径手打很容易少个反斜杠或者输错盘符这也是我踩过的坑。4.4 加载示例数据、初始化权限、启动服务数据库初始化完毕接着按顺序执行三条命令它们都在同一个 superset\bin 目录下python superset load_examples python superset init python superset runserver -d第一条 load_examples 导入一批演示数据包括示例表和现成的图表第二条 init 初始化角色与权限体系让不同用户各就各位第三条 runserver 启动服务-d 表示以调试模式运行代码改动后会自动重载对新手排查问题尤其有用。想换端口在命令末尾加 -p 加端口号比如 -p 8089。看到服务成功启动的日志后打开浏览器访问 http://localhost:8088就能看到登录页面。输入管理员账号密码点击登录不出意外你就进到了 Superset 主界面。到这里安装就算真正跑通了后面就是个性化配置的事。第一次启动会稍慢耐心等十几秒再刷新一次是正常的别一看到空白就以为失败。4.5 让界面变成中文三步汉化默认界面是全英文的对英文不太好的同学不太友好。Superset 支持多语言汉化分三步走。第一步在 Superset 安装目录下创建翻译目录执行md translations\zh\LC_MESSAGES这条命令一次创建三级目录。第二步把中文翻译文件放进去从官方发布仓库中找到 zh 目录下的 messages.mo下载后放进刚建好的 LC_MESSAGES 文件夹。mo 是编译好的翻译文件直接用最省事如果你拿到的是 messages.po 文本文件也可以自己改完再编译msgfmt messages.po -o messages.mo第三步修改配置文件。在 Superset 安装目录下找到 config.py用文本编辑器打开把语言相关配置改成下面这样# 默认语言设为中文 BABEL_DEFAULT_LOCALE zh # 翻译文件存放目录 BABEL_DEFAULT_FOLDER babel/translations # 允许的语言列表只保留中文 LANGUAGES { zh: {flag: cn, name: Chinese}, }改完保存重启服务再打开浏览器。如果还是英文多半是浏览器缓存了旧页面按 Ctrl F5 强制刷新或者直接开一个新的无痕窗口。汉化属于锦上添花的配置不影响功能但界面变中文之后学习成本会明显降低建议新手都做一下。5. 新手最容易踩的坑安装与汉化排查清单把第 4 章的流程走完正常情况下你已经是有 Superset的人了。但安装这种事顺利是相似的失败各有各的失败。这一章我把新手最容易遇到的四个问题整理出来每条都按现象 → 原因 → 解决写清楚你遇到问题直接对号入座。5.1 pip install superset 报错红字刷屏现象执行 pip install superset 后窗口里出现大段红色报错有时还包含超时连接失败之类的字样安装中断。原因Superset 依赖的包很多pip 需要逐个下载。网络状况不稳定或者某些依赖下载失败就会导致整体安装失败。还有一种可能是当前用户对 Python 安装目录没有写权限装到一半被系统拦下来。解决先试 --user 参数把包装进当前用户目录避开权限问题再检查网络重新执行一次安装。如果仍然不行就把 pip 本身升级一下再装升级命令是 pip install --upgrade pip。我第一次装的时候网络抖动导致反复失败后来把安装重试的次数调大才过去。装依赖这种事耐心比技巧重要只要报错信息里没有出现明确的语法错误基本都是环境和网络问题。5.2 提示 superset 不是内部或外部命令现象第 4 章的某一命令执行时窗口提示superset 不是内部或外部命令或提示找不到 superset 模块。原因前者是命令路径问题Python 的 Scripts 目录没有加进 PATH命令行找不到 superset 命令后者是环境问题你在的 Python 环境里根本没装过 Superset典型的例子是建了虚拟环境却没激活然后在全局环境里执行命令。解决先用 python -m pip list 查看当前环境里有没有 superset没有就先激活虚拟环境或重新安装。有但命令找不到时把 Python 安装目录下的 Scripts 文件夹路径加到系统 PATH 里或者改用 python -m 的方式调用。排查思路就一条先确认命令是在哪个 Python 环境里执行的再看那个环境里有没有装 Superset。5.3 db upgrade 卡住或显示数据库相关错误现象执行 python superset db upgrade 时长时间停在某一行或者直接报错错误信息里出现 database、sqlite 等字样。原因db upgrade 需要创建表结构默认的 SQLite 文件位置与当前目录权限有关。如果安装目录不可写或者你在错误的位置执行了命令它就可能卡住或报错。另一个常见原因是上一步的安装其实没成功前面埋了雷到这一步才爆出来。解决确认当前目录确实是 site-packages\superset\bin用以管理员身份运行重新打开命令行再试一次如果上一步安装有报错回到 5.1 先解决安装问题。还有一个可以放心的事实db upgrade 多跑一次不会出问题它不是那种怕重复的命令实在不确定就重试一遍。5.4 汉化不生效界面仍然全英文现象messages.mo 放进去了config.py 也改了重启服务后界面还是英文。原因最常见的三个翻译文件放错了目录config.py 改完没有保存或者保存了但没重启服务浏览器缓存了旧页面加载的还是原来的英文包。解决重新检查 translations\zh\LC_MESSAGES 这个路径注意目录名的大小写和顺序确认 config.py 里 BABEL_DEFAULT_LOCALE zh 这一行真实存在而不是被注释掉了关闭浏览器重新打开按 Ctrl F5 强制刷新或直接开无痕窗口验证。如果用了虚拟环境还要确认重启服务和修改的是同一个环境里的同一份 config.py这个坑我帮别人排查过好几次。6. 下一步怎么学把示例数据换成你自己的数据装好、汉化好Superset 的门就算打开了。接下来的目标只有一个尽快把自己的数据接进去别停在示例数据里。下面两条路径一条是具体动作一条是时间安排照着做就能完成从跑通到会做报表的跳跃。6.1 第一个目标连上自己的 MySQL连接自己的数据库是新手阶段最值得做的练习。在 Superset 顶部找到数据源入口选择新增数据库填写连接串MySQL 的连接串格式一般是mysql://用户名:密码localhost:3306/数据库名把用户名、密码、端口、库名换成你自己的填完先点测试连接提示成功再保存。这里有一条血泪经验如果密码里包含 、# 这类特殊字符连接常常失败排查起来很玄学。建议测试阶段先把密码简化跑通之后再逐步加复杂度。连接成功只是开始接下来把之前学过的 SQL 写法用到你自己的表上查出一条真实业务的数据你就真正进入状态了。6.2 一周路径从示例到一张能汇报的看板如果你不确定下一步学什么按下面这张表走一周就够了。阶段要做的动作完成标志1-2 天逐个点开示例仪表盘再看图表由哪些数据集构成能说清数据集与图表的关系3 天在 SQL 编辑器独立写一条带 WHERE 和 GROUP BY 的查询能查出一张有分组的汇总表4 天把查询结果建成图表拖进仪表盘做出能点筛选的看板5 天连自己的 MySQL把看板数据换成真实数据看板展示的是自己的业务数据这套流程走完你对 Superset 的掌握已经超过多数只看过教程没动手的人。之后想深入就按需学哪种图表适合什么数据、怎么给同事开通只读权限、如何配置定时刷新。从那以后我每次装完新工具都会强制自己把安装到跑通第一个例子的完整流程走一遍再干别的这样以后出了问题才知道该去哪看日志。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/17 14:30:02 · 阅读 1.2k 开源BI工具Superset：从数据源连接到仪表盘的可视化实战指南
简介面向需要在Windows环境中部署SuperSet即Apache Superset数据分析与可视化平台的技术人员这份操作文档从环境准备到服务启动与汉化给出了完整流程。文档以命令行操作为主线依次覆盖pip安装、管理员账号创建、数据库升级、示例数据加载、角色权限初始化和runserver启动服务等关键环节并补充了中文翻译目录搭建、mo文件下载及config.py配置修改等汉化细节可帮助读者快速落地一个可本地访问的中文BI看板环境。资源为1份docx格式说明文档压缩包大小约16KB内容精炼、命令可直接复制适合具备基础Python与数据库知识的数据分析师、开发或运维人员参考。目前已有1474人学习下载能有效减少在Windows下摸索依赖和配置所带来的时间成本。1. 别急着装先搞懂 Superset 到底是什么第一次听说 Superset很多人和我一样会嘀咕这又是一个装完就吃灰的折腾工具其实它和 Excel 里做透视表、画柱状图干的是同一件事只是把这件事搬到了网页上还顺手解决了多人一起看报表的难题。你只需要把数据库连上去剩下的查数、画图、做看板都在浏览器里完成。Superset 是一个开源的数据分析与可视化平台业内常叫它 BI 工具最初由一个做在线短租业务的团队开源主打自助分析、自定义仪表盘、结果可视化导出还内置 SQL 编辑器。它能连的数据库非常多MySQL、Oracle、PostgreSQL、Presto、SparkSQL、Redshift 都在支持列表里。这篇文章适合刚入行的数据分析同学、要给业务方做看板的工程师以及想把看数交给业务的平台使用者。后面全程按零基础路径走跟着敲就能跑通。2. 先弄清三件事数据源、SQL 编辑器和权限控制安装之前建议先花十分钟理解 Superset 的三个核心概念。我不是让你背理论而是想让你知道我们接下来装的不是普通软件而是一个连数据、查数据、展示数据的三层工具分别对应数据源、SQL 编辑器、仪表盘与权限控制。把这三个概念弄明白了后面每一步命令都不会显得莫名其妙。2.1 数据源Superset 的看家本领Superset 最核心的能力是把散落在各种数据库里的数据统一到一个网页里看。它自己并不保存你的数据数据仍然留在原来的数据库里Superset 只是接一条管道过去把表结构读出来再按你的操作把数据取回来画成图。你可以把它理解成一个翻译官MySQL 说 MySQL 的方言Oracle 说 Oracle 的方言翻译官把它们的回答统一翻译成你能看懂的表格和图表。它支持的数据库和数据平台在同类工具里算非常宽的。常见的业务库比如 MySQL、Oracle、PostgreSQL、MSSQL 能连数仓和大数据体系里的 Presto、Impala、SparkSQL、Greenplum 能连轻量的 SQLite以及云上的 Redshift 也都在支持列表里。顺便提一句它最早是为了支持 Druid 的可视化分析而开发的后来才一步步扩展成今天这样的多数据源形态。对新手来说这件事带来的好处很实在你只需要学会一个工具就能同时看开发库、分析库、数仓里的数据不用再像以前那样看 MySQL 开一个客户端看 Oracle 又开另一个客户端。后面第 6 章我会带你连自己的 MySQL到时候你会更明白一个入口看所有库是什么意思。现在只需要记住一个结论数据源连接是 Superset 的地基其他所有功能都建立在它之上。2.2 SQL 编辑器会写也好不会写也好数据源连好之后接下来就是怎么查数据。Superset 自带一个网页版 SQL 编辑器你可以直接在浏览器里写查询语句、查看返回结果几秒钟之内还能把结果转成图表不用在数据库客户端和网页之间来回切换。这就是它和纯报表工具不一样的地方它不是帮你把报表画死的工具而是给了你一个先查后画的工作台。不会写 SQL 怎么办完全不用担心。Superset 也支持不用 SQL 的可视化操作选中一张表拖进要做图的字段选好聚合方式图表就出来了。我的建议是点选用来做快速探索SQL 用来做复杂查询两条路都通。以下是一个最简单的查询示例写给完全没写过 SQL 的同学看-- 按天统计订单数和金额 SELECT DATE(order_time) AS day, -- 把下单时间取到天 COUNT(*) AS order_cnt, -- 统计这一天的订单数量 SUM(amount) AS total_amt -- 把金额加起来 FROM orders GROUP BY DATE(order_time) -- 按天分组 ORDER BY day; -- 按天排序这段查询的意思是从 orders 表里取数按下单日期分组算出每天的订单笔数和总金额最后按日期排好序。刚入门只需要抓住三个关键字SELECT 表示要哪些字段FROM 表示从哪张表取GROUP BY 表示按什么分组。把这段贴进 Superset 的 SQL 编辑器点运行就能看到结果表再从右上角图表按钮选柱状图日订单趋势就出来了。这里有个使用习惯值得从第一天就养成凡是写完的查询顺手保存成数据集后面做图表直接引用。因为 Superset 里查询结果和图表是可以复用的你这次算好的指标下次做仪表盘还能直接用不用重写一遍。我第一次学的时候不懂这个每次画图都重新贴一遍 SQL后来才发现可以先保存后悔没早一点知道这个功能。2.3 仪表盘与权限控制从自己看到给团队看查询结果能画成图表之后更大的需求来了怎么把它们组合成一张能汇报的看板Superset 的仪表盘就是把多张图表放在一个页面里支持拖拽排版、筛选联动、刷新数据也可以把图表导出成图片或 CSV。业务方不用学任何工具打开你发的链接就能自己看数、自己点筛选这是它最打动人的地方。维度再高一层是权限控制。Superset 支持用户和角色两套体系管理员能连数据源、改配置分析师能建图表、做仪表盘普通访客通常只给能看的权限。这样团队协作时不会出现谁都能改别人的看板这种混乱局面。以常见的权限设计为例大致是下面这样的分工角色示例能做什么适合谁管理员连接数据源、管理用户、全局配置负责搭建平台的人分析师写查询、建图表、做仪表盘日常做数据分析的人只读访客看仪表盘、点筛选业务方和领导看到这里你应该明白为什么 Superset 被归为 BI商业智能工具而不是简单的画图插件了它解决的不是单人问题而是一个团队如何围绕数据协作的问题。所以学习它的时候别只盯着怎么画一张好看的图多花一点时间理解数据从哪来、谁能看什么这两点才是它在工作里真正值钱的地方。3. 安装前的自查清单Python、pip 与数据库驱动Windows 下装 Superset说难不难说容易也容易失败。我见过太多人卡在最前面的环境环节还没开始装 Superset 就已经放弃。这一章我给你一份自查清单装之前花十分钟检查三样东西Python、pip、数据库驱动。这三样过关了后面第 4 章的命令基本一路顺畅。3.1 检查 Python 和 pip两条命令看清家底Superset 是 Python 写的所以第一步必须是机器上有一个能用的 Python。打开命令行Windows 下按 Win R输入 cmd 回车依次敲下面两条命令python --version pip --version第一条会打印 Python 版本号比如 Python 3.9.x第二条会打印 pip 的版本并显示它的安装路径。只要两条都正常输出你的 Python 环境就算过关了。如果提示不是内部或外部命令不用慌这是常见的环境变量问题Python 装了但命令行的搜索路径里没有它。最常见的解决方法是重装一次 Python安装向导第一步记得勾选Add Python to PATH这个复选框是新手最容易漏掉的。版本方面建议用 Python 3.x 的 64 位版本不用追求最新稳定版即可。这里多提醒一句如果你机器上同时装了多个 Python 版本敲 python 时不一定是你以为的那个可能指向了旧版本。遇到奇怪问题时先输出 python --version 确认当前用的是哪个这是安装类问题排查的第一步。提示Windows 的 Python 安装向导里Add Python to PATH 务必勾上否则后面 superset 命令大概率找不到。3.2 直接装还是用虚拟环境新手先分清装给谁检查完 Python下一个问题是Superset 装到哪里初学者最容易忽略这一点结果就是装是装上了但命令都找不到因为装到了别的环境里。Python 允许你创建虚拟环境相当于在系统里划出一块独立的工作区里面单独装 Python 和各类库跟全局环境互不干扰这也是很多教程反复强调环境隔离的原因。对新手我的建议是如果你只是在本机学习试玩直接用全局环境安装也够用步骤最少如果你机器上还有别的 Python 项目或者打算长期做数据分析建议花两分钟建一个虚拟环境避免以后库冲突时无从下手。虚拟环境创建很简单在命令行里执行python -m venv superset_env superset_env\Scripts\activate第一行创建名为 superset_env 的虚拟环境目录第二行激活它。激活成功后命令行开头会出现 (superset_env) 字样这时候再执行 pip install装的东西就都进这个环境里了。后面第 4 章里那些命令只要是在这个激活状态下的窗口里敲的就不会出现装了一堆东西却找不到命令的尴尬。还有一个概念建议提前理解Superset 安装后真正执行的脚本在 site-packages\superset\bin 目录下。site-packages 是 Python 存放第三方库的目录虚拟环境和全局环境各有一份。第 4 章初始化数据库时需要先切到那个目录很多新手卡在这一步就是因为在错误的位置执行了命令。现在知道有这个东西就行到时候照着切目录就好。3.3 数据库驱动现在装好后面少一次翻车Superset 本身只管读取数据并展示要和具体数据库打交道还需要一个叫驱动的中间层。打个比方Superset 讲通用语言MySQL 讲 MySQL 的方言驱动就是那个同声传译。缺了驱动数据源就算地址填对了连接也会报错。如果你打算在看完本文后连自己的 MySQL现在就先把驱动装上免得后面连接失败时到处排查。以 MySQL 为例在命令行执行pip install mysql-connector-python这条命令会安装一个让 Python 与 MySQL 对话的驱动。装完后你可以随时用 pip show mysql-connector-python 确认它是否就位。如果你的数据源是其他数据库思路一样Superset 用什么方式访问那类数据库就提前装好对应的驱动。现阶段还没确定数据源的话这步可以先跳过但请记住这个环节的存在因为后面连接失败时八成就是驱动没装。至此三个前置检查就齐了Python 可用、pip 可用、驱动备好。如果你用的是虚拟环境记得保持激活状态再进入下一章。下面我们开始正式安装。4. 安装全流程七条命令跑通第一个登录页这一章进入正题。我把 Superset 在 Windows 上的安装拆成五个小节用到的命令其实就那么几条先给你一张速查表心里有个底再一步步看。命令作用pip install superset安装 Superset 本体fabmanager create-admin --app superset创建管理员账号python superset db upgrade初始化数据库表结构python superset load_examples加载示例数据python superset init初始化角色与权限python superset runserver -d启动服务安装过程有依赖下载可能需要几分钟中途别关窗口。下面每一节我都会说清楚在哪里执行、执行后看到什么、失败了往哪查。4.1 安装 Superset 本体第一步下载依赖确保命令行已经准备好虚拟环境已激活更佳执行pip install superset这条命令让 pip 去 Python 包仓库里找到 Superset并把它依赖的一大批 Python 库一起下载安装。执行过程中你会看到大量进度行这是正常的不要因为刷屏就以为出错了。看到类似 Successfully installed 的提示才算安装完成。这一步最容易出的问题有两个一是网络环境导致下载超时报错一大片红字二是权限不足提示没有写入权限。前者可以换个时间段重试或者换一个速度更好的下载源后者可以在命令末尾加上 --user装到当前用户目录下。都不行的话别硬扛直接去第 5 章对着问题查。4.2 创建管理员账号记住你填的三样信息装完本体先别急着启动还需要一个管理员账号才能登录。执行fabmanager create-admin --app superset命令会依次提示你输入用户名、邮箱、密码、确认密码。用户名和密码是之后每次登录都要用的别随手起一个转身就忘邮箱只是登记用格式像邮箱就行不用真的能收信。填完后会提示创建成功这时管理员就有了。这里想说句实在话如果你安装的是更新的大版本这条命令有可能被改名比如整合到 superset 主命令下面。碰到这种情况不用慌执行 superset --help看输出里有没有 create-admin 或类似的子命令照提示走就行。命令名字会变思路不会变先建管理员再初始化数据库。4.3 初始化数据库先切目录再跑升级接下来这一步新手最容易翻车因为它要求你先换目录。Superset 的初始化脚本在安装目录下的 superset\bin 文件夹里所以要先切过去再执行cd C:\你的Python目录\Lib\site-packages\superset\bin python superset db upgrade注意把路径换成你自己机器上真实的 Python 安装目录如果你用了虚拟环境这个路径就在虚拟环境的 Lib\site-packages 下。db upgrade 的作用是创建或更新 Superset 内部的元数据库表结构默认使用 SQLite不需要你额外安装数据库。如果命令执行完没有报错就说明表结构初始化成功。这一步可能会卡几十秒属于正常现象。切目录时建议直接复制粘贴路径手打很容易少个反斜杠或者输错盘符这也是我踩过的坑。4.4 加载示例数据、初始化权限、启动服务数据库初始化完毕接着按顺序执行三条命令它们都在同一个 superset\bin 目录下python superset load_examples python superset init python superset runserver -d第一条 load_examples 导入一批演示数据包括示例表和现成的图表第二条 init 初始化角色与权限体系让不同用户各就各位第三条 runserver 启动服务-d 表示以调试模式运行代码改动后会自动重载对新手排查问题尤其有用。想换端口在命令末尾加 -p 加端口号比如 -p 8089。看到服务成功启动的日志后打开浏览器访问 http://localhost:8088就能看到登录页面。输入管理员账号密码点击登录不出意外你就进到了 Superset 主界面。到这里安装就算真正跑通了后面就是个性化配置的事。第一次启动会稍慢耐心等十几秒再刷新一次是正常的别一看到空白就以为失败。4.5 让界面变成中文三步汉化默认界面是全英文的对英文不太好的同学不太友好。Superset 支持多语言汉化分三步走。第一步在 Superset 安装目录下创建翻译目录执行md translations\zh\LC_MESSAGES这条命令一次创建三级目录。第二步把中文翻译文件放进去从官方发布仓库中找到 zh 目录下的 messages.mo下载后放进刚建好的 LC_MESSAGES 文件夹。mo 是编译好的翻译文件直接用最省事如果你拿到的是 messages.po 文本文件也可以自己改完再编译msgfmt messages.po -o messages.mo第三步修改配置文件。在 Superset 安装目录下找到 config.py用文本编辑器打开把语言相关配置改成下面这样# 默认语言设为中文 BABEL_DEFAULT_LOCALE zh # 翻译文件存放目录 BABEL_DEFAULT_FOLDER babel/translations # 允许的语言列表只保留中文 LANGUAGES { zh: {flag: cn, name: Chinese}, }改完保存重启服务再打开浏览器。如果还是英文多半是浏览器缓存了旧页面按 Ctrl F5 强制刷新或者直接开一个新的无痕窗口。汉化属于锦上添花的配置不影响功能但界面变中文之后学习成本会明显降低建议新手都做一下。5. 新手最容易踩的坑安装与汉化排查清单把第 4 章的流程走完正常情况下你已经是有 Superset的人了。但安装这种事顺利是相似的失败各有各的失败。这一章我把新手最容易遇到的四个问题整理出来每条都按现象 → 原因 → 解决写清楚你遇到问题直接对号入座。5.1 pip install superset 报错红字刷屏现象执行 pip install superset 后窗口里出现大段红色报错有时还包含超时连接失败之类的字样安装中断。原因Superset 依赖的包很多pip 需要逐个下载。网络状况不稳定或者某些依赖下载失败就会导致整体安装失败。还有一种可能是当前用户对 Python 安装目录没有写权限装到一半被系统拦下来。解决先试 --user 参数把包装进当前用户目录避开权限问题再检查网络重新执行一次安装。如果仍然不行就把 pip 本身升级一下再装升级命令是 pip install --upgrade pip。我第一次装的时候网络抖动导致反复失败后来把安装重试的次数调大才过去。装依赖这种事耐心比技巧重要只要报错信息里没有出现明确的语法错误基本都是环境和网络问题。5.2 提示 superset 不是内部或外部命令现象第 4 章的某一命令执行时窗口提示superset 不是内部或外部命令或提示找不到 superset 模块。原因前者是命令路径问题Python 的 Scripts 目录没有加进 PATH命令行找不到 superset 命令后者是环境问题你在的 Python 环境里根本没装过 Superset典型的例子是建了虚拟环境却没激活然后在全局环境里执行命令。解决先用 python -m pip list 查看当前环境里有没有 superset没有就先激活虚拟环境或重新安装。有但命令找不到时把 Python 安装目录下的 Scripts 文件夹路径加到系统 PATH 里或者改用 python -m 的方式调用。排查思路就一条先确认命令是在哪个 Python 环境里执行的再看那个环境里有没有装 Superset。5.3 db upgrade 卡住或显示数据库相关错误现象执行 python superset db upgrade 时长时间停在某一行或者直接报错错误信息里出现 database、sqlite 等字样。原因db upgrade 需要创建表结构默认的 SQLite 文件位置与当前目录权限有关。如果安装目录不可写或者你在错误的位置执行了命令它就可能卡住或报错。另一个常见原因是上一步的安装其实没成功前面埋了雷到这一步才爆出来。解决确认当前目录确实是 site-packages\superset\bin用以管理员身份运行重新打开命令行再试一次如果上一步安装有报错回到 5.1 先解决安装问题。还有一个可以放心的事实db upgrade 多跑一次不会出问题它不是那种怕重复的命令实在不确定就重试一遍。5.4 汉化不生效界面仍然全英文现象messages.mo 放进去了config.py 也改了重启服务后界面还是英文。原因最常见的三个翻译文件放错了目录config.py 改完没有保存或者保存了但没重启服务浏览器缓存了旧页面加载的还是原来的英文包。解决重新检查 translations\zh\LC_MESSAGES 这个路径注意目录名的大小写和顺序确认 config.py 里 BABEL_DEFAULT_LOCALE zh 这一行真实存在而不是被注释掉了关闭浏览器重新打开按 Ctrl F5 强制刷新或直接开无痕窗口验证。如果用了虚拟环境还要确认重启服务和修改的是同一个环境里的同一份 config.py这个坑我帮别人排查过好几次。6. 下一步怎么学把示例数据换成你自己的数据装好、汉化好Superset 的门就算打开了。接下来的目标只有一个尽快把自己的数据接进去别停在示例数据里。下面两条路径一条是具体动作一条是时间安排照着做就能完成从跑通到会做报表的跳跃。6.1 第一个目标连上自己的 MySQL连接自己的数据库是新手阶段最值得做的练习。在 Superset 顶部找到数据源入口选择新增数据库填写连接串MySQL 的连接串格式一般是mysql://用户名:密码localhost:3306/数据库名把用户名、密码、端口、库名换成你自己的填完先点测试连接提示成功再保存。这里有一条血泪经验如果密码里包含 、# 这类特殊字符连接常常失败排查起来很玄学。建议测试阶段先把密码简化跑通之后再逐步加复杂度。连接成功只是开始接下来把之前学过的 SQL 写法用到你自己的表上查出一条真实业务的数据你就真正进入状态了。6.2 一周路径从示例到一张能汇报的看板如果你不确定下一步学什么按下面这张表走一周就够了。阶段要做的动作完成标志1-2 天逐个点开示例仪表盘再看图表由哪些数据集构成能说清数据集与图表的关系3 天在 SQL 编辑器独立写一条带 WHERE 和 GROUP BY 的查询能查出一张有分组的汇总表4 天把查询结果建成图表拖进仪表盘做出能点筛选的看板5 天连自己的 MySQL把看板数据换成真实数据看板展示的是自己的业务数据这套流程走完你对 Superset 的掌握已经超过多数只看过教程没动手的人。之后想深入就按需学哪种图表适合什么数据、怎么给同事开通只读权限、如何配置定时刷新。从那以后我每次装完新工具都会强制自己把安装到跑通第一个例子的完整流程走一遍再干别的这样以后出了问题才知道该去哪看日志。希望帮到你。本文还有配套的精品资源点击获取