MySQL / 知识点
MySQL 命令行速查手册
凭据与客户端配置
mysql_config_editor set --login-path=<NAME> --host=<HOST> --user=<USER> --password把常用连接参数写入 .mylogin.cnf,避免密码直接出现在命令行。
使用 login-path 保存连接配置
开发机、运维机或自动化脚本需要反复使用 MySQL 官方客户端时,优先创建命名 login-path。密码会交互输入,不回显。
语法 / 签名
mysql_config_editor set --login-path=<NAME> --host=<HOST> --user=<USER> --password推荐用法
mysql_config_editor set \
--login-path=<NAME> \
--host=<HOST> \
--port=<PORT> \
--user=<USER> \
--password预期结果:
Enter password:验证
mysql_config_editor print --login-path=<NAME>
mysql --login-path=<NAME> -e "SELECT VERSION();"版本兼容
MySQL 5.7 / 8.0 / 8.4 均支持 mysql_config_editor 与 --login-path。
生产边界
.mylogin.cnf 是混淆存储,不是不可破解的密码保险箱。仍必须依赖操作系统文件权限和账号最小权限。
相关条目: 查看或删除 login-path、连接远程 MySQL
mysql_config_editor print|remove [OPTIONS]检查现有 login-path 配置,或删除不再使用的连接配置。
查看或删除 login-path
主机、账号或密码更换后,先确认当前 login-path 内容,再更新或移除旧配置。print 会把密码显示为 *****。
语法 / 签名
mysql_config_editor print|remove [OPTIONS]推荐用法
mysql_config_editor print --all
mysql_config_editor remove --login-path=<OLD_NAME>预期结果:
[<NAME>]
user = <USER>
password = *****
host = <HOST>验证
mysql_config_editor print --all版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
相关条目: 使用 login-path 保存连接配置
my_print_defaults <GROUP> [GROUP ...]查看 MySQL option file 中某个配置组实际提供了哪些客户端参数。
检查客户端默认配置
怀疑 mysql 自动读取了错误 host、socket、user 或其他默认项时,用它排查 option file 合并结果。
语法 / 签名
my_print_defaults <GROUP> [GROUP ...]推荐用法
my_print_defaults client mysql预期结果:
--host=<HOST>
--user=<USER>
...验证
mysql --print-defaults版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。login-path 另由 .mylogin.cnf 参与客户端配置读取。
生产边界
不要使用会把密码明文打印出来的选项把输出写进日志或工单。客户端默认文件也应限制权限。
相关条目: 使用 login-path 保存连接配置、查看 MySQL 客户端版本
Binlog 与时间点恢复
mysqlbinlog <BINLOG_FILE>把 MySQL binary log 转换为可阅读或可重新执行的文本形式。
读取本地 Binlog
排查数据变更、复制问题或时间点恢复前,先读取 binlog 确认事件范围。对 row 格式事件,普通输出会包含编码后的 BINLOG 语句。
语法 / 签名
mysqlbinlog <BINLOG_FILE>推荐用法
mysqlbinlog <PATH>/binlog.000001 | less预期结果:
# at <POSITION>
#<TIME> server id <ID> ...验证
mysqlbinlog --version版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
生产边界
Binlog 可能包含完整业务数据和 DDL/DML。输出文件按备份数据同等级保护。
相关条目: 解码 Row Binlog、按时间范围读取 Binlog
mysqlbinlog --base64-output=DECODE-ROWS --verbose <BINLOG_FILE>把 row-based binlog 事件以更易读的伪 SQL 形式展示。
解码 Row Binlog
需要人工分析某行数据是如何 INSERT/UPDATE/DELETE 时使用。该模式用于阅读,不应把它的输出直接当作可回放 SQL。
语法 / 签名
mysqlbinlog --base64-output=DECODE-ROWS --verbose <BINLOG_FILE>推荐用法
mysqlbinlog \
--base64-output=DECODE-ROWS \
--verbose \
<PATH>/binlog.000001 | less预期结果:
### UPDATE `<DATABASE>`.`<TABLE>`
### WHERE
### @1=<OLD_VALUE>
### SET
### @1=<NEW_VALUE>版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
生产边界
官方文档明确提醒:如果目的是重新执行 mysqlbinlog 输出,不要使用 DECODE-ROWS 去掉原始 BINLOG 语句。
相关条目: 读取本地 Binlog、回放 Binlog
mysqlbinlog --start-datetime='<TIME>' --stop-datetime='<TIME>' <BINLOG_FILE>按事件时间截取 Binlog,用于定位故障窗口或时间点恢复。
按时间范围读取 Binlog
已知误操作大致发生时间时,先在副本文件上截取时间范围人工确认,再决定恢复边界。
语法 / 签名
mysqlbinlog --start-datetime='<TIME>' --stop-datetime='<TIME>' <BINLOG_FILE>推荐用法
mysqlbinlog \
--start-datetime='<START_TIME>' \
--stop-datetime='<STOP_TIME>' \
<PATH>/binlog.000001 > <PATH>/window.sql验证
head -n 30 <PATH>/window.sql版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
生产边界
时间边界受服务器事件时间影响,不能只凭业务日志时间猜测。真正恢复前还要核对 binlog position/GTID 和事务边界。
相关条目: 按位置范围读取 Binlog、回放 Binlog
mysqlbinlog --start-position=<POS> --stop-position=<POS> <BINLOG_FILE>按 Binlog event position 精确截取事件范围。
按位置范围读取 Binlog
已经从错误日志、SHOW MASTER STATUS/相关监控或上一次 mysqlbinlog 输出得到 position 时使用,比模糊时间边界更精确。
语法 / 签名
mysqlbinlog --start-position=<POS> --stop-position=<POS> <BINLOG_FILE>推荐用法
mysqlbinlog \
--start-position=<START_POS> \
--stop-position=<STOP_POS> \
<PATH>/binlog.000001 > <PATH>/segment.sql验证
head -n 30 <PATH>/segment.sql版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
常见问题
- position 必须落在有效事件边界;随意填中间字节位置可能报错。
相关条目: 按时间范围读取 Binlog、读取本地 Binlog
mysqlbinlog [RANGE_OPTIONS] <BINLOG_FILE> | mysql [CONNECTION_OPTIONS]把确认过范围的 Binlog 事件重新应用到目标 MySQL,完成增量或时间点恢复。
回放 Binlog
先恢复全量备份,再把备份点之后到目标时间点的 binlog 连续回放。多个 binlog 文件应尽量通过同一个 mysql 连接顺序执行。
语法 / 签名
mysqlbinlog [RANGE_OPTIONS] <BINLOG_FILE> | mysql [CONNECTION_OPTIONS]推荐用法
set -o pipefail
mysqlbinlog \
--start-position=<START_POS> \
--stop-datetime='<STOP_TIME>' \
<PATH>/binlog.000001 <PATH>/binlog.000002 \
| mysql --login-path=<TARGET>验证
echo $?
# 然后执行针对业务表的完整性校验版本兼容
MySQL 5.7 / 8.0 / 8.4 都支持基于 mysqlbinlog 的 PITR;8.x 中复制权限命名与 5.7 有变化,应按目标版本配置最小权限。
生产边界
高风险恢复操作。必须先在隔离环境验证边界;不要把包含误操作事件的范围重新回放。Row event 回放还需要相应权限。
相关条目: 一致性备份单个数据库、按时间范围读取 Binlog、按位置范围读取 Binlog
mysqlbinlog --read-from-remote-server [CONNECTION_OPTIONS] <LOG_NAME>直接从 MySQL 服务端读取指定 binary log,而不是先访问服务器文件系统。
读取远程 Binlog
无权登录数据库主机、使用云数据库,或希望通过 MySQL 协议拉取 binlog 时使用。
语法 / 签名
mysqlbinlog --read-from-remote-server [CONNECTION_OPTIONS] <LOG_NAME>推荐用法
mysqlbinlog \
--read-from-remote-server \
--host=<HOST> --port=<PORT> --user=<USER> --password \
<BINLOG_NAME>预期结果:
# at <POSITION>
...版本兼容
5.7 / 8.0 / 8.4 都有远程读取能力,但复制术语和部分认证要求不同;实际参数以 mysqlbinlog --help 和目标版本权限模型为准。
生产边界
不要把密码直接拼到 --password=<PASSWORD>。远程读取账号应只授予必要复制/日志读取权限,并优先走 TLS。
相关条目: 读取本地 Binlog、使用 TLS 验证服务器身份
辅助工具与诊断
mysqlshow [OPTIONS] [DATABASE [TABLE [COLUMN]]]不用进入 mysql 交互终端即可逐层查看数据库、表和列概览。
查看数据库与表概览
脚本或临时检查只需要结构概览时使用;需要完整 DDL 仍应执行 SHOW CREATE TABLE。
语法 / 签名
mysqlshow [OPTIONS] [DATABASE [TABLE [COLUMN]]]推荐用法
mysqlshow --login-path=<LOGIN_PATH>
mysqlshow --login-path=<LOGIN_PATH> <DATABASE>
mysqlshow --login-path=<LOGIN_PATH> <DATABASE> <TABLE>预期结果:
Databases
+--------------------+
| <DATABASE> |
...版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
相关条目: 检查数据库表、查看工具帮助
mysqlimport [OPTIONS] <DATABASE> <FILE>使用 LOAD DATA 机制把文本文件批量导入表。
批量导入分隔文本
已有 CSV/TSV 等结构化文本并且表已创建时使用。文件名通常参与推导目标表名,生产导入前先用小样本验证列顺序、编码和分隔符。
语法 / 签名
mysqlimport [OPTIONS] <DATABASE> <FILE>推荐用法
mysqlimport --login-path=<LOGIN_PATH> \
--local \
--fields-terminated-by=',' \
--lines-terminated-by='\n' \
<DATABASE> <PATH>/<TABLE>.csv预期结果:
<DATABASE>.<TABLE>: Records: <COUNT> Deleted: 0 Skipped: 0 Warnings: 0版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
生产边界
--local 会让客户端读取本地文件并上传。受控环境才开启;CSV 中包含换行、引号、NULL 或不同编码时必须显式设计格式。
相关条目: 执行 SQL 文件、查看客户端警告
mysqldumpslow [OPTIONS] <SLOW_LOG>对 MySQL slow query log 做简单聚合排序,快速找出高耗时或高频 SQL 模式。
分析慢查询日志
没有完整 APM/性能平台、需要直接分析服务器慢日志文件时使用。它适合初筛,不替代 performance_schema、EXPLAIN 和真实执行计划分析。
语法 / 签名
mysqldumpslow [OPTIONS] <SLOW_LOG>推荐用法
mysqldumpslow -s t -t 20 <PATH>/mysql-slow.log预期结果:
Count: <COUNT> Time=<AVG_TIME>s ...
SELECT ...关键参数
| 参数 | 作用 |
|---|---|
-s t |
按查询时间排序 |
-t 20 |
只显示前 20 个模式 |
版本兼容
MySQL 5.7 / 8.0 / 8.4 工具链通常都提供 mysqldumpslow。
生产边界
慢日志可能包含 SQL 参数和敏感业务值;复制到本地分析时要控制权限与脱敏。
相关条目: 查看进程列表、查看服务状态
mysqlslap [OPTIONS]用 MySQL 自带工具模拟多个客户端执行 SQL,做基础并发基准。
使用 mysqlslap 做基准测试
开发/压测环境比较配置或版本差异时使用。不要直接对生产执行默认或高并发压测。
语法 / 签名
mysqlslap [OPTIONS]推荐用法
mysqlslap \
--login-path=<TEST_LOGIN_PATH> \
--concurrency=10 \
--iterations=3 \
--query='<SQL>' \
--create-schema=<DATABASE>预期结果:
Benchmark
Average number of seconds to run all queries: <SECONDS>
...版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
生产边界
高风险负载工具。只在隔离测试环境使用,并明确 query、并发、数据量和清理方案。
相关条目: 查看 MySQL 客户端版本
<PROGRAM> --help查看当前安装版本真正支持的参数、默认 option groups 和编译特性。
查看工具帮助
遇到跨版本参数差异时,把本机 --help 当作最终执行前检查。尤其 5.7、8.0、8.4 并存时,不要只依赖另一台机器的文档。
语法 / 签名
<PROGRAM> --help推荐用法
mysql --help
mysqldump --help
mysqlbinlog --help
mysqladmin --help预期结果:
Usage: <PROGRAM> [OPTIONS] ...验证
<PROGRAM> --version版本兼容
适用于所有版本,也是处理 5.7/8.x 差异最可靠的本机检查方式。
相关条目: 查看 MySQL 客户端版本、跨版本备份迁移