🔥🔥 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配置。
