MySQL Vitess sandbox route 的核心責任是讓讀者用 sandbox 理解 Vitess 如何把 MySQL 拓展成 sharded database platform。這篇承接 Vitess Sharding 與 MySQL to PlanetScale。

本文的驗收標準是：你能建立 sandbox、辨識 keyspace / shard / tablet / vtgate、跑基本 query，並記錄 resharding preview 的 evidence。

官方文件路由的核心責任是固定 sandbox 指令。實作前先查 Vitess local install docs；本文最後檢查日是 2026-05-22。

Concept Map

Concept map 的核心責任是先建立 Vitess vocabulary。

Vitess 的重點是 routing 與 resharding。Application 看到的是 vtgate；底下是多個 MySQL tablet 與 topology service。

Sandbox Setup

Sandbox setup 的核心責任是使用官方 sandbox 建立可丟棄環境。實際命令依 Vitess 版本調整，正式操作以 Vitess 官方文件為準。

1# Conceptual route. Use the current Vitess examples for exact commands.
2git clone https://github.com/vitessio/vitess.git
3cd vitess/examples/local
4./101_initial_cluster.sh

啟動後要記錄：

1. Vitess version。
2. Keyspace name。
3. Shard count。
4. vtgate host / port。
5. Tablet roles。

Query Through vtgate

Query through vtgate 的核心責任是確認 application 走 routing layer。

1mysql -h 127.0.0.1 -P 15306 -u user <<'SQL'
2SHOW DATABASES;
3USE commerce;
4SHOW TABLES;
5SELECT * FROM product LIMIT 5;
6SQL

Evidence 要包含 query result、target keyspace、vtgate endpoint 與 tablet health。Production migration 要確認 ORM / driver 對 vtgate 的相容性。

VSchema Review

VSchema review 的核心責任是理解 shard key 與 routing。

1# Conceptual command; exact path depends on sandbox.
2cat vschema_commerce_initial.json

審查問題：

1. 哪些 table 是 sharded。
2. shard key / vindex 是什麼。
3. lookup vindex 是否需要維護。
4. cross-shard query 是否存在。
5. sequence / id generation 如何處理。

VSchema 是 Vitess migration 的核心設計文件。選錯 shard key 會讓跨 shard transaction、hot shard 與 resharding 成本升高。

Resharding Preview

Resharding preview 的核心責任是看見 Vitess 的主要價值與操作成本。

Resharding evidence 欄位：

1source shard:
2target shards:
3workflow name:
4copy phase duration:
5replication lag:
6cutover time:
7validation query:
8rollback:

Resharding 是 production operation，不只是一次 migration。Runbook 要包含 throttling、lag、tablet health、cutover 與 application query validation。

Migration Decision

Migration decision 的核心責任是判斷何時從 MySQL 走向 Vitess / PlanetScale 類路線。

完成本篇後，設計細節讀 Vitess Sharding；managed route 讀 MySQL to PlanetScale。