MySQL 相关

1 如何修改内置 MySQL 端口

  1. 修改配置文件:
    1.4 版本之前的版本,修改运行目录下 /opt/dataease/docker-compose-mysql.yml 文件,将 MySQL 外部运行端口参数 ${DE_MYSQL_PORT} 改为新端口,如 3307:

    1. ports:
    2. - 3307:3306

    1.4 版本及之后的版本,修改运行目录下 /opt/dataease/.env 文件,将 DE_MYSQL_PORT 改为新端口,如 3307:

    1. DE_MYSQL_PORT=3307
  2. 重启 DataEase 服务: service dataease restart

2 如何修改内置 MySQL 容器名

  1. 修改运行目录下 /opt/dataease/docker-compose.yml 文件,将 dataease 的 depends_on 里的 mysql 改为 mysql-de,例如:

    1. dataease:
    2. image: registry.cn-qingdao.aliyuncs.com/dataease/dataease:v1.0.0
    3. container_name: dataease
    4. ports:
    5. - 80:8081
    6. mem_limit: 4096m
    7. volumes:
    8. - dataease-conf:/opt/dataease/conf
    9. - dataease-logs:/opt/dataease/logs
    10. - dataease-plugins:/opt/dataease/plugins/thirdpart
    11. - dataease-kettle-data:/opt/dataease/data/kettle
    12. depends_on:
    13. mysql-de:
    14. condition: service_healthy
  2. 修改 /opt/dataease/docker-compose-mysql.yml,将 mysql 相关的容器名改为 mysql-de,例如:

    1. mysql-de:
    2. image: registry.cn-qingdao.aliyuncs.com/dataease/mysql:5.7.25
    3. container_name: mysql-de
    4. healthcheck:
    5. test: ["CMD", "mysqladmin" ,"ping", "-h", "localhost"]
    6. interval: 5s
    7. timeout: 3s
    8. retries: 10
    9. env_file:
    10. - ./conf/mysql.env
    11. ports:
    12. - 53306:3306
    13. volumes:
    14. - /opt/dataease/conf/my.cnf:/etc/mysql/conf.d/my.cnf
    15. - /opt/dataease/bin/mysql:/docker-entrypoint-initdb.d/
    16. - dataease-mysql-data:/var/lib/mysql
    17. networks:
    18. - dataease-network
  3. 修改 /opt/dataease/conf/dataease.properties,将数据库 URL 信息改为如下:

    1. spring.datasource.url=jdbc:mysql://mysql-de:3306/dataease?autoReconnect=false&useUnicode=true&characterEncoding=UTF-8&characterSetResults=UTF-8&zeroDateTimeBehavior=convertToNull&useSSL=false
  4. 重启 DataEase 服务: service dataease restart

3 修改已安装的 DataEase 链接外部 MySQL

特别注意,使用外部 MySQL 时,需要注意几个地方:

  • lower_case_table_names=1
  • group_concat_max_len=1024000
  • default-character-set=utf8
  • innodb_large_prefix=on
  1. 修改运行目录下 .env (默认路径 /opt/dataease/.env) 文件中 MySQL 的相关配置,包括 DE_EXTERNAL_MYSQL、DE_MYSQL_HOST、DE_MYSQL_PORT、DE_MYSQL_DB、DE_MYSQL_USER、DE_MYSQL_PASSWORD,DE_EXTERNAL_MYSQL=true;
  2. 修改 dataease.properties (默认路径 /opt/dataease/conf/dataease.properties),将 spring.datasource 开头的几个参数里,MySQL 的配置参数进行相应的修改,包括:数据库地址、数据库端口、数据库库名、数据库用户名、数据库密码;
  3. 内置 MySQL 切换为外置 MySQL,修改运行目录下 /opt/dataease/docker-compose.yml 文件,将其中 depends_on 相关设置删除:

    1. depends_on:
    2. mysql:
    3. condition: service_healthy
  4. 重启 DataEase 服务: service dataease restart

