Windows Server 2019下安装Apache Superset及对接MSSQL的步骤与命令咨询
2026-11-14
Windows Server 2019 环境下 Apache Superset 安装及 MSSQL 对接实操指南
一、前置环境准备
所有操作均在管理员权限的命令提示符（CMD）下执行：
- 安装适配版本的Python：Apache Superset 稳定版兼容 Python 3.9 ~ 3.11，安装时务必勾选 Add Python to PATH 选项，安装完成后执行
python --version验证版本符合要求，不要使用3.12及以上版本，避免出现依赖编译失败问题。 - 安装Git工具：用于安装过程中拉取依赖组件，安装完成后执行
git --version验证可正常调用。 - 安装Visual C生成工具：打开安装程序后选择“使用C的桌面开发”工作负载，勾选核心编译组件、对应版本的Windows SDK完成安装，解决Python二进制依赖的编译报错问题。
- 创建独立Python虚拟环境，避免依赖污染全局环境：
- 执行命令创建虚拟环境，比如将虚拟环境存放至D盘对应目录：
python -m venv D:\superset-env - 激活虚拟环境：
D:\superset-env\Scripts\activate，激活成功后命令行前缀会显示虚拟环境名称。
- 执行命令创建虚拟环境，比如将虚拟环境存放至D盘对应目录：
- 升级虚拟环境内的基础工具：
python -m pip install --upgrade pip setuptools wheel，解决旧版pip的版本解析异常问题。
二、Superset 安装与初始化操作步骤
以下命令均在已激活的Superset虚拟环境中执行：
- 安装兼容版本的Superset：执行
pip install apache-superset==2.1.3，如果安装过程中弹出Werkzeug版本兼容报错，手动执行pip install werkzeug==2.0.3完成兼容版本降级。 - 初始化Superset默认元数据库（默认使用SQLite存储配置，适合中小规模测试/生产场景）：执行
superset db upgrade。 - 创建系统管理员账号：执行
superset fab create-admin，按照命令行提示依次输入登录用户名、姓名、绑定邮箱、登录密码即可，所有字段只要符合填写规则无特殊要求。 - 加载内置示例数据（可选步骤，不需要示例看板可跳过）：执行
superset load_examples。 - 初始化系统内置角色、权限与基础配置：执行
superset init。 - 启动Superset服务：执行
superset run -p 8088 --with-threads --reload --debugger，启动完成后在服务器本地浏览器访问http://localhost:8088，使用刚才创建的管理员账号即可登录系统。
实操提示：如果需要让Superset后台持续运行，不要直接关闭启动服务的CMD窗口，可以将启动命令写入批处理脚本，通过Windows任务计划程序配置开机自动运行即可；如果8088端口被其他程序占用，将启动命令中的
-p 8088替换为未被占用的端口（比如-p 8090）即可。
三、Superset 对接 MSSQL 的实现流程
- 安装对接所需的依赖组件：
- 在Windows Server系统上安装64位 ODBC Driver 17 for SQL Server，该版本兼容从SQL Server 2008到最新2022的所有版本，安装完成后可通过系统的ODBC数据源管理器验证驱动是否存在。
- 在已激活的Superset虚拟环境中执行Python驱动安装命令：
pip install pyodbc sqlalchemy-pyodbc-mssql。
- 配置数据库连接串：在Superset的数据库连接新增页面，选择数据库类型为MSSQL，按照规则填写SQLAlchemy格式的连接串，标准格式为：
mssql+pyodbc://<数据库登录用户名>:<数据库登录密码>@<MSSQL服务IP,自定义端口>/<目标连接数据库名>?driver=ODBC+Driver+17+for+SQL+Server&TrustServerCertificate=yes- 格式说明：MSSQL默认使用1433端口时，无需在IP后附加端口；如果服务开启了强制加密且使用自签名证书，必须附加
TrustServerCertificate=yes参数，否则会出现证书校验失败报错；如果使用域账号认证，用户名部分需要填写为域名\域账号名的转义格式。
- 格式说明：MSSQL默认使用1433端口时，无需在IP后附加端口；如果服务开启了强制加密且使用自签名证书，必须附加
- 连通性验证：连接串填写完成后，点击Superset页面的Test Connection按钮，提示连接成功后保存配置，即可基于对应MSSQL库的表创建数据集、搭建可视化看板。
常见问题排查：如果报错提示找不到驱动，检查Python和ODBC驱动的位数是否一致（64位Python必须匹配64位ODBC驱动）；如果提示登录失败，检查MSSQL服务是否开启TCP/IP协议、Windows防火墙是否放开对应数据库端口的访问权限。
内容的提问来源于stack exchange，提问作者Muhammad Abu ul Fazal
相关产品推荐
相关产品推荐
