MySQL Shell的util.dumpInstance()和util.dumpSchemas()支持真正并行逻辑备份，但默认单线程（threads:1），必须显式指定threads参数（如threads:8）才能启用多线程；二者均能精确记录GTID/binlog位置，但需确保已开启binlog且用户具备REPLICATION CLIENT权限。
MySQL Shell 的 util.dumpInstance() 和 util.dumpSchemas() 支持真正意义上的并行逻辑备份，比 mysqldump 快得多，且能精确记录 GTID / binlog 位置 —— 但默认不启用并行，必须显式指定 threads 参数，否则就是单线程。
如何触发并行备份：必须传 threads，不能依赖默认值
util.dumpInstance() 和 util.dumpSchemas() 默认是单线程（threads: 1），即使你机器有 16 核也不会自动提速。想用多线程，必须手动设参数：
-
threads值建议设为 CPU 核心数的 1–2 倍（例如 8 核机器可设4～12），过高反而因 I/O 或锁竞争导致性能下降 - 不支持小数或动态表达式，只能传整数，比如
threads: 8，不能写threads: os.cpus().length - 如果目标目录非空，备份会直接失败（不是覆盖），必须提前清空或换新路径
- 备份过程不会自动压缩，如需压缩，得在 dump 完成后用
gzip处理.tsv文件，或用外部管道（但会丢失元数据文件 @.json）
util.dumpSchemas() 与 util.dumpInstance() 的关键区别
选错函数会导致备份范围出错，尤其在多库场景下：
-
util.dumpSchemas(['db1', 'db2'])：只导出指定库的结构 + 数据，不包含用户、权限、存储过程定义（除非显式加includeUsers: true） -
util.dumpInstance()：导出整个实例，含所有库、用户账号（@.users.sql）、GTID 状态、binlog 位点（@.json中的binlogFile/binlogPosition），适合做全量恢复或搭建从库 - 两者都支持
excludeTables，但dumpInstance()不支持includeDefiners这类细粒度控制，而dumpSchemas()可以 - 若只备份部分表，必须用
dumpSchemas()+excludeTables或includeTables，dumpInstance()没有表级过滤能力
常见错误：备份后找不到 binlog 位置或无法建复制
很多人 dump 完发现 @.json 里 binlogPosition 是 0 或为空，导致后续无法基于备份点拉从库 —— 这通常是因为没开 binlog 或连接用户权限不足：
- 确保 MySQL 已启用
log_bin=ON，且不是log_bin=OFF或仅在 slave 上开启 - 连接用户必须有
REPLICATION CLIENT权限，否则util拿不到当前 binlog 位点，会 fallback 到 GTID 或报 warning - 如果实例启用了 GTID，
@.json中的gtidExecuted才是可靠的一致性点；若禁用了 GTID，必须靠binlogFile+binlogPosition，缺一不可 - 使用
--consistency=archive（默认）时，dump 期间会加全局读锁（FLUSH TABLES WITH READ LOCK），对线上写入有影响；如需无锁，改用--consistency=none，但一致性由应用层保证
实际执行示例：带并行、含用户、保留 binlog 位点
以下命令在 MySQL Shell 的 JavaScript 模式下运行（先输入 \js）：
util.dumpInstance("/data/backup/full_20260810", {
threads: 6,
excludeSchemas: ["mysql", "information_schema", "performance_schema", "sys"],
includeUsers: true,
consistency: "archive"
});
注意：includeUsers: true 才会生成 @.users.sql；excludeSchemas 必须显式排除系统库，否则备份会失败（因权限或结构特殊）；路径 /data/backup/full_20260810 必须事先不存在。
备份完成后，立刻检查 /data/backup/full_20260810/@.json 是否包含非空的 binlogFile 和 binlogPosition 字段 —— 这个细节容易被跳过，但决定了能不能做精准恢复。
