MySQL / 知识点
MySQL 命令行速查手册
连接与执行
mysql --version确认本机 mysql 客户端版本,排查客户端与服务端版本不一致导致的参数或认证问题。
查看 MySQL 客户端版本
连接失败、迁移前检查工具链,或文档中的参数在本机不可用时,先确认客户端版本。不要只看服务端版本;mysql、mysqldump、mysqlbinlog 可以来自不同安装目录。
语法 / 签名
mysql --version推荐用法
mysql --version预期结果:
mysql Ver <CLIENT_VERSION> for <PLATFORM> on <ARCH>验证
which mysql
mysql --version
mysqldump --version
mysqlbinlog --version版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。跨版本迁移时建议同时记录客户端和服务端版本。
生产边界
PATH 中可能同时存在多个 MySQL 客户端。出现“文档有参数但命令不认识”时,先检查实际执行的是哪个二进制。
相关条目: 连接远程 MySQL、跨版本备份迁移
mysql -u <USER> -p [<DATABASE>]使用 mysql 客户端连接本机实例,并通过交互提示输入密码。
连接本机 MySQL
需要进入本机 MySQL 做临时查询、排障或管理时使用。-p 后不要直接拼密码,让客户端交互读取,避免密码进入 Shell 历史或进程参数。
语法 / 签名
mysql -u <USER> -p [<DATABASE>]推荐用法
mysql -u <USER> -p <DATABASE>预期结果:
Enter password:
mysql>关键参数
| 参数 | 作用 |
|---|---|
-u <USER> |
登录用户 |
-p |
交互输入密码;不要写成 -p<PASSWORD> |
<DATABASE> |
可选,连接后直接使用目标库 |
验证
SELECT CURRENT_USER(), DATABASE(), VERSION();版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
常见问题
Access denied:核对用户名、来源主机、密码和账户认证插件。- 连接到错误实例:检查 socket、默认 option file 和
status输出。
相关条目: 连接远程 MySQL、使用 login-path 保存连接配置
mysql -h <HOST> -P <PORT> -u <USER> -p [<DATABASE>]通过 TCP 连接远程 MySQL,并显式指定主机和端口。
连接远程 MySQL
服务部署在远程主机、容器、云数据库或非默认端口时使用。远程连接建议明确写 -h 与 -P,不要依赖本地默认 socket 行为。
语法 / 签名
mysql -h <HOST> -P <PORT> -u <USER> -p [<DATABASE>]推荐用法
mysql -h <HOST> -P <PORT> -u <USER> -p <DATABASE>预期结果:
Enter password:
mysql>关键参数
| 参数 | 作用 |
|---|---|
-h <HOST> |
MySQL 主机名或 IP |
-P <PORT> |
TCP 端口,注意大写 P |
-u <USER> |
登录用户 |
-p |
交互输入密码 |
验证
mysql -h <HOST> -P <PORT> -u <USER> -p -e "SELECT @@hostname, @@port, VERSION();"版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
常见问题
Connection refused:目标端口未监听、地址错误或服务未启动。Connection timed out:检查安全组、防火墙、路由和白名单。Access denied:网络已通,继续检查账户授权与认证。
相关条目: 强制使用 TCP、使用 TLS 连接
mysql --protocol=TCP -h <HOST> -P <PORT> -u <USER> -p强制 mysql 客户端使用 TCP,避免 localhost 自动走 Unix Socket。
强制使用 TCP
本机同时存在多个实例、socket 指向错误实例,或者需要验证真实 TCP 监听与防火墙时使用。
语法 / 签名
mysql --protocol=TCP -h <HOST> -P <PORT> -u <USER> -p推荐用法
mysql --protocol=TCP -h 127.0.0.1 -P <PORT> -u <USER> -p预期结果:
Enter password:
mysql>验证
status版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
常见问题
localhost在 Unix/Linux 上常优先使用 socket;想验证 TCP 时使用127.0.0.1并显式指定--protocol=TCP。
相关条目: 使用 Unix Socket 连接、连接远程 MySQL
mysql --protocol=SOCKET -S <SOCKET_PATH> -u <USER> -p直接通过 Unix Socket 连接本机 MySQL,绕过 TCP 网络栈。
使用 Unix Socket 连接
本地维护、TCP 未开放、或需要确认某个 socket 对应哪个实例时使用。
语法 / 签名
mysql --protocol=SOCKET -S <SOCKET_PATH> -u <USER> -p推荐用法
mysql --protocol=SOCKET -S <SOCKET_PATH> -u <USER> -p预期结果:
Enter password:
mysql>关键参数
| 参数 | 作用 |
|---|---|
-S <SOCKET_PATH> |
MySQL Unix Socket 文件路径 |
--protocol=SOCKET |
明确要求使用 socket |
验证
status版本兼容
MySQL 5.7 / 8.0 / 8.4 通用;Windows 通常不使用 Unix Socket。
常见问题
Can't connect to local MySQL server through socket:核对 mysqld 实际 socket 路径和文件权限。
相关条目: 强制使用 TCP、查看服务状态
mysql -u <USER> -p <DATABASE>连接时直接选择目标数据库,减少进入客户端后再执行 USE 的步骤。
选择默认数据库
脚本、临时排查或导入导出只针对单个库时,连接命令直接带数据库名更清晰,也能降低误操作到其他库的概率。
语法 / 签名
mysql -u <USER> -p <DATABASE>推荐用法
mysql -h <HOST> -P <PORT> -u <USER> -p <DATABASE>预期结果:
Enter password:
mysql>验证
SELECT DATABASE();版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
常见问题
Unknown database:确认数据库名、大小写和连接的环境。
相关条目: 执行单条 SQL、执行 SQL 文件
mysql [CONNECTION_OPTIONS] -e "<SQL>" [<DATABASE>]从 Shell 一次执行 SQL 并退出,适合脚本、健康检查和自动化查询。
执行单条 SQL
不需要进入交互终端、只想执行一条或少量 SQL 时使用。Shell 会先解析引号,因此复杂 SQL 建议放入文件而不是继续堆叠转义。
语法 / 签名
mysql [CONNECTION_OPTIONS] -e "<SQL>" [<DATABASE>]推荐用法
mysql --login-path=<LOGIN_PATH> -e "SELECT VERSION(), NOW();"预期结果:
VERSION()\tNOW()
<VERSION>\t<TIME>关键参数
| 参数 | 作用 |
|---|---|
-e, --execute |
执行后退出 |
--login-path |
从 .mylogin.cnf 读取连接信息 |
验证
echo $?版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
常见问题
- Shell 引号冲突:SQL 中包含
$、反引号或复杂 JSON 时改用 SQL 文件。 - 输出要给脚本消费时配合
--batch --raw --skip-column-names。
相关条目: 批处理输出、执行 SQL 文件
mysql [CONNECTION_OPTIONS] [<DATABASE>] < <PATH>.sql把 SQL 文件作为 mysql 标准输入执行,常用于建表、初始化或恢复普通 SQL 脚本。
执行 SQL 文件
已经有完整 .sql 文件时优先使用标准输入,不要把整段 SQL 塞进 -e。执行前先确认目标实例、目标库和脚本是否包含 USE、DROP、DELETE 等破坏性语句。
语法 / 签名
mysql [CONNECTION_OPTIONS] [<DATABASE>] < <PATH>.sql推荐用法
mysql --login-path=<LOGIN_PATH> <DATABASE> < <PATH>/script.sql验证
echo $?
mysql --login-path=<LOGIN_PATH> -e "SHOW WARNINGS;" <DATABASE>版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
生产边界
Shell 重定向本身没有事务保护。一个大 SQL 文件中途失败时,前面的已提交语句不会自动回滚;生产执行前要准备备份与恢复点。
相关条目: source 执行 SQL 文件、恢复 mysqldump 备份
mysql --default-character-set=<CHARSET> [CONNECTION_OPTIONS]显式指定 mysql 客户端连接字符集,处理历史系统、导入脚本或乱码排查。
指定客户端字符集
默认配置与业务编码不一致、导入文件出现乱码,或者需要确保客户端按 utf8mb4 发送和接收数据时使用。
语法 / 签名
mysql --default-character-set=<CHARSET> [CONNECTION_OPTIONS]推荐用法
mysql --default-character-set=utf8mb4 --login-path=<LOGIN_PATH> <DATABASE>预期结果:
mysql>验证
SHOW VARIABLES LIKE 'character_set_%';版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
常见问题
- 不要把 MySQL 的
utf8与utf8mb4混为一谈;现代业务文本优先使用utf8mb4。 - 文件本身编码错误时,仅修改客户端字符集不能修复源文件。
相关条目: 执行 SQL 文件、恢复 mysqldump 备份
mysql --ssl-mode=VERIFY_IDENTITY --ssl-ca=<CA_PATH> [CONNECTION_OPTIONS]使用 TLS 加密连接,并校验服务端证书链和主机身份。
使用 TLS 验证服务器身份
跨主机访问生产数据库、云数据库或网络路径不可信时,优先使用 VERIFY_IDENTITY。它不仅要求加密,还会校验证书和连接主机名。
语法 / 签名
mysql --ssl-mode=VERIFY_IDENTITY --ssl-ca=<CA_PATH> [CONNECTION_OPTIONS]推荐用法
mysql \
--login-path=<LOGIN_PATH> \
--ssl-mode=VERIFY_IDENTITY \
--ssl-ca=<CA_PATH> \
-h <DB_HOST>预期结果:
mysql>关键参数
| 参数 | 作用 |
|---|---|
--ssl-mode=VERIFY_IDENTITY |
要求加密、验证 CA 和服务器身份 |
--ssl-ca |
可信 CA 文件 |
验证
status版本兼容
--ssl-mode 自 MySQL 5.7.11 起可用,并延续到 8.0/8.4。更早的 5.7 小版本使用旧 --ssl 选项;新文档不建议继续沿用旧写法。
常见问题
- 证书主机名不匹配:使用证书覆盖的 DNS 名连接,不要用临时 IP 绕过验证。
- 只有加密要求、无法验证主机名的旧环境可退到
VERIFY_CA,但不应把PREFERRED当生产安全基线。
相关条目: 连接远程 MySQL、使用 login-path 保存连接配置
交互与结果输出
source <PATH>.sql在已经进入 mysql 交互客户端后执行 SQL 文件。
source 执行 SQL 文件
已经连接到正确实例并完成人工确认后,需要在当前会话中执行脚本时使用。相比退出后重新重定向,source 会沿用当前连接、数据库和会话设置。
语法 / 签名
source <PATH>.sql推荐用法
source <PATH>/script.sql预期结果:
Query OK, ...验证
SELECT DATABASE();
SHOW WARNINGS;版本兼容
MySQL 5.7 / 8.0 / 8.4 通用的 mysql 客户端命令。
生产边界
source 会直接执行文件内容。生产环境先检查文件,再确认当前 status 和 SELECT DATABASE()。
相关条目: 执行 SQL 文件、设置 delimiter
<SQL>\G把一行结果按“字段: 值”纵向展示,适合字段很多或文本很长的结果。
纵向显示结果
查看 SHOW ENGINE INNODB STATUS、长字段、宽表或单行诊断结果时,使用 \G 比横向表格更容易阅读。
语法 / 签名
<SQL>\G推荐用法
SHOW FULL PROCESSLIST\G预期结果:
*************************** 1. row ***************************
Id: <ID>
User: <USER>
...版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
相关条目: 使用 pager、查看进程列表
delimiter <TOKEN>临时改变 mysql 客户端语句结束符,便于输入包含分号的存储过程、函数或触发器定义。
设置 delimiter
交互创建 stored routine、trigger 等对象时使用。delimiter 是 mysql 客户端命令,不会发送给服务器。
语法 / 签名
delimiter <TOKEN>推荐用法
delimiter //
CREATE PROCEDURE p_demo()
BEGIN
SELECT 1;
END//
delimiter ;预期结果:
Query OK, 0 rows affected验证
SHOW PROCEDURE STATUS LIKE 'p_demo'\G版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
常见问题
- 忘记恢复为
;会让后续输入看起来一直不执行。 delimiter不是 SQL,放到不支持该客户端命令的执行器里会报错。
相关条目: source 执行 SQL 文件
tee <PATH>把 mysql 交互会话的查询与输出追加写入文件,便于排障留痕。
记录交互输出
临时排障需要保存执行记录时使用。只在交互模式工作;记录文件可能包含 SQL、表名和数据,结束后注意权限与脱敏。
语法 / 签名
tee <PATH>推荐用法
tee <PATH>/mysql-session.log预期结果:
Logging to file '<PATH>/mysql-session.log'验证
notee版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
生产边界
日志可能记录敏感查询结果。不要把密码、密钥或个人敏感数据直接查询后写入公共目录。
相关条目: 使用 pager、查看客户端状态
pager <COMMAND>把 mysql 交互结果交给外部分页器或过滤命令处理。
使用 pager 分页结果
结果很多但仍需要人工浏览时使用,例如 Linux/macOS 下交给 less。退出 pager 后可用 nopager 恢复默认显示。
语法 / 签名
pager <COMMAND>推荐用法
pager less -S预期结果:
PAGER set to 'less -S'验证
nopager版本兼容
MySQL 5.7 / 8.0 / 8.4 mysql 客户端通用。
常见问题
- Windows 或精简容器可能没有
less;按环境选择可用程序。 - 不要把 pager 配成会修改数据或长时间阻塞的复杂命令。
相关条目: 纵向显示结果、记录交互输出
status查看当前连接、用户、数据库、协议、字符集和服务器版本。
查看客户端状态
怀疑连错实例、连错库、走了 socket 而不是 TCP,或字符集异常时,status 是最直接的会话自检入口。
语法 / 签名
status推荐用法
status预期结果:
Connection id: <ID>
Current database: <DATABASE>
Current user: <USER>
SSL: <TLS_STATUS>
...版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
相关条目: 连接本机 MySQL、使用 TLS 验证服务器身份
mysql --show-warnings [CONNECTION_OPTIONS]让 mysql 在语句产生 warning 时自动显示详细警告。
自动显示警告
迁移旧表结构、执行可能发生隐式转换的 DDL/DML,或排查“执行成功但结果不符合预期”时开启。
语法 / 签名
mysql --show-warnings [CONNECTION_OPTIONS]推荐用法
mysql --show-warnings --login-path=<LOGIN_PATH> <DATABASE>预期结果:
mysql>验证
SHOW WARNINGS;版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
相关条目: 执行单条 SQL、安全更新模式
mysql --safe-updates [CONNECTION_OPTIONS]在交互客户端限制缺少关键条件的 UPDATE、DELETE,降低手工误操作概率。
开启安全更新模式
人工连接生产或共享数据库进行数据修正时建议开启。它不是权限系统,也不能替代事务、备份和变更审核。
语法 / 签名
mysql --safe-updates [CONNECTION_OPTIONS]推荐用法
mysql --safe-updates --login-path=<LOGIN_PATH> <DATABASE>预期结果:
mysql>验证
SELECT @@sql_safe_updates;版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
生产边界
安全更新模式只能拦截部分高风险语句,不能阻止合法但条件写错的更新。
常见问题
- 确需执行批量更新时,不要习惯性永久关闭;先重新确认 WHERE、影响行数和备份。
相关条目: 执行单条 SQL
mysql --batch --raw --skip-column-names [CONNECTION_OPTIONS] -e "<SQL>"把查询结果输出为更适合 Shell 管道处理的制表符文本。
输出脚本友好结果
脚本只需要值、不需要 ASCII 表格边框和列名时使用。--raw 避免额外转义,读取包含换行或二进制的数据时仍需谨慎。
语法 / 签名
mysql --batch --raw --skip-column-names [CONNECTION_OPTIONS] -e "<SQL>"推荐用法
mysql --login-path=<LOGIN_PATH> \
--batch --raw --skip-column-names \
-e "SELECT VERSION();"预期结果:
<VERSION>关键参数
| 参数 | 作用 |
|---|---|
--batch, -B |
批处理输出 |
--raw, -r |
不做字符转义 |
--skip-column-names, -N |
不输出列名 |
验证
mysql --login-path=<LOGIN_PATH> -NBe "SELECT 1;"版本兼容
MySQL 5.7 / 8.0 / 8.4 通用。
相关条目: 执行单条 SQL、流式读取大结果
mysql --quick [CONNECTION_OPTIONS] -e "<SQL>"让 mysql 客户端逐行从服务器取结果,降低客户端一次缓存超大结果集的内存压力。
流式读取大结果
导出大查询或终端执行返回行数很多的 SELECT 时使用。它解决的是客户端缓冲问题,不会让服务器查询本身变快。
语法 / 签名
mysql --quick [CONNECTION_OPTIONS] -e "<SQL>"推荐用法
mysql --login-path=<LOGIN_PATH> --quick --batch --raw \
-e "SELECT * FROM <TABLE>;" <DATABASE> > <PATH>/result.tsv验证
wc -l <PATH>/result.tsv版本兼容
MySQL 5.7 / 8.0 / 8.4 通用;官方文档明确推荐在大结果内存不足时使用 --quick。
生产边界
即使使用 --quick,没有限制的大查询仍会消耗服务器 I/O、网络和锁资源。生产导出应优先走只读副本或低峰窗口。
相关条目: 输出脚本友好结果、导出部分数据