MySQL / 知识点
MySQL 命令行速查手册
备份与恢复
mysqldump [OPTIONS] --single-transaction <DATABASE>在线备份以 InnoDB 为主的单个数据库,并尽量避免长时间锁表。
一致性备份单个数据库
日常逻辑备份 InnoDB 数据库时,--single-transaction 是推荐起点。它在一致性快照中导出事务表;导出期间不要执行会改变表定义的 DDL。
语法 / 签名
mysqldump [OPTIONS] --single-transaction <DATABASE>推荐用法
mysqldump \
--login-path=<LOGIN_PATH> \
--single-transaction \
--quick \
--routines \
--triggers \
--events \
<DATABASE> \
> <PATH>/<DATABASE>.sql关键参数
| 参数 | 作用 |
|---|---|
--single-transaction |
InnoDB 一致性快照 |
--quick |
逐行读取,降低客户端内存 |
--routines |
包含存储过程/函数 |
--triggers |
包含触发器;通常默认开启 |
--events |
包含 Event Scheduler 事件 |
验证
test -s <PATH>/<DATABASE>.sql && head -n 20 <PATH>/<DATABASE>.sql版本兼容
MySQL 5.7 / 8.0 / 8.4 均支持这些核心参数。8.4 对数据字典处理有变化,因此全实例备份更应显式写 --routines --events。
生产边界
--single-transaction 只保证事务表的一致性。MyISAM 等非事务表仍可能变化;导出期间执行 ALTER/DROP/RENAME/TRUNCATE 也会破坏一致性。
相关条目: 备份全部数据库、恢复 mysqldump 备份
mysqldump [OPTIONS] <DATABASE> <TABLE> [TABLE ...]只导出一个数据库中的指定表,适合变更前局部备份或小范围迁移。
备份指定表
只修改少数表、不需要整库备份时使用。表很多时仍应考虑整库备份,避免遗漏触发器、依赖对象或关联表。
语法 / 签名
mysqldump [OPTIONS] <DATABASE> <TABLE> [TABLE ...]推荐用法
mysqldump --login-path=<LOGIN_PATH> \
--single-transaction --quick \
<DATABASE> <TABLE_1> <TABLE_2> \
> <PATH>/tables.sql验证
grep -E '^CREATE TABLE|^INSERT INTO' <PATH>/tables.sql | head版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
相关条目: 只备份表结构、只备份数据
mysqldump [OPTIONS] --databases <DB1> <DB2> ...一次导出多个完整数据库,并在 dump 中包含 CREATE DATABASE 与 USE 语句。
备份多个数据库
多个业务库需要一起迁移或保留同一时间窗口的逻辑备份时使用。
语法 / 签名
mysqldump [OPTIONS] --databases <DB1> <DB2> ...推荐用法
mysqldump --login-path=<LOGIN_PATH> \
--single-transaction --quick \
--routines --triggers --events \
--databases <DB1> <DB2> \
> <PATH>/multi-db.sql验证
grep -E '^CREATE DATABASE|^USE ' <PATH>/multi-db.sql | head版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
生产边界
多个数据库中如果包含非事务表,仍不能保证跨库绝对一致快照。
相关条目: 一致性备份单个数据库、备份全部数据库
mysqldump [OPTIONS] --all-databases逻辑导出当前实例可见的全部数据库。
备份全部数据库
实例迁移、灾备留档或升级前全量逻辑备份时使用。不要把它误认为完整物理备份;用户权限、系统对象和插件相关状态仍需结合目标版本评估。
语法 / 签名
mysqldump [OPTIONS] --all-databases推荐用法
mysqldump --login-path=<LOGIN_PATH> \
--single-transaction --quick \
--routines --triggers --events \
--all-databases \
> <PATH>/all-databases.sql验证
test -s <PATH>/all-databases.sql && grep -m 5 '^CREATE DATABASE' <PATH>/all-databases.sql版本兼容
5.7/8.0/8.4 都支持 --all-databases。MySQL 8.4 起数据字典实现变化使得全库 dump 不再隐式依赖旧系统表包含 routines/events,因此建议始终显式写 --routines --events。
生产边界
全实例逻辑备份文件可能非常大,也可能包含敏感数据。必须限制文件权限,并验证能恢复,而不是只验证文件存在。
相关条目: 一致性备份单个数据库、恢复 mysqldump 备份
mysqldump [OPTIONS] --no-data <DATABASE> [TABLE ...]只导出 DDL,不导出表数据。
只备份表结构
做 schema 对比、创建测试环境、评审表结构或迁移前检查时使用。
语法 / 签名
mysqldump [OPTIONS] --no-data <DATABASE> [TABLE ...]推荐用法
mysqldump --login-path=<LOGIN_PATH> \
--no-data \
--routines --triggers --events \
<DATABASE> > <PATH>/schema.sql验证
grep -E '^CREATE TABLE|^CREATE VIEW|^CREATE.*PROCEDURE|^CREATE.*FUNCTION' <PATH>/schema.sql | head版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
相关条目: 只备份数据、备份指定表
mysqldump [OPTIONS] --no-create-info <DATABASE> [TABLE ...]只导出数据 INSERT,不输出 CREATE TABLE。
只备份数据
目标环境已经有兼容表结构,只需要迁移或补充数据时使用。
语法 / 签名
mysqldump [OPTIONS] --no-create-info <DATABASE> [TABLE ...]推荐用法
mysqldump --login-path=<LOGIN_PATH> \
--single-transaction --quick \
--no-create-info \
<DATABASE> <TABLE> \
> <PATH>/data.sql验证
grep -m 5 '^INSERT INTO' <PATH>/data.sql版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
生产边界
目标 schema 必须兼容源数据。跨版本、字符集或列类型变化时,先做小规模恢复验证。
相关条目: 只备份表结构、导出部分数据
mysqldump [OPTIONS] --where='<CONDITION>' <DATABASE> <TABLE>按 WHERE 条件导出单表的部分行。
导出部分数据
迁移一个时间段、某个租户或小范围修复数据时使用。WHERE 条件由服务端执行,务必先用 SELECT 验证影响范围。
语法 / 签名
mysqldump [OPTIONS] --where='<CONDITION>' <DATABASE> <TABLE>推荐用法
mysqldump --login-path=<LOGIN_PATH> \
--single-transaction --quick \
--no-create-info \
--where='id >= <MIN_ID> AND id < <MAX_ID>' \
<DATABASE> <TABLE> > <PATH>/partial.sql验证
grep -c '^INSERT INTO' <PATH>/partial.sql版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
生产边界
--where 只适用于本次指定的表。条件写错可能导出过多或过少数据;生产使用前先执行等价 COUNT/SELECT。
相关条目: 只备份数据、恢复 mysqldump 备份
mysqldump [OPTIONS] --routines --triggers --events <DATABASE>确保逻辑备份同时包含 stored routines、triggers 和 Event Scheduler 事件。
备份存储过程、触发器和事件
数据库不仅有表数据,还依赖触发器、过程、函数或定时事件时必须显式检查这些对象。只备份表并不能完整恢复业务行为。
语法 / 签名
mysqldump [OPTIONS] --routines --triggers --events <DATABASE>推荐用法
mysqldump --login-path=<LOGIN_PATH> \
--single-transaction --quick \
--routines --triggers --events \
<DATABASE> > <PATH>/full-objects.sql验证
grep -E 'TRIGGER|PROCEDURE|FUNCTION|EVENT' <PATH>/full-objects.sql | head版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。--triggers 通常默认启用;--routines 与 --events 应显式写出,特别是 8.4 全实例备份。
相关条目: 一致性备份单个数据库、备份全部数据库
mysqldump [OPTIONS] --no-tablespaces <DATABASE>在普通备份账号缺少 PROCESS 等相关权限时,不输出 tablespace 创建信息。
降低 tablespace 权限依赖
云数据库、受限备份账号或出现 tablespace 权限错误时使用。它不是绕过所有权限检查,只是减少与 tablespace 元数据有关的要求。
语法 / 签名
mysqldump [OPTIONS] --no-tablespaces <DATABASE>推荐用法
mysqldump --login-path=<LOGIN_PATH> \
--single-transaction --quick \
--no-tablespaces \
<DATABASE> > <PATH>/backup.sql验证
test -s <PATH>/backup.sql版本兼容
该选项在现代 mysqldump 中常用于受限账号。若维护老 5.7 小版本,先运行 mysqldump --help | grep tablespaces 确认客户端是否支持。
常见问题
- 仍然
Access denied:按错误对象补SELECT、SHOW VIEW、TRIGGER、EVENT等最小权限,不要直接给全局管理员权限。
相关条目: 一致性备份单个数据库、查看工具帮助
mysqldump [OPTIONS] --set-gtid-purged=OFF|AUTO|ON <DATABASE>控制 dump 文件是否写入 GTID_PURGED 相关语句,避免跨环境恢复时污染或冲突 GTID 状态。
控制 GTID 导出行为
开启 GTID 的复制环境、跨实例迁移、从生产恢复到测试环境时必须明确决定是否携带 GTID 信息。普通业务库迁移到无关实例时常使用 OFF。
语法 / 签名
mysqldump [OPTIONS] --set-gtid-purged=OFF|AUTO|ON <DATABASE>推荐用法
mysqldump --login-path=<LOGIN_PATH> \
--single-transaction --quick \
--set-gtid-purged=OFF \
<DATABASE> > <PATH>/backup.sql验证
grep -n 'GTID_PURGED' <PATH>/backup.sql || true版本兼容
MySQL 5.7 / 8.0 / 8.4 都存在 GTID 与该类导出控制,但默认行为和复制术语会随版本演进。生产恢复前按目标拓扑确认。
生产边界
不要机械使用 OFF 或 ON。复制重建、灾备恢复和普通数据迁移目标不同;错误 GTID 处理可能影响后续复制拓扑。
相关条目: 跨版本备份迁移、回放 Binlog
mysqldump [COMPATIBLE_OPTIONS] <SOURCE_DB> > dump.sql在 MySQL 5.7 与 8.0/8.4 之间迁移时,先用逻辑备份建立可审查、可回滚的迁移边界。
跨版本备份迁移
跨大版本升级不要只复制数据目录。优先在隔离环境验证 dump、字符集、SQL mode、认证方式、保留对象和恢复耗时,再安排正式迁移。
语法 / 签名
mysqldump [COMPATIBLE_OPTIONS] <SOURCE_DB> > dump.sql推荐用法
mysqldump --login-path=<SOURCE> \
--single-transaction --quick \
--routines --triggers --events \
--set-gtid-purged=OFF \
<DATABASE> > <PATH>/migration.sql验证
mysqldump --version
mysql --version
head -n 30 <PATH>/migration.sql版本兼容
本手册以 5.7 / 8.0 / 8.4 为覆盖范围。跨大版本时以“源服务端 + 实际 mysqldump 客户端 + 目标服务端”三者组合做验证。
常见问题
- 如果用较新的 8.0 客户端连接 5.7 服务端并遇到客户端专属元数据参数问题,先用
mysqldump --help检查参数,再按该客户端版本关闭不兼容特性;不要把某个 8.0 客户端参数写成所有 5.7 通用规则。 - 迁移成功不等于应用兼容;还要验证认证插件、排序规则、SQL mode 和保留字变化。
相关条目: 查看 MySQL 客户端版本、恢复 mysqldump 备份
mysql [CONNECTION_OPTIONS] < <PATH>/backup.sql把 mysqldump 生成的逻辑备份重新执行到目标 MySQL。
恢复 mysqldump 备份
灾备恢复、环境复制、迁移导入时使用。恢复前先确认 dump 是否包含 CREATE DATABASE / USE;这决定命令中是否需要显式指定数据库。
语法 / 签名
mysql [CONNECTION_OPTIONS] < <PATH>/backup.sql推荐用法
mysql --login-path=<TARGET> <DATABASE> < <PATH>/backup.sql验证
echo $?
mysql --login-path=<TARGET> <DATABASE> -e "SHOW TABLES;"版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。跨版本恢复时先在隔离实例验证 SQL 兼容性。
生产边界
恢复会执行 dump 中的 DROP/CREATE/INSERT/SET 等语句。目标环境必须先备份,生产恢复应在维护窗口并记录恢复点。
相关条目: 一致性备份单个数据库、跨版本备份迁移
mysqldump ... | gzip > backup.sql.gz在逻辑备份过程中流式压缩文件,降低磁盘占用和传输成本。
压缩备份与恢复
备份体积较大且 CPU 有余量时使用。管道中的任一命令失败都要被检测,不能只看最后的 gzip 是否成功。
语法 / 签名
mysqldump ... | gzip > backup.sql.gz推荐用法
set -o pipefail
mysqldump --login-path=<LOGIN_PATH> \
--single-transaction --quick \
<DATABASE> | gzip -c > <PATH>/backup.sql.gz验证
gzip -t <PATH>/backup.sql.gz版本兼容
MySQL 版本无关;gzip 属于操作系统工具。
生产边界
恢复前仍应验证逻辑内容。Shell 脚本建议启用 set -o pipefail,否则 mysqldump 失败时可能留下一个看似正常的压缩文件。
相关条目: 一致性备份单个数据库、恢复 mysqldump 备份
服务管理与检查
mysqladmin [CONNECTION_OPTIONS] ping快速判断 MySQL 服务端是否接受客户端连接并响应管理命令。
检查服务是否响应
部署后健康检查、连接故障初步定位或自动化探测时使用。
语法 / 签名
mysqladmin [CONNECTION_OPTIONS] ping推荐用法
mysqladmin --login-path=<LOGIN_PATH> ping预期结果:
mysqld is alive验证
echo $?版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
常见问题
- 能返回 alive 只表示服务能响应,不代表复制、磁盘、锁等待和业务 SQL 都健康。
相关条目: 查看服务状态、连接远程 MySQL
mysqladmin [CONNECTION_OPTIONS] status查看 uptime、线程、查询计数等简要运行状态。
查看服务状态
只想快速确认实例是否重启、当前连接量和查询活动时使用;深入诊断仍应结合 performance_schema 和监控系统。
语法 / 签名
mysqladmin [CONNECTION_OPTIONS] status推荐用法
mysqladmin --login-path=<LOGIN_PATH> status预期结果:
Uptime: <SECONDS> Threads: <COUNT> Questions: <COUNT> ...版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
相关条目: 检查服务是否响应、查看扩展状态
mysqladmin [CONNECTION_OPTIONS] extended-status输出服务器状态变量,便于快速采样连接、缓存、读写和 InnoDB 相关计数。
查看扩展状态
临时诊断需要一次读取状态变量时使用。持续监控应交给指标系统,避免人工高频轮询。
语法 / 签名
mysqladmin [CONNECTION_OPTIONS] extended-status推荐用法
mysqladmin --login-path=<LOGIN_PATH> extended-status预期结果:
+--------------------------+-----------+
| Variable_name | Value |
...版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
相关条目: 查看服务状态、查看进程列表
mysqladmin [CONNECTION_OPTIONS] processlist从命令行查看当前连接和正在执行的语句。
查看进程列表
连接数突然升高、查询卡住或需要定位长时间运行线程时使用。需要完整 SQL 时优先加 --verbose 或进入 mysql 执行 SHOW FULL PROCESSLIST。
语法 / 签名
mysqladmin [CONNECTION_OPTIONS] processlist推荐用法
mysqladmin --login-path=<LOGIN_PATH> --verbose processlist预期结果:
+----+------+-----------+------+---------+------+-------+------------------+
...版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
生产边界
进程列表可能暴露 SQL 文本和业务参数,分享日志前要脱敏。
相关条目: 终止指定连接、纵向显示结果
mysqladmin [CONNECTION_OPTIONS] kill <ID>终止明确确认的 MySQL 连接或执行线程。
终止指定连接
锁等待、失控查询或异常客户端确认需要人工干预时使用。先记录线程 ID、用户、来源、SQL 和事务状态,再决定是否 kill。
语法 / 签名
mysqladmin [CONNECTION_OPTIONS] kill <ID>推荐用法
mysqladmin --login-path=<LOGIN_PATH> kill <CONNECTION_ID>验证
mysqladmin --login-path=<LOGIN_PATH> processlist版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
生产边界
高风险操作。终止正在事务中的连接会触发回滚,回滚本身可能持续很久并继续占用资源。不要根据“运行时间长”单一指标直接 kill。
相关条目: 查看进程列表、查看服务状态
mysqladmin [CONNECTION_OPTIONS] shutdown通过 MySQL 管理接口请求服务正常关闭。
安全关闭 MySQL
自建实例维护或测试环境需要优雅停止 mysqld 时使用。systemd 管理的生产服务器通常优先通过服务管理器执行,并记录变更流程。
语法 / 签名
mysqladmin [CONNECTION_OPTIONS] shutdown推荐用法
mysqladmin --login-path=<ADMIN_LOGIN_PATH> shutdown验证
mysqladmin --login-path=<ADMIN_LOGIN_PATH> ping版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
生产边界
高风险操作,会停止整个实例。共享实例、主库或生产环境执行前必须确认角色、流量切换和恢复方案。
相关条目: 检查服务是否响应
mysqlcheck [CONNECTION_OPTIONS] <DATABASE>使用 mysqlcheck 请求服务器检查表状态。
检查数据库表
怀疑表损坏、升级后需要检查、或做维护巡检时使用。对 InnoDB 不要把 mysqlcheck 当作万能修复工具。
语法 / 签名
mysqlcheck [CONNECTION_OPTIONS] <DATABASE>推荐用法
mysqlcheck --login-path=<LOGIN_PATH> <DATABASE>预期结果:
<DATABASE>.<TABLE> OK版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
常见问题
- 出现错误时先确认存储引擎和错误类型,再选择恢复或重建方案,不要直接尝试破坏性修复。
相关条目: 分析表统计信息、查看服务状态