mydumper不支持原生时间范围导出,需用--where指定时间字段条件,且该字段须有索引;避免函数操作字段、注意时区与数据类型匹配,并导出前验证SQL条件。

mydumper 本身不支持按时间范围导出,得靠 WHERE 条件配合
mydumper 没有 --since 或 --time-range 这类原生参数。它只支持通过 --where 传入 SQL 条件,把时间筛选逻辑交给 MySQL 执行。这意味着:你得知道目标表里哪个字段存时间(比如 created_at、updated_time),且该字段要有索引,否则导出会极慢甚至卡住。
实操建议:
- 先确认时间字段类型:是
DATETIME、TIMESTAMP还是INT存秒级/毫秒级时间戳?写--where时格式必须匹配 - WHERE 条件里避免函数包裹字段,例如不要写
WHERE DATE(created_at) = '2024-01-01'—— 这会让索引失效 - 推荐写法:
--where="created_at >= '2024-01-01 00:00:00' AND created_at - 如果时间字段是
INT UNSIGNED存秒级时间戳,就写:--where="ctime >= 1704067200 AND ctime
导出单表时用 --where 最直接,多表需逐个指定或脚本生成
mydumper 的 --where 是全局参数,对所有表生效。但多数场景下,只有部分表有时间字段,其他表不需要过滤 —— 直接加 --where 会导致那些表查不到数据(WHERE 不成立)。
正确做法是分表导出:
- 对带时间字段的表,显式加
--where,例如:mydumper -B mydb -T orders --where="created_at >= '2024-01-01'" -o /dump/ - 对无时间字段的表,去掉
--where单独导出:mydumper -B mydb -T users -o /dump/ - 若表很多,建议用 shell 脚本读取
information_schema.COLUMNS找出含时间字段的表,再批量生成命令
注意 --chunk-filesize 和 --rows 对时间范围导出的影响
mydumper 默认按主键分块导出,但如果时间字段不是主键,又启用了 --chunk-filesize 或 --rows,可能切出不完整的时间段数据 —— 比如某 chunk 跨了 1 月和 2 月,而你只想要 1 月的数据,这部分 chunk 就会混入无效记录。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
稳妥做法:
- 优先用
--where配合完整时间范围条件,不依赖分块逻辑来“覆盖”时间筛选 - 如果数据量极大、必须分块,确保时间字段上有索引,并用
--order-by-primary让排序与主键一致,降低错乱概率 - 避免同时用
--rows和宽泛的--where,例如--where="status=1"再配--rows=10000,容易导致最后一批数据被截断
导出后验证时间范围是否准确,别只看文件大小
mydumper 不校验 WHERE 条件执行结果,它只管把 MySQL 返回的行写进文件。如果条件写错(比如字段名拼错、时区没对齐、用了 BETWEEN 忘记闭区间语义),导出来的可能是空文件、全表数据,或部分错乱数据。
关键检查点:
- 导出前先在数据库里手动执行等价 SELECT,确认返回行数和时间范围符合预期:
SELECT COUNT(*) FROM orders WHERE created_at >= '2024-01-01'; - 导出后检查 dump 目录下的
orders.sql(结构)和orders.00000.sql(数据)里是否有实际 INSERT 语句;空文件往往意味着 WHERE 条件没命中任何行 - 注意 MySQL 服务端时区(
system_time_zone)和连接时区(time_zone)是否一致,'2024-01-01'这种字符串默认按会话时区解析
时间字段没索引、WHERE 条件写错、时区混淆——这三个地方最容易白忙活一场。










