如何使用mysqldump带where条件导出MySQL单表部分数据？

本文共计839个文字，预计阅读时间需要4分钟。

直接说结论：

• --where 必须和 database_name table_name 一起用，不能单独指定表名不带库名
• 条件字符串要加单引号包裹，且内部若含单引号需转义为两个单引号（''），不是反斜杠
• 日期、字符串值必须用 SQL 标准引号（如 '2024-01-01'），不能用双引号（MySQL 严格模式下会失效）
• 导出前建议先在 MySQL 客户端手动执行 SELECT COUNT(*) FROM tbl WHERE ... 验证条件是否真能命中数据

实际命令示例：导出用户表中最近7天注册的记录

假设库叫 app_db，表叫 users，字段 created_at 是 DATETIME 类型：

mysqldump -u root -p app_db users --where="created_at >= '2024-06-01 00:00:00'" > users_recent.sql

注意：>= 和日期之间不能有换行或多余空格；> 在 shell 中需转义为 > 或用单引号包住整个 --where 值（更安全）：

mysqldump -u root -p app_db users '--where=created_at >= "2024-06-01 00:00:00"' > users_recent.sql

用双引号包条件值也可以，但里面字段名和操作符别再混用双引号，否则 shell 解析会乱。

常见失败现象和排查点

导出文件为空或大小异常小，大概率是 --where 没生效。优先检查这几项：

• 执行命令后有没有提示 Warning: Using a password on the command line interface can be insecure.？有说明连接成功，没提示可能用户名密码错或库表名不存在
• 把 --where 换成 --no-data 跑一次，看能否导出表结构——排除库/表名拼写、权限问题
• 条件里用了中文、括号、百分号等，没用单引号整体包裹，shell 直接截断了参数
• 条件中字段名写错（比如 create_time 写成 created_time），mysqldump 不校验字段是否存在，静默忽略条件导出全表
• MySQL 版本低于 5.6.3 —— --where 在旧版本不支持或行为异常

替代方案：用 SELECT INTO OUTFILE 更可控（需 FILE 权限）

如果服务器上能执行 SQL 且有 FILE 权限，SELECT ... INTO OUTFILE 对部分数据导出更直观、易调试：

SELECT * FROM users WHERE created_at >= '2024-06-01' INTO OUTFILE '/tmp/users_recent.csv' FIELDS TERMINATED BY ',' OPTIONALLY ENCLOSED BY '"' LINES TERMINATED BY '\n';

注意路径必须是 MySQL 服务进程有写权限的本地路径（非客户端机器），且不能覆盖已有文件。导出的是纯数据，不含建表语句和 INSERT 头尾，适合后续导入或分析，不适合直接 source 回库。

真正难的不是写对那条命令，而是确认 WHERE 条件在目标环境里确实能筛选出预期数据——别跳过这一步，不然导了半天发现是空的，又回去查日志、翻权限、改引号，时间都花在纠错上了。