Skip to content

Add MySQL HeatWave to TiDB Cloud migration module#2

Open
ayenller wants to merge 2 commits into
pingcap-inc:mainfrom
ayenller:heatwave-to-tidb
Open

Add MySQL HeatWave to TiDB Cloud migration module#2
ayenller wants to merge 2 commits into
pingcap-inc:mainfrom
ayenller:heatwave-to-tidb

Conversation

@ayenller

@ayenller ayenller commented Jul 8, 2026

Copy link
Copy Markdown

Summary

Adds a new migration path: MySQL HeatWave → TiDB Cloud.

  • heatwave-to-tidb/ — AI skill (SKILL.md) + Python CLI (tishift-heatwave) covering scan (readiness scoring), convert (DDL cleanup + TiFlash replica emission), and reference docs for the load/check/sync phases.
  • Compatibility rules are grounded in docs.pingcap.com/tidbcloud/mysql-compatibility: character-set support, lower_case_table_names, updatable views, FULLTEXT tier gating, native FK enforcement (v6.6+).
  • Registers the module in the root README.md (Supported Migration Paths table, skill-run section, CLI Toolkit section, tests section, Project Structure tree) and extends .gitignore to keep generated migration configs and scan/convert/load run output out of version control across all modules.
  • 174 tests, verified end-to-end against a live HeatWave instance and TiDB Cloud target.

Test plan

  • cd heatwave-to-tidb && pytest tests -q — 174 passed
  • Live scan against a HeatWave DB System (AWS) — readiness score, blockers/warnings all correct
  • Live convert + apply against a TiDB Cloud Starter cluster — DDL cleanup, TiFlash replicas AVAILABLE=1
  • Structure diff (source vs. target): 74/74 columns match

🤖 Generated with Claude Code

ayenller and others added 2 commits July 8, 2026 17:28
MySQL HeatWave -> TiDB Cloud migration toolkit: AI skill (SKILL.md) plus a
Python CLI (tishift-heatwave) covering scan (readiness scoring), convert
(DDL cleanup + TiFlash replica emission), and reference docs for load/
check/sync phases. Compatibility rules are grounded in
docs.pingcap.com/tidbcloud/mysql-compatibility (charset support,
lower_case_table_names, updatable views, FULLTEXT tier gating, native FK
enforcement). 174 tests, verified end-to-end against a live HeatWave
instance and TiDB Cloud target.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Adds the module to the Supported Migration Paths table, Quick Start,
CLI usage, test-running section, and project structure tree. Extends
.gitignore to keep generated migration configs (tishift*.yaml, real
hostnames/credentials) and scan/convert/load run output (tishift-reports/,
tishift-load/, demo-reports/) out of version control across all modules.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant