1. Windows 下用 Python 逐表 dump 备份 MySQL 的真实痛点
先说清楚这篇要解决什么问题：你有一台 Windows 机器，上面跑着 MySQL，库里几十上百张表，想每天（或者每次改完数据）把每张表单独导成一个.sql文件落盘，而不是一个大 dump 全糊在一起。手动敲mysqldump一张张来，表一多就废了；写个 Python 脚本又得配环境、记参数、切目录，每次都要开终端。这篇就是把这套流程封成「双击一个 cmd 文件就完事」的方案，核心检索词就是 python、cmd、mysqldump、数据库备份、pymysql 这一串。
为什么强调「逐表」而不是整库一把梭？我自己的场景是：库里有几张核心业务表，改坏了只想回滚其中一张，整库 dump 恢复起来又慢又容易误伤别的表。逐表导出后，文件名就是表名，出问题直接找到对应.sql单独导入，定位成本几乎为零。另外逐表文件体积小，丢到网盘或者移动硬盘做冷备也方便，不用每次传一个几百 MB 的大文件。
适合谁看：会一点点 Python、在 Windows 上管 MySQL、不想装额外备份工具（比如各种带界面的客户端）的人。整篇不需要你懂多高深的数据库原理，跟着把脚本和 cmd 抄下来、改几个路径和账号就能跑。中间会用到 pymysql 读表清单、mysqldump做实际导出、os.system调命令行，最后用 cmd 批处理把「切盘符 + 切目录 + 跑 Python + 暂停看结果」串起来。
还有一个容易被忽略的点：备份脚本本身也要能「看见结果」。很多人写完脚本双击一闪而过，根本不知道成没成功。所以这篇会在 Python 里加文件大小校验，cmd 里加pause，让你双击后能停在窗口里看到每张表的导出状态和最终校验结论。下面从环境准备开始，一步步来。
2. TaoToken 统一 Key 管理：给备份脚本加个「配置中心」的接入前置
备份脚本本身不依赖大模型，但为什么这里要提 TaoToken？因为实际运维里，备份只是自动化链条的一环，你往往还会写别的脚本——比如备份完让模型帮你检查 SQL 文件有没有异常、生成一份变更摘要、或者把报错日志丢给模型分析。这些脚本如果每个都硬编码一套 API Key 和 Base URL，管理起来就是灾难。TaoToken 在这里的角色是「统一 Key 管理 + 统一入口」，你申请一个 Key，所有脚本共用同一套接入配置，换模型、换额度只改一处。
TaoToken 是什么、能做什么：它是一个聚合式的模型调用入口，提供兼容 OpenAI 风格的 API。你拿到一个 Key 之后，Base URL 指向https://taotoken.net/api，就能在 Python 脚本里用标准 SDK 调不同模型。适合谁：手上有一堆小脚本、每个都想接模型能力、又不想为每个脚本单独维护密钥和地址的人。对这篇的备份场景来说，最典型的用法是备份完成后，脚本顺手把「本次备份了哪些表、各文件多大、有没有 0 字节文件」整理成一段文本，调模型生成一句人话总结，写进日志。
接入前你要准备的东西：一个 TaoToken 账号、一个 API Key、以及确认你的 Python 环境能发 HTTPS 请求。Key 在控制台的 API Keys 页面创建，创建后复制保存，页面上只完整显示一次。Base URL 用https://taotoken.net/api，注意这个地址不带任何查询参数，直接作为 SDK 的base_url用。模型 ID 按你实际要调的填，比如做文本总结就选一个对话模型。
这里要提醒一句：TaoToken 是正规的模型调用入口，不是让你绕过什么限制的工具，它的用途就是让你在自己的脚本里方便地调模型。备份脚本里接它属于「锦上添花」——核心备份逻辑完全不依赖它，就算你不接，脚本照样能把表 dump 出来。所以你可以先把备份跑通，再考虑要不要加模型总结这一段。
配置上建议单独放一个config.ini或者环境变量，别把 Key 写死在备份脚本里。原因很简单：备份脚本可能会被复制到别的机器、发给同事，Key 跟着脚本到处跑迟早泄露。用环境变量或者独立配置文件，脚本里只读不写，安全得多。下面第三节会给出完整的可复制配置片段，包括数据库连接、备份目录、以及可选的 TaoToken 接入参数。
3. 可复制配置：Python 脚本 + cmd 批处理 + 接入片段
这一节是全文的核心，所有代码都可以直接抄。先给目录结构建议，再给 Python 脚本，最后给 cmd 和可选的 TaoToken 配置。
目录结构我习惯这样放，路径全用正斜杠/，Windows 下 Python 里正斜杠不会触发转义问题，比反斜杠省心：
D:/db_backup/ ├── dump.py # 主脚本 ├── dump.cmd # 双击入口 ├── config.ini # 配置（含数据库账号，可选 TaoToken） └── output/ # 备份文件落盘目录先写config.ini，把数据库连接和备份目录抽出来：
[mysql] host = 127.0.0.1 port = 3306 user = root password = your_password db_name = your_db mysqldump_dir = C:/Program Files/MySQL/MySQL Server 8.0/bin [backup] output_dir = D:/db_backup/output [taotoken] enable = false base_url = https://taotoken.net/api api_key = sk-你的Key model = 你的模型ID然后是dump.py主脚本。它做四件事：读配置、用 pymysql 拿表清单、逐表调 mysqldump、校验文件大小。注意mysqldump的密码参数写法，-p和密码之间不要有空格，否则会被当成库名：
import os import configparser import pymysql def load_config(path="config.ini"): cfg = configparser.ConfigParser() cfg.read(path, encoding="utf-8") return cfg def get_tables(host, user, pwd, db_name, port=3306): table_list = [] conn = pymysql.connect( host=host, user=user, passwd=pwd, db=db_name, port=port, charset="utf8" ) cursor = conn.cursor(cursor=pymysql.cursors.DictCursor) cursor.execute("show tables;") result = cursor.fetchall() key = "Tables_in_" + db_name for r in result: table_list.append(r[key]) cursor.close() conn.close() return table_list def dump_table(sql_dir, host, db_user, db_pwd, db_name, db_table, out_dir, port=3306): os.chdir(sql_dir) out_file = os.path.join(out_dir, db_table + ".sql") cmd = ( "mysqldump -h " + host + " -P" + str(port) + " -u" + db_user + " -p" + db_pwd + " --single-transaction --default-character-set=utf8 " + db_name + " " + db_table + " > " + out_file ) print("dumping table:", db_table) code = os.system(cmd) if code != 0: print(" [FAIL] exit code:", code) return None size = os.path.getsize(out_file) print(" [OK] saved:", out_file, size, "bytes") return out_file def main(): cfg = load_config() host = cfg.get("mysql", "host") port = cfg.getint("mysql", "port") user = cfg.get("mysql", "user") pwd = cfg.get("mysql", "password") db_name = cfg.get("mysql", "db_name") sql_dir = cfg.get("mysql", "mysqldump_dir") out_dir = cfg.get("backup", "output_dir") if not os.path.exists(out_dir): os.makedirs(out_dir) tables = get_tables(host, user, pwd, db_name, port) print("total tables:", len(tables)) ok, fail = 0, 0 for t in tables: f = dump_table(sql_dir, host, user, pwd, db_name, t, out_dir, port) if f: ok += 1 else: fail += 1 print("done. ok =", ok, "fail =", fail) if __name__ == "__main__": main()--single-transaction这个参数很关键。如果你的表引擎是 InnoDB，加上它可以在导出时不开全局读锁，业务查询不受影响。不加的话，备份期间别人写库可能被阻塞。这是从网上很多资料里都能查到的实践，我实测下来对线上库友好很多。
接着是dump.cmd，双击入口。注意cd /d能同时切盘符和目录，比先D:再cd更稳：
@echo on cd /d D:\db_backup python dump.py pause如果你想让 cmd 里也能看到 Python 的实时输出，别加start，直接python dump.py就行，start会另开窗口，反而看不到。pause保证窗口不闪退，你能看到最后ok = N fail = M那行。
最后是可选的 TaoToken 接入片段，放在备份完成后调用，用来生成一句总结。用标准 OpenAI 兼容写法：
from openai import OpenAI def summarize_with_taotoken(cfg, text): if not cfg.getboolean("taotoken", "enable"): return "" client = OpenAI( base_url=cfg.get("taotoken", "base_url"), api_key=cfg.get("taotoken", "api_key"), ) resp = client.chat.completions.create( model=cfg.get("taotoken", "model"), messages=[{"role": "user", "content": "用一句话总结这次备份：" + text}], ) return resp.choices[0].message.content三件套记牢：Base URL 用https://taotoken.net/api，Key 用你控制台创建的，Model ID 按实际填。这三样配齐，脚本就能调通。
4. 验证请求与成功结果：双击运行后怎么确认备份真的成了
代码写完不算完，得验证。这一节讲双击dump.cmd之后你应该看到什么、怎么确认文件是完整的。
双击dump.cmd，窗口会先显示cd /d D:\db_backup，然后跑python dump.py。正常输出大概长这样：
total tables: 12 dumping table: users [OK] saved: D:/db_backup/output/users.sql 20480 bytes dumping table: orders [OK] saved: D:/db_backup/output/orders.sql 153600 bytes ... done. ok = 12 fail = 0看到ok = 12 fail = 0就说明 12 张表全导成功了。如果某张表显示[FAIL] exit code: 1，说明 mysqldump 报错了，常见原因是密码错、表名带特殊字符、或者 mysqldump 路径不对。
文件完整性校验我做了两层。第一层是脚本里的os.path.getsize，每个文件导出后立刻读大小，0 字节直接说明导出失败（比如权限问题或者表不存在）。第二层是手动抽查：打开output目录，随便挑一个.sql文件，用记事本或 VS Code 打开，看开头有没有CREATE TABLE和INSERT INTO语句。一个正常的表 dump 文件，开头是建表语句，后面是数据插入语句。如果只有建表没有数据，可能是表本身是空的，也可能是--no-data之类的参数误加了。
再进一步，你可以用findstr在 cmd 里快速检查所有文件是否都非空：
for %f in (D:\db_backup\output\*.sql) do @echo %~zf %f这会列出每个文件的大小。如果全是 0，那肯定是 mysqldump 没跑起来，回去检查mysqldump_dir路径和密码。
还有一个验证动作：拿导出的单个表文件做一次恢复测试。新建一个测试库，把某个.sql导进去，看能不能成功：
mysql -h 127.0.0.1 -uroot -p你的密码 test_db < D:\db_backup\output\users.sql能导入成功、表结构和数据都对，说明备份文件是可用的，不是坏文件。这一步很多人省掉，结果真出事要恢复时才发现 dump 是坏的，那就晚了。
如果你开了 TaoToken 总结，备份完成后还会多一行模型生成的总结，比如「本次共备份 12 张表，最大文件 orders.sql 约 150KB，无空文件」。这行会写进日志，方便你事后翻记录。
5. 本篇常见错排查：401、local proxy failed、reading choices、OAuth 对照
这一节把你会撞到的报错集中列一下，对照着改。
mysqldump 报「拒绝访问」或 exit code 1：最常见是mysqldump_dir路径写错，或者路径里有空格没处理好。C:/Program Files/MySQL/...这种带空格的路径，在os.system里最好用引号包起来，或者干脆把 mysqldump 所在目录加进系统 PATH，脚本里直接写mysqldump。另外-p和密码之间绝对不能有空格，-p yourpass会被解析成「密码为空 + 库名 yourpass」。
pymysql 连接报 1045 Access denied：账号密码错，或者该账号没有从当前主机连接的权限。检查config.ini里的 user/password，以及 MySQL 里这个用户的 host 是不是%或localhost。
TaoToken 调用报 401：Key 错了或者没带上。检查api_key是不是完整复制、有没有多余空格。401 基本都是认证问题，跟模型 ID 无关。
报 local proxy failed / connection refused：说明你的脚本在尝试走一个本地代理端口，但那个端口没服务。检查环境变量里有没有HTTP_PROXY、HTTPS_PROXY被设成了本地地址，有的话清掉，让请求直连https://taotoken.net/api。
报 reading choices 相关错误（比如'NoneType' object has no attribute 'choices'或 KeyError: 'choices'）：说明返回体里没有choices字段，通常是请求本身失败了但你没检查异常。在调用外面包一层 try，把resp整个打印出来看真实返回，多半是模型 ID 写错或者额度问题。
OAuth 相关报错：如果你用的是某些需要 OAuth 授权的客户端（比如 Claude Code 这类），报 OAuth 失败通常是授权流程没走完或者 token 过期。这类客户端接入时同样要配全三件套：Base URL、Key、Model ID。以 Claude Code 为例，它的配置里 Base URL 填https://taotoken.net/api，Key 填你的 TaoToken Key，模型按需选。如果它走的是settings.json或环境变量，确认字段名没写错，别把base_url写成baseUrl。
备份文件是 0 字节但没报错：os.system返回 0 不代表导出成功，有些情况下 mysqldump 会把错误写到 stderr 但退出码仍是 0。所以脚本里加了getsize校验，0 字节就当失败处理。如果发现某张表总是 0 字节，单独手动跑一次 mysqldump 看报什么。
cmd 双击闪退：没加pause，或者 Python 不在 PATH 里导致python命令找不到直接退出。先确认命令行里能跑python --version，再加pause。
6. 把备份接进你的自动化链条：从手动双击到定时任务
脚本能双击跑通之后，下一步自然是让它自动跑。Windows 自带「任务计划程序」，可以设定每天固定时间执行dump.cmd。配置时注意两点：一是「起始于」要填D:\db_backup，否则脚本里的相对路径config.ini找不到；二是程序填cmd.exe，参数填/c D:\db_backup\dump.cmd。
如果你想让备份完自动调模型生成摘要并推到某个地方，就在dump.py的main()末尾接上第 3 节的summarize_with_taotoken，把ok/fail和文件列表拼成文本传进去。TaoToken 的 Key 统一放在config.ini里，以后你写别的运维脚本也读同一个文件，不用到处复制 Key。
长期跑编码类、Agent 类任务的话，可以了解下 Coding Plan，它适合需要持续调用模型的场景，比按次零散调用更省心。想先验证模型效果，直接去模型对话页面试几句就行。Key 的创建和管理都在 API Keys 页面，接入细节看接入文档。
最后留个我踩过的坑：备份目录别放在系统盘，也别放在 MySQL 数据目录里面。放数据目录里，万一哪天清理数据目录容易误删；放系统盘，C 盘满了会影响系统。单独找个数据盘，比如D:/db_backup/output，再定期把这个目录同步到移动硬盘或网盘，才算完整。脚本本身不复杂，难的是坚持跑、并且每次跑完你都能确认它是好的——这也是为什么校验和pause不能省。
