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:
    4.   dataease:
    5.     image: registry.cn-qingdao.aliyuncs.com/dataease/dataease:v1.3.0
    6.     container_name: dataease
    7.     ports:
    8.       - ${DE_PORT}:8081
    9.     mem_limit: 4096m
    10.     volumes:
    11.       - ${DE_BASE}/dataease/conf:/opt/dataease/conf
    12.       - ${DE_BASE}/dataease/logs:/opt/dataease/logs
    13.       - ${DE_BASE}/dataease/plugins/thirdpart:/opt/dataease/plugins/thirdpart
    14.       - ${DE_BASE}/dataease/data/kettle:/opt/dataease/data/kettle
    15.     depends_on:
    16.       mysql:
    17.         condition: service_healthy
    18.     networks:
    19.       - dataease-network
    21. networks:
    22.   dataease-network:
    23.     driver: bridge
    24.     ipam:
    25.       driver: default
    26.       config:
    27.         - subnet: 172.19.0.0/16
    28.           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。