注意事项

本文基于 Ubuntu 22.04 做的适配，其他版本自行适配，使用时请留意版本兼容性。如遇疑难可通过 VX 或 QQ 群与作者交流。

在大数据集群与企业批量运维场景下，MariaDB 10.x 是兼容 Ambari 及 Hadoop 生态的理想数据库引擎，支持 utf8mb4，易于自动化运维，极大提升初始化效率和环境一致性。

1. 为什么选择 MariaDB 10？🤔

• 支持 utf8mb4，彻底解决中文及表结构索引报错
• 更强的 InnoDB 优化，支持更大内存池、日志管理与高并发
• 社区长期维护、和 MySQL 语法高度兼容
• 自动化脚本友好，所有关键参数和安全加固全可脚本化

相关异常示例：

Specified key was too long; max key length is 767 bytes

提示

MariaDB 10+ 解决了老版本（5.x）初始化表结构报错、乱码、索引过长等核心问题。

2. 配置 MariaDB 官方 APT 源并自动安装

2.1 推荐配置步骤

• 自动切换 APT 镜像至阿里云或 TUNA
• 添加 MariaDB 官方APT源（国内推荐阿里云源）
• 批量分发、自动刷新索引

sudo apt-get install -y software-properties-common gnupg2 curl lsb-release
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://mariadb.org/mariadb_release_signing_key.asc | sudo gpg --dearmor | sudo tee /etc/apt/keyrings/mariadb.gpg > /dev/null
echo "deb [signed-by=/etc/apt/keyrings/mariadb.gpg] https://mirrors.aliyun.com/mariadb/repo/10.11/ubuntu $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/mariadb.list
sudo apt-get update
sudo apt-get install -y mariadb-server mariadb-client

警告

不要用 yum/createrepo 等 RedHat 操作！Ubuntu 必须用 apt+官方 GPG KEY 体系。

MariaDB 10.11 阿里APT源结构截图

3. MariaDB 配置文件（兼容性与性能调优）

路径：/etc/mysql/my.cnf（或 /etc/mysql/mariadb.conf.d/50-server.cnf，以实际主文件为准）

[client]
default-character-set=utf8mb4

[mysqld]
user=mysql
port=3306
basedir=/usr
datadir=/var/lib/mysql
socket=/run/mysqld/mysqld.sock
pid-file=/run/mysqld/mysqld.pid

character-set-server=utf8mb4
collation-server=utf8mb4_unicode_ci
default-storage-engine=InnoDB

innodb_buffer_pool_size=1G
innodb_log_file_size=256M
innodb_file_per_table=1
innodb_thread_concurrency=8
bind-address=0.0.0.0
skip-name-resolve
max_connections=500

slow_query_log=1
slow_query_log_file=/var/log/mysql/slow-query.log
long_query_time=2

警告

配置文件路径和 RedHat 完全不同，Ubuntu 下 /etc/mysql/my.cnf 或 /etc/mysql/mariadb.conf.d/50-server.cnf ，而不是 /etc/my.cnf！

最佳实践图：my.cnf 结构说明

4. 数据库目录与服务初始化

MariaDB 在 Ubuntu 下首次安装自动完成初始化，无需手动 mysql_install_db：

sudo systemctl restart mariadb
sudo systemctl enable mariadb

• 检查状态

  sudo systemctl status mariadb
  

• 数据文件目录为 /var/lib/mysql/，无需特殊授权

5. MariaDB 安全加固与 root 远程授权

5.1 安全初始化（自动化 expect 或脚本应答）

sudo mysql_secure_installation

常见交互建议：

1. Enter current password for root (enter for none): 回车
2. Switch to unix_socket authentication [Y/n]: n
3. Change the root password? [Y/n]: y（建议设定强密码）
4. Remove anonymous users? [Y/n]: y
5. Disallow root login remotely? [Y/n]: n（需要远程请选 n）
6. Remove test database and access to it? [Y/n]: y
7. Reload privilege tables now? [Y/n]: y

5.2 批量自动授权 root 远程连接

ALTER USER 'root'@'localhost' IDENTIFIED VIA mysql_native_password USING PASSWORD('root');
CREATE USER IF NOT EXISTS 'root'@'%' IDENTIFIED BY 'root';
GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' WITH GRANT OPTION;
FLUSH PRIVILEGES;

• 推荐自动化脚本或 expect 工具实现无人值守配置

5.3 验证远程连接

mysql -uroot -p'root' -h 192.168.3.1 -e "SELECT 1;"

• 如返回 1，说明远程连接和授权已完成

6. MySQL Connector/J 驱动批量部署

1. 所有 JDBC 组件建议统一用 MySQL 5.1.48 或官方最新版
2. 下载地址、分发路径、软连接操作见自动化脚本参数
3. Ambari 等依赖建议统一软连接 /usr/share/java/mysql-connector-java.jar

wget https://mirrors.aliyun.com/mysql/Connector-J/mysql-connector-java-5.1.48.tar.gz
tar -xzf mysql-connector-java-5.1.48.tar.gz
sudo cp mysql-connector-java-5.1.48/mysql-connector-java-5.1.48-bin.jar /usr/share/java/mysql-connector-java.jar