Dataease开发环境的搭建

0. 前言

因为数据呈现需求，发现DataEase好像是一个不错的工具，于是通过本地环境进行了搭建。相对比较简单能够跑起来。

1. 基础环境准备

准备好MySQL数据库。推荐使用5.7的版本。（尝试用8.0的版本，出现一些错误，退回5.7的版本则正常。）

先创建一个docker实例:

docker run -p 3306:3306 -v /opt/mysql/data:/var/lib/mysql -e MYSQL_ROOT_PASSWORD=12345678 -d --restart always mysql:5.7 --lower_case_table_names=1

通过docker cp将其中的conf.d目录中的内容拷出来：

docker cp bc9312112190:/etc/mysql/conf.d  /opt/mysql/
cd /opt/mysql/conf.d
cat > mysqld.cnf <<EOF
[mysqld]
max_allowed_packet = 500M
group_concat_max_len=1024000
sql_mode=''
EOF

sql_mode这一行用于修正：“ORDER BY clause is not in SELECT list“错误。参见

然后再重新创建新实例：

docker run -p 3306:3306 -v /opt/mysql/data:/var/lib/mysql -v /opt/mysql/conf.d:/etc/mysql/conf.d -e MYSQL_ROOT_PASSWORD=12345678 -d --restart always mysql:5.7 --lower_case_table_names=1

创建数据库：

CREATE DATABASE `dataease` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

2. 本地开发环境准备

下载最新的代码：

git clone https://github.com/dataease/dataease.git

cd dataease
mvn clean install

3. 编译构建

官方使用的是JDK11，本地使用的是JDK17，因此在构建的时候，出现一个lombok的错误。解决方法是，在extensions目录下的pom.xml中指定lombok版本，至少为1.18.28:

<dependency>
      <groupId>org.projectlombok</groupId>
      <artifactId>lombok</artifactId>
      <version>1.18.28</version>
  </dependency>

在构建前端的时候，如果出现错误，可能是由于node.js版本太低。最开始使用12.12.12版本的时候出现错误，将node.js升级到20.9.0.则所有错误消失。

4. 本地运行的配置文件

官方推荐是在/opt/dataease/conf底下存放配置文件dataease.properties。文件内容如下：

# 数据库配置
spring.datasource.url=jdbc:mysql://192.180.1.152:3306/dataease?autoReconnect=false&useUnicode=true&characterEncoding=UTF-8&characterSetResults=UTF-8&zeroDateTimeBehavior=convertToNull&useSSL=false
spring.datasource.username=root
spring.datasource.password=12345678

carte.host=192.180.1.152
carte.port=18080
carte.user=cluster
carte.passwd=cluster

doris.db=dataease
doris.user=root
doris.password=123456
doris.host=192.180.1.100
doris.port=9030
doris.httpPort=8030

#新建用户初始密码
dataease.init_password=123456
#登录超时时间单位min  如果不设置 默认8小时也就是480
dataease.login_timeout=480

logger.level=INFO

#DE运行模式，可选值有 local、simple、cluster，分别对应本地模式、精简模式、集群模式
engine_mode=simple

如果要修改配置文件的位置，需要修改三个地方：

1. core/backend/src/main/java/io/dataease/Application.java
2. core/backend/src/main/resources/logback.xml
3. core/backend/src/main/resources/generatorConfig.xml

将core/mapFiles目录下的地图文件夹full拷贝到/opt/dataease/data/feature/目录下。

mkdir -p /opt/dataease/data/feature/
cp -rf ./core/mapFiles/full  /opt/dataease/data/feature/

5. 启动运行

进入core/backednd/target目录下，执行生成的jar文件：

cd core/backednd/target
jar -jar backend-1.18.12.jar

系统启动后，通过http://localhost:8081即可访问。

6. 登录系统

系统会自动创建管理员账号（用户名：admin 密码：dataease)，登录系统后修改管理员密码。然后重新登录即可。