本番 TiDB (blog_prd) の論理ダンプ手順
本番データベース blog_prd を mysqldump で取得する定型手順。scripts/dump-tidb.sh に実装し、bun run dump:prd で実行できるようにした。出力先の backup/ は .gitignore 済み（本番データはコミットしない）。
実行方法
# リポジトリルートで
bun run dump:prd
# 任意の DB / 出力先を指定する場合
./scripts/dump-tidb.sh --database blog_dev --out-dir /tmp
前提は Tailnet に接続済みであること（ホストは tidb.<tailnet MagicDNS suffix>:4000 を自動解決）。接続先は TIDB_HOST / TIDB_PORT / TIDB_USER / TIDB_PASSWORD で上書きできる。
出力は backup/<database>-<timestamp>.sql。DB 名は位置引数で渡しており（--databases は使わない）、ダンプに CREATE DATABASE / USE を含めない。そのためリストア先のスキーマを -D で自由に選べる（blog_prd のダンプを blog_dev に戻す、といった別スキーマ間の移送がそのままできる）。
最新のダンプにはスクリプトが backup/<database>-latest.sql の symlink を張る（ls -t によるファイル解決は ls が eza 等に alias された環境で壊れるため使わない）。
# 同名リストア
mysql -h tidb.$TAILNET -P 4000 -u root -D blog_prd < backup/blog_prd-latest.sql
# 別スキーマへのリストア（例: 本番データを dev へ）
mysql -h tidb.$TAILNET -P 4000 -u root -D blog_dev < backup/blog_prd-latest.sql
リストア先の DB 自体は存在している前提（無ければ CREATE DATABASE を手動で実行する）。2026-07-05 06:10 より前に取得したダンプは旧仕様（--databases 付き）で CREATE DATABASE / USE blog_prd を含むため、別スキーマに戻す場合は grep -v -e '^CREATE DATABASE ' -e '^USE ' で除外してから流すこと。
ハマりどころ: mysqldump 8.x の --single-transaction が使えない
TiDB v8.1 に対して mysqldump 8.4 の --single-transaction を使うと以下で失敗する。
mysqldump: Couldn't execute 'ROLLBACK TO SAVEPOINT sp': SAVEPOINT sp does not exist (1305)
mysqldump 8.0.24 以降は --single-transaction 時にテーブルごとに SAVEPOINT / ROLLBACK TO SAVEPOINT を発行するが、TiDB 側とかみ合わない。そのため dump-tidb.sh では --single-transaction をやめ、以下のフラグ構成にしている。
mysqldump -h tidb.$TAILNET -P 4000 -u root \
--skip-lock-tables --skip-add-locks --no-tablespaces --set-gtid-purged=OFF \
--databases blog_prd
テーブル間の完全なスナップショット一貫性は保証されないが、書き込み頻度の低いブログ DB では実用上問題ない。厳密なスナップショットや大規模データが必要になったら Dumpling / BR に移行する（参照: 2026-06-27-tidb-full-rebuild.md の「事前: データ退避」）。
実行記録
2026-07-05:
blog_prdを取得。articles 131 / users 1 / tags 0 / articles_tags 0、2.5MB