4 DataEase 数据库由外部 MySQL 切换为内置 MySQL

  1. 修改运行目录下 .env (默认路径 /opt/dataease/.env) 文件中 MySQL 的相关配置,包括 DE_EXTERNAL_MYSQL、DE_MYSQL_HOST、DE_MYSQL_PORT、DE_MYSQL_DB、DE_MYSQL_USER、DE_MYSQL_PASSWORD,DE_EXTERNAL_MYSQL=false;
  2. 修改 dataease.properties (默认路径 /opt/dataease/conf/dataease.properties),将 spring.datasource 开头的几个参数里,MySQL 的配置参数进行相应的修改,包括:数据库地址、数据库端口、数据库库名、数据库用户名、数据库密码;
  3. 修改运行目录下 /opt/dataease/docker-compose.yml 文件,为 dataesae 服务加上 depends_on 相关设置,类似(镜像版本注意按实际情况替换):

    1. version: '2.1'
    2. services:
    3. dataease:
    4. image: registry.cn-qingdao.aliyuncs.com/dataease/dataease:v1.3.0
    5. container_name: dataease
    6. ports:
    7. - ${DE_PORT}:8081
    8. mem_limit: 4096m
    9. volumes:
    10. - ${DE_BASE}/dataease/conf:/opt/dataease/conf
    11. - ${DE_BASE}/dataease/logs:/opt/dataease/logs
    12. - ${DE_BASE}/dataease/plugins/thirdpart:/opt/dataease/plugins/thirdpart
    13. - ${DE_BASE}/dataease/data/kettle:/opt/dataease/data/kettle
    14. depends_on:
    15. mysql:
    16. condition: service_healthy
    17. networks:
    18. - dataease-network
    19. networks:
    20. dataease-network:
    21. driver: bridge
    22. ipam:
    23. driver: default
    24. config:
    25. - subnet: 172.19.0.0/16
    26. gateway: 172.19.0.1
  4. 重启 DataEase 服务: service dataease restart

5 使用 DataEase 时提示 “Row 30153 was cut by GROUP_CONCAT()” 的错误

当出现类似下图的错误时,可以通过任选以下方式之一处理:

  1. 修改 my.cnf 文件的 group_concat_max_len 参数,如:group_concat_max_len=1024000,然后重启 MySQL 与 DataEase 服务;
  2. 进入 MySQL,执行 SET GLOBAL group_concat_max_len=1024000; 临时修改该参数的值。

mysql-concat

6 安装 DataEase 后内置 MySQL 的配置参数未生效

注意: 出于安全考虑,当 MySQL 配置文件 my.cnf 权限过高时,会被 MySQL 忽略加载。请确认配置文件目录(默认路径 /opt/dataease/conf)下的配置文件的访问权限为 644。

可以通过命令修改文件权限:

  1. chmod 644 /opt/dataease/conf/*

修改文件属性后,重启 DataEase 服务: service dataease restart

7 使用 DataEase 时,出现数据库大小写的问题,提示类似”Table ‘datashowdb.V_AUTH_MODEL’ doesn’t exist” 的错误

出现该问题一般是由于 DataEase 使用的外部 MySQL 配置参数 lower_case_table_names 设置为 0 了。
需要将该参数设置为 lower_case_table_names=1,重启 MySQL 服务即可。

大小写

8 内置演示数据无效怎么办

在使用外部 MySQL,或者修改了内置 MySQL 容器名后,会出现内置演示数据无效的情况,如示例仪表板无法展示等待。可以登录 DataEase 控制台,进入到【数据源】页面,选择 “demo” 数据源,点击下方的编辑按钮,将 demo 数据源的相关连接信息按实际情况进行设置,校验通过后,保存即可。

9 使用 DataEase 的时候提示 “illegal mix of collations (latin1_bin implicit) and (utf8_general_ci coercible)” 的错误

该问题是由于字符集编码不同导致,可以参考下图的配置:
1. 更改 MySQL 的 my.cnf,把 client 和 server 的字符集改为 utf8;
2. 修改 collation 编码:

  1. set collation_database=utf8_general_ci;
  2. set collation_connection=utf8_general_ci;
  3. set collation_server=utf8_general_ci;

字符集

10 DataEase 启动失败,使用 MySQL 8.x 作为外置数据库

DataEase 启动过程中,抛出 Public Key Retrieval is not allowed 的异常。
解决方法:

  1. cd /opt/dataease/conf/dataease.properties

spring.datasource.url 最后加上 &allowPublicKeyRetrieval=true。