Superset版本升级指南与重大变更解析
【免费下载链接】superset 
项目地址: https://gitcode.com/gh_mirrors/su/superset
前言
Superset作为一款强大的数据可视化与商业智能工具，其版本迭代过程中会引入新功能、优化性能，同时也可能带来一些不兼容的变更。本文旨在帮助用户和技术团队理解各版本间的重大变更，为升级决策提供参考依据。
核心变更分类
1. 功能移除与替代方案
图表类型变更
- ECharts迁移：移除了传统的Area、Bar、Line等图表类型，统一迁移到ECharts实现版本。其中Event Flow和Sankey Loop图表因维护不足被彻底移除，用户需寻找替代方案。
- 水平过滤器栏：
HORIZONTAL_FILTER_BAR功能标志已移除，该功能正式成为核心功能。
数据源编辑器
- 移除了
DISABLE_LEGACY_DATASOURCE_EDITOR标志，旧版数据源编辑器永久下线。
文件上传
- CSV上传相关配置
CSV_UPLOAD_MAX_SIZE被移除，建议通过Web服务器控制上传大小。 - 文件上传端点简化为统一的新API，权限模型也进行了简化。
2. 配置变更
执行器配置
ALERT_REPORTS_EXECUTE_AS和THUMBNAILS_EXECUTE_AS重命名为ALERT_REPORTS_EXECUTORS和THUMBNAILS_EXECUTORS- 新增
CACHE_WARMUP_EXECUTORS配置 THUMBNAILS_SELENIUM_USER被移除
域名分片
SUPERSET_WEBSERVER_DOMAINS配置将在6.0版本移除，建议迁移到HTTP/2协议。
3. 技术栈升级
Python支持
- Python 3.9.x支持已弃用，推荐使用3.11版本，3.10仍将在Superset 5.0生命周期内支持。
前端框架
- React从16.13.1升级到17.0.2，自定义前端插件可能需要适配。
开发工具
- 用
ruff替代pylint作为唯一Python linter，显著提升开发效率。
4. 性能优化
数据库变更
- 为
query.sql_editor_id添加索引提升性能（可能导致大部署短暂停机） - 多列类型改为
MediumText（MySQL可能需要表锁）
接口优化
- 仪表板列表接口移除了
css、position_json等大字段提升响应速度
升级建议
预升级检查清单
- 兼容性评估：检查是否使用了已移除的图表类型或功能
- 配置审计：核对所有被重命名或移除的配置项
- 依赖检查：确保Python和Node版本符合要求
- 备份策略：重要数据和配置的完整备份
分阶段升级策略
- 测试环境验证：先在非生产环境验证所有关键功能
- 监控方案：准备性能监控和回滚方案
- 分批次上线：大型部署建议分批次升级
常见问题解决方案
图表迁移问题
若遇到传统图表无法使用的情况：
- 检查是否已自动迁移到ECharts版本
- 对于完全移除的图表，考虑使用其他可视化类型替代
配置适配问题
对于重命名的配置项：
- 更新配置文件中的键名
- 检查相关功能是否正常工作
性能问题处理
升级后若出现性能下降：
- 检查新增索引是否已正确建立
- 验证数据库连接池配置
- 监控关键接口响应时间
版本支持策略
Superset团队采用以下版本支持原则：
- 当前主要版本（如5.x）获得主动维护
- 上一个主要版本（如4.x）获得有限支持
- 更早版本不再获得官方支持
建议用户尽量保持使用最新稳定版本，以获得最佳功能体验和安全保障。
结语
Superset的持续演进既带来了更强大的功能，也要求用户关注升级过程中的变更点。通过理解这些变更的本质和影响，用户可以制定出最合适的升级策略，平衡功能需求与系统稳定性。建议技术团队定期查看更新日志，建立规范的升级流程，确保数据平台始终处于最佳状态。
【免费下载链接】superset 项目地址: https://gitcode.com/gh_mirrors/su/superset
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
