🔥🔥 AllData大数据产品是可定义数据中台，以数据平台为底座，以数据中台为桥梁，以机器学习平台为中层框架，以大模型应用为上游产品，提供全链路数字化解决方案。
✨杭州奥零数据科技官网：http://www.aolingdata.com
✨AllData开源项目：https://github.com/alldatacenter/alldata
✨Gitee组织：https://gitee.com/alldatacenter
摘要：BI可视化平台基于开源项目Datart建设。Datart是新一代数据可视化开放平台，支持各类企业数据可视化场景需求。文章内容主要为以下五部分:
一、在线演示环境
二、功能简介
三、源码编译部署安装
四、访问BI可视化平台页面
五、常见问题与解决方案
💡Tips:关注「公众号」大数据商业驱动引擎
🔹AllData数据中台线上正式环境：http://43.138.156.44:5173/ui_moat/
请联系市场总监获取账号密码
2.1 BI可视化平台基于开源项目Datart建设
Datart 是新一代数据可视化开放平台，支持各类企业数据可视化场景需求，如创建和使用报表、仪表板和大屏，进行可视化数据分析，构建可视化数据应用等。
🔹开源项目：https://github.com/running-elephant/datart
🔹文档地址：https://running-elephant.github.io
2.2 BI可视化平台功能特点：
- 多源数据接入与清洗
- 丰富的可视化组件
- 动态交互与数据钻取
- 自定义报表设计
- 实时数据监控
- 协作共享
💡部署步骤：
3.1 环境准备
🔹Java：JDK 1.8+（Datart 1.x 版本）或 JDK 11+（Datart 2.x 版本）🔹Maven：3.6.3+
🔹Node.js：14.x+（前端构建）
🔹数据库：MySQL 5.7+ 或 H2（开发环境）
3.2 源码编译部署获取安装包dat
3.3 文件结构 --首先解压安装包
–解压之后的文件结构如下:
3.4 BI可视化平台（Datart）后端编译与部署 --编译后端
–配置数据库：修改 src/main/resources/application.yml，配置数据库连接信息
–启动后端：
3.5 前端编译与部署 --进入前端目录：
–安装依赖：
–编译前端：
–开发环境启动：
–部署静态资源：
将 dist目录下的文件部署到 Nginx 或其他 Web 服务器。
3.6 访问Datart
🔹通过商业版环境访问datart前端：http://43.138.156.44:5173/ui_moat/#/ui_datart/main
3.7 源码编译部署安装
3.8 IDEA源码编译部署
3.9 获得安装包，上传服务器部署安装
4.1 配置数据源JDBC
在数据源类型中选择JDBC，支持 MySQL、Oracle、SQL Server 等主流数据库。
🔹进入数据源管理界面
- 在Datart的管理界面中，找到数据源配置选项，进入数据源管理页。
🔹配置连接参数–填写数据库连接信息，包括：
- 数据库URL：格式为jdbc:<数据源名称>://<数据源域名或IP>:<端口>/<数据源实例>?<连接参数>。例如，MySQL的URL示例为：jdbc:mysql://localhost:3306/datart?useSSL=false&serverTimezone=UTC。
- 用户名和密码：用于数据库认证。
- 驱动类名：
🔹上传驱动包
如MySQL驱动为com.mysql.cj.jdbc.Driver。若测试连接提示缺少驱动类，需手动填写驱动类名称。
🔹高级配置（可选）
- 开启服务端聚合：适合计算能力较弱的数据源，开启后将数据拉取到服务端进行聚合计算。
- 延迟刷新：避免重复查询，提升性能。
- 缓存配置：依赖Redis，开启后缓存查询结果。
🔹上传驱动包（如需）
- Datart可能未内置所有数据库的驱动类，需手动将对应数据库的JDBC驱动包（如mysql-connector-java.jar）放入Datart的lib目录，并重启服务以加载驱动。
🔹测试连接
- 点击测试按钮验证连接是否成功，成功后保存配置。
🔹注意事项
- 驱动包兼容性：确保驱动包版本与数据库版本兼容。例如，MySQL 8.0+ 需使用 mysql-connector-java 8.0.x。
- 连接参数格式：MySQL 示例：jdbc:mysql://hostname:port/dbname
xuseUnicode=true&characterEncoding=utf8 - PostgreSQL 示例：jdbc:postgresql://hostname:port/dbname
- 权限配置：确保数据库用户有足够的权限（如 SELECT、INSERT、UPDATE 等）。
- 网络连通性：检查数据库服务是否运行，防火墙是否放行端口。
- 日志排查：如遇连接失败，检查 AllData 或 Datart 的日志文件，定位错误原因
4.2 配置数据源HTTP
Datart支持配置API数据源，可通过以下步骤实现HTTP数据源的间接连接：
🔹选择API数据源类型
- 在Datart的数据源配置界面中，选择API作为数据源类型。
🔹配置API请求参数
- 填写HTTP请求的URL、请求方法（如GET、POST）、请求头、请求体等信息。这些参数将用于向HTTP服务发送请求并获取数据。
🔹解析响应数据
- 配置数据解析规则，将HTTP响应中的JSON或XML数据解析为Datart可识别的数据格式。
🔹测试连接
- 点击测试按钮验证API请求是否成功，并检查解析后的数据是否符合预期
4.3 配置数据源File
Datart支持配置API数据源，可通过以下步骤实现File数据源的间接连接：
🔹进入数据源管理界面
- 登录Datart管理后台，在左侧导航栏中找到“数据源管理”模块，点击进入。
🔹创建新数据源
- 在数据源管理页面，点击“新建数据源”按钮，进入数据源配置界面。
🔹选择数据源类型
- 在数据源类型下拉菜单中，选择“FILE”作为数据源类型。
🔹配置File数据源参数
- 上传文件：点击“上传文件”按钮，选择本地需要分析的文件（支持CSV、Excel等常见格式）。
- 文件格式设置：根据文件内容，设置字段分隔符（如逗号、制表符）、编码格式（如UTF-8）、是否包含表头等参数。
- 预览数据：上传文件后，可通过预览功能检查数据是否正确解析。
🔹保存数据源
确认配置无误后，点击“保存”按钮，完成File数据源的创建。
4.4 数据视图
数据视图功能通过建模、复用、权限控制三大核心能力，将原始数据转化为业务可用的分析模型，显著提升BI开发效率和报表灵活性。在AllData数据中台的集成环境下，数据视图可进一步发挥其统一管理、敏捷开发、企业级扩展的优势，成为企业数据驱动决策的关键工具。
4.4.1 数据视图-典型实用场景
🔹销售分析仪表盘
- 数据视图配置：关联订单表、产品表、客户表，计算销售额、毛利率、客户留存率。
- 可视化展示：通过折线图展示月度销售趋势，饼图展示产品占比。
🔹用户行为分析
- 数据视图配置：从埋点日志中提取用户行为事件（如点击、购买），按用户ID聚合分析转化路径。
- 可视化展示：漏斗图展示用户从浏览到支付的转化率。
🔹财务指标监控
- 数据视图配置：从ERP系统中提取收入、成本数据，计算利润率、现金流。
- 可视化展示：KPI卡片实时显示关键指标，异常数据高亮提醒。
4.5 数据视图-数据模型
通过预定义的数据模型，用户可快速获取标准化数据服务，缩短数据需求交付周期，提升业务响应速度。
4.5.1 数据视图-典型实用场景
🔹实时监控与决策：
通过实时数据模型，构建实时KPI监控仪表盘，帮助企业及时掌握业务动态，做出快速决策。
🔹敏捷BI需求响应：
快速响应业务部门的临时数据需求，通过数据模型快速生成定制化报表，支持业务探索和分析。
🔹数据资产价值化：
将分散的数据资源转化为标准化的数据模型，形成企业级数据资产目录，为业务决策提供有力支持。
4.6 数据视图-字段权限分配
字段权限分配可基于用户角色或组织架构，对数据模型中的敏感字段（如薪资、客户隐私信息）进行精细化管控。管理员可设置字段的可见性（隐藏/只读）或行级过滤条件，确保不同用户仅能访问授权字段，实现数据安全与业务需求的平衡。
4.7 数据视图-开始分析
开始分析是用户从数据准备到可视化呈现的核心入口。用户选定数据模型或视图后，通过拖拽字段至分析区域，系统自动生成基础图表（如柱状图、表格），支持即时调整维度/指标、筛选过滤，快速验证分析思路，降低业务探索门槛。
4.8 数据视图-构建BI视图
用户可通过拖拽数据模型字段至画布，快速构建BI视图。支持自定义图表类型（折线图、地图等）、联动交互与样式配置，实时预览分析效果。同时可添加计算字段、设置筛选条件，灵活满足业务洞察需求，实现数据到决策的快速转化。
4.9 数据视图-配置BI视图
配置BI视图支持对已构建的图表进行深度定制。用户可调整字段映射、设置数据聚合方式、定义图表样式（颜色、标签等），并添加交互功能（钻取、联动）。同时支持绑定参数、设置缓存策略，确保视图高效运行且满足个性化分析需求。
4.10 数据视图-趋势图分析
趋势图分析通过时间维度（如日、月、年）动态展示数据变化趋势。用户可拖拽指标字段至X/Y轴，支持多系列叠加对比（如销售额与增长率）。内置平滑曲线、移动平均等算法，结合自定义时间粒度与预警阈值，助力用户快速识别业务波动规律与潜在风险。
4.11 数据视图-饼图百分比分析
饼图百分比分析通过可视化占比直观呈现数据分布。用户可拖拽分类字段与数值字段，系统自动计算各部分占比并生成扇形区域，支持标签显示具体数值与百分比。提供颜色自定义、图例排序及爆炸效果，帮助用户快速识别核心数据维度及其贡献度。
4.12 数据视图-其他可视化视图分析
除趋势图、饼图以外，还支持地图、散点图、雷达图等多样化视图。用户可基于数据特征选择合适图表，通过拖拽字段快速生成，支持多维度数据对比、动态交互及自定义样式，满足复杂业务场景下的数据洞察需求。
4.13 数据视图-保存到数据仪表盘
用户完成可视化视图配置后，可一键将其保存至数据仪表盘。支持将多个视图灵活布局于同一界面，自定义仪表盘名称、主题风格及刷新频率，并设置访问权限。保存后仪表盘可实时更新数据，便于用户集中监控关键指标，快速掌握业务动态。
4.14 BI视图结果预览
BI视图结果预览支持用户实时查看可视化配置效果。完成字段拖拽、图表样式调整后，系统即时渲染分析结果，动态展示数据分布与趋势。预览界面支持交互操作（如筛选、缩放），帮助用户快速验证分析逻辑，确保视图准确传达业务洞察。
4.15 可视化中心展示
可视化中心集中展示用户创建的所有仪表盘、图表及故事板。提供分类标签、搜索与收藏功能，支持按权限筛选访问内容。界面采用卡片式布局，直观呈现视图缩略图与关键指标，用户可快速定位并进入分析界面，高效开展数据洞察与决策。
4.16 可视化中心导出、下载、分享
用户可将仪表盘或图表以图片（PNG/JPG）、PDF或Excel格式导出/下载，满足离线汇报需求。同时支持生成分享链接或嵌入代码，灵活设置访问权限（公开/加密），一键推送至团队或外部用户，实现分析成果的高效协作与传播。
4.17 可视化中心-发布可视化仪表盘
用户完成仪表盘设计后，可一键发布至指定环境。发布时支持配置访问权限（如按角色/部门）、设置数据刷新策略，并生成分享链接或嵌入代码，确保仪表盘安全、实时地触达目标用户。
4.18 点击播放-查看可视化大屏结果
用户可通过链接或权限入口直接访问已发布的大屏。大屏以全屏模式动态展示多图表联动视图，支持实时数据刷新、交互式筛选及钻取，帮助用户直观洞察关键指标与业务趋势。
4.19 数据分析大屏演示
数据分析大屏演示以全屏动态形式呈现关键指标与多维视图，支持实时数据更新、多图表联动交互及自定义动画效果，可适配不同终端，助力企业高效展示业务全景与决策洞察。
4.20 logback.xml为日志配置文件
-
在此仅对必要配置项做简单介绍，进一步了解请查看logback 官方文档
-
如果需要查看所有的查询 SQL 日志，请将 SQL_LEVEL设置 DEB
5.1 数据库连接失败
- 检查数据库服务是否启动，配置信息是否正确。
- 确保数据库用户有足够的权限。
5.2 前端编译失败
- 检查 Node.js 和 npm 版本是否符合要求。
- 删除 node_modules和 package-lock.json后重新安装依赖。
5.3 端口冲突
- 修改 application.properties或 application.yml中的 server.port配置。
