# datagear
**Repository Path**: itcode-itcode/datagear
## Basic Information
- **Project Name**: datagear
- **Description**: 数据可视化分析平台，使用Java语言开发，采用浏览器/服务器架构，支持SQL、CSV、Excel、HTTP接口、JSON等多种数据源
- **Primary Language**: Java
- **License**: LGPL-3.0
- **Default Branch**: master
- **Homepage**: http://www.datagear.tech
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 2517
- **Created**: 2020-12-02
- **Last Updated**: 2020-12-19
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# DataGear
DataGear是一款开源免费的数据可视化分析平台，使用Java语言开发，采用浏览器/服务器架构，支持SQL、CSV、Excel、HTTP接口、JSON等多种数据源，
主要功能包括数据管理、SQL工作台、数据导入/导出、数据集管理、图表管理、看板管理等。
## [DataGear 2.0.0 已发布，欢迎官网下载使用！](http://www.datagear.tech)
## [DataGear 大屏看板模板，持续更新中...](https://gitee.com/datagear/DataGearDashboardTemplate)
## 系统特点
- 可管理数据库驱动
可通过驱动程序管理功能添加数据库驱动程序，无需重启，即可支持连接新数据库
- 多种格式的数据集
支持SQL、CSV、Excel、HTTP接口、JSON等多种格式的数据集
- 多数据集聚合图表
一个图表可添加多个不同格式的数据集，将它们聚合展示
- 插件式图表类型
每一种类型的图表都以图表插件形式提供，并内置了大量图表插件，管理员也可上传自定义图表插件，丰富系统图表类型
- 可自由编辑的HTML看板模板
看板使用原生的HTML网页作为模板，可自由编辑、绑定、异步加载图表，并支持将任意HTML网页导入为看板
- 丰富的看板API
看板页面内置了大量的页面端API，可用于个性化扩展看板功能
## 架构图
## 官网
[http://www.datagear.tech](http://www.datagear.tech)
## 文档
[http://www.datagear.tech/documentation](http://www.datagear.tech/documentation)
## 交流
QQ群：[916083747（已满）](https://jq.qq.com/?_wv=1027&k=ODxiKOOy)、[1128360199](https://jq.qq.com/?_wv=1027&k=XkQ4ARMY)
留言板：[http://www.datagear.tech/messageboard](http://www.datagear.tech/messageboard/)
## 源码
Gitee：[https://gitee.com/datagear/datagear](https://gitee.com/datagear/datagear)
Github：[https://github.com/datageartech/datagear](https://github.com/datageartech/datagear)
## 界面
数据管理
SQL工作台
图表
图表-数据集参数
看板
看板-图表联动
看板-时序图表
看板-钻取
看板-表单
看板-联动异步加载图表
## [更多示例...](https://my.oschina.net/u/4035217)
## 模块介绍
- datagear-analysis
数据分析底层模块，定义数据集、图表、看板API
- datagear-connection
数据库连接支持模块，定义可从指定目录加载JDBC驱动、新建连接的API
- datagear-dataexchange
数据导入/导出底层模块，定义导入/导出指定数据源数据的API
- datagear-management
系统业务服务模块，定义数据源、数据分析等功能的服务层API
- datagear-meta
数据源元信息底层模块，定义解析指定数据源表结构的API
- datagear-persistence
数据源数据管理底层模块，定义读取、编辑、查询数据源表数据的API
- datagear-util
系统常用工具集模块
- datagear-web
系统web模块，定义web控制器、操作页面
## 依赖
Java 8+
Servlet 3.1+
## 编译
（执行单元测试编译，需要预先配置单元测试环境）
mvn clean package
（不执行单元测试编译，无需预先配置单元测试环境）
mvn clean package -DskipTests
编译完成后，将在`datagear-web/target/datagear-[version]-packages/`内生成程序包。
## 调试
1. 将datagear以maven工程导入至IDE工具；
2. 以调试模式运行datagear-web模块的：org.datagear.web.DataGearApplication
3. 打开浏览器，输入：http://localhost:50401
## 调试注意
在调试开发分支前（`dev-*`），建议先备份DataGear工作目录（`[用户主目录]/.datagear`），
因为开发分支程序启动时会修改DataGear工作目录，可能会导致先前使用的正式版程序、以及后续发布的正式版程序无法正常启动。
系统启动时会根据当前版本号自动升级内置数据库（Derby），且成功后下次启动时不再自动执行，如果调试时遇到数据库异常，需要查看
datagear-management/src/main/resources/org/datagear/management/ddl/datagear.sql
文件，从中查找需要更新的SQL语句，手动执行。
然后，手动执行下面更新系统版本号的SQL语句：
UPDATE DATAGEAR_VERSION SET VERSION_MAJOR='主版本号', VERSION_MINOR='次版本号', VERSION_REVISION = '修订版本号'
例如，对于`2.0.0`版本，应执行：
UPDATE DATAGEAR_VERSION SET VERSION_MAJOR='2', VERSION_MINOR='0', VERSION_REVISION = '0'
系统自带了一个可用于为内置数据库执行SQL语句的简单工具类`org.datagear.web.util.DerbySqlClient`，可以在IDE中直接运行。注意：运行前需要先停止DataGear程序。