joseluisq/alpine-mysql-client

Alpine MySQL Client

https://github.com/joseluisq/alpine-mysql-client/actions/workflows/devel.yml/badge.svg](https://github.com/joseluisq/alpine-mysql-client/actions/workflows/devel.yml) !Docker Image Size !Docker Image Version !Docker Pulls

MySQL客户端（MariaDB Client），用于通过Docker轻松导出和导入数据库。

注意： 如果你需要MySQL 8客户端，请前往https://github.com/joseluisq/alpine-mysql-client%E9%A1%B9%E7%9B%AE%E3%80%82

🐳 在https://hub.docker.com/r/joseluisq/alpine-mysql-client/%E6%9F%A5%E7%9C%8B

MySQL客户端程序

注意： MySQL客户端（mariadb-client）是mysql-client迁移工具的别名包。

sh
mysql
mysql_find_rows
mysql_waitpid
mysqladmin
mysqldump
mysqlimport
mysql-export
mysql_fix_extensions
mysqlaccess
mysqlcheck
mysqldumpslow
mysqlshow

更多详情请查看：

• MariaDB 10 - 客户端和实用工具
• MySQL 8 - 客户端程序

使用方法

sh
docker run -it --rm joseluisq/alpine-mysql-client mysql --version
# mysql  Ver 15.1 Distrib 10.6.4-MariaDB，适用于Linux (x86_64)，使用readline 5.1

用户权限

• 默认用户（非特权用户）为mysql。
• mysql的主目录位于/home/mysql。
• 如果你需要完全特权用户，请使用root。例如，在docker run命令后添加--user root参数。

附加工具

此镜像包含一些附加工具。

导出器

mysql_exporter是一个自定义工具，使用mysqldump导出数据库脚本，还支持gzip压缩。可通过环境变量或.env文件进行配置。

通过环境变量配置

env
# 连接设置（可选）
DB_PROTOCOL=tcp
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DEFAULT_CHARACTER_SET=utf8

# GZip导出文件（可选）
DB_EXPORT_GZIP=false

# SQL或Gzip导出文件（可选）。
# 如果`DB_IMPORT_GZIP`为`true`，则文件名应为`database_name.sql.gz`
DB_EXPORT_FILE_PATH=database_name.sql

# 数据库设置（必填）
DB_NAME=""
DB_USERNAME=""
DB_PASSWORD=""

# 附加参数（可选）
DB_ARGS=

注意：

• DB_EXPORT_GZIP=true：使用Gzip压缩SQL文件（可选）。如果为false或未定义，则导出文件为.sql格式。
• DB_ARGS：可用于传递更多mysqldump参数（可选）。
• 示例.env文件可在./mysql_exporter.env找到。

使用Docker容器导出数据库

以下Docker命令创建一个容器来导出数据库，完成后自动删除容器。

注意： mysql_exporter支持环境变量或作为参数传递的.env文件。

sh
docker run --rm -it \
    --user $(id -u $USER):$(id -g $USER) \
    --volume $PWD:/home/mysql/sample \
    --workdir /home/mysql/sample \
        joseluisq/alpine-mysql-client:1 \
        mysql_exporter production.env

# Alpine / MySQL客户端 - 导出器
# ================================
# mysqldump  Ver 10.17 Distrib 10.4.12-MariaDB，适用于Linux (x86_64)
# 将数据库`mydb`导出为SQL脚本文件...
# 输出文件：mydb.sql.gz（SQL GZipped）
# 数据库`mydb`已成功导出，耗时0秒！
# 导出文件：mydb.sql.gz（10M / SQL GZipped）

注意：

• --volume $PWD:/home/mysql/sample：指定从主机到容器的绑定挂载目录。
• $PWD是主机的工作目录，请替换为你自己的路径。
• /home/mysql/是默认的用户主目录（可选）。参见上文用户权限部分。
• /home/mysql/sample是Docker将为我们创建的容器内目录。
• --workdir /home/mysql/sample：指定容器内默认的工作目录。
• production.env是作为参数传递的自定义env文件路径，该文件应在你的主机工作目录中可用（例如我的$PWD）。

导入器

mysql_importer是一个自定义工具，使用mysql命令导入SQL脚本文件（文本或Gzip格式）。可通过环境变量或.env文件进行配置。

通过环境变量配置

env
# 连接设置（可选）
DB_PROTOCOL=tcp
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DEFAULT_CHARACTER_SET=utf8

# GZip导入支持（可选）
DB_IMPORT_GZIP=false

# SQL或Gzip导入文件（必填）
# 如果`DB_IMPORT_GZIP`为`true`，则文件名应为`database_name.sql.gz`
DB_IMPORT_FILE_PATH=database_name.sql

# 数据库设置（必填）
DB_NAME=""
DB_USERNAME=""
DB_PASSWORD=""

# 附加参数（可选）
DB_ARGS=

使用Docker容器导入SQL脚本

以下Docker命令创建一个容器，将SQL脚本文件导入指定数据库，完成后删除容器。

注意： mysql_importer支持环境变量或作为参数传递的.env文件。

sh
docker run --rm -it \
    --user $(id -u $USER):$(id -g $USER) \
    --volume $PWD:/home/mysql/sample \
    --workdir /home/mysql/sample \
        joseluisq/alpine-mysql-client:1 \
        mysql_importer production.env

# Alpine / MySQL客户端 - 导入器
# ================================
# mysql  Ver 15.1 Distrib 10.4.12-MariaDB，适用于Linux (x86_64)，使用readline 5.1
# 将SQL脚本文件导入数据库`dbtesting`...
# 输入文件：mydb.sql.gz（10M / SQL GZipped）
# 数据库`dbtesting`已成功导入，耗时1秒！

贡献

欢迎提交https://github.com/joseluisq/alpine-mysql-client/pulls%E6%88%96%E6%8A%A5%E5%91%8Ahttps://github.com/joseluisq/alpine-mysql-client/issues%E3%80%82

许可证

MIT许可证

© 2020年至今 Jose Quintana