はじめに

PlanetscaleのHobbyプランが4月8日に終了することが発表されました。

TiDB Serverless は、同じくMySQL互換のサーバレスデータベースで、クレジットカード不要で無料枠があります。移行先として是非利用を検討してみてください。

PlanetscaleからTiDB Serverlessへのデータ移行方法について紹介していきます。

移行手段

TiDBもMySQL互換のため、基本的にはMySQLツール群、SQLが利用できますが、移行に関しては二点考慮点があります。

Planetscaleはsqlでのデータ出力に10万行の制限があります。このため、このデータ量を超える場合は単純なmysqldump & mysqlimportでの移行はできません。

TiDB Serverlessは現時点でMySQL 5.7互換のv7.1.1です。そのため、Planetscaleの標準COLLATIONのutf8mb4_0900_ai_ci に対応していません。

この記事では、これらを考慮した移行方法をご紹介したいと思います。利用環境はMacOSを想定していますが、Bash/Zshコンソールが利用出来る環境であれば同じ手順で移行できると思います。

前提条件

Bash/Zshが利用できること
pscale CLI がインストール済みであること
MySQL clientがインストール済みであること

移行手順

データのエクスポート

データのエクスポートには、pscale cliを利用します。pscale database dump [db] [branch] です。

> pscale database dump testdb2 main
Starting to dump all tables from database testdb2 to folder /Users/bohnen/.../pscale_dump_testdb2_main_20240307_164703
Dumping is finished! (elapsed time: 6.782051792s)

今回は700MBくらいのデータを利用しましたが、10万行の制限を超えていても問題なくダウンロードできています。

データは、新しく作成されたディレクトリの中に、スキーマファイルとデータファイルの形でエクスポートされています。

> ls
metadata 
testdb2.history-schema.sql
testdb2.new_order.00001.sql
testdb2.stock-schema.sql
...

基本的にはこのsqlを順次実行すれば、データ移行は完了します。

スキーマの変更

TiDB Serverlessではまだutf8mb4_0900_ai_ciに対応していないので、一律変換します。

TiDB Dedicatedで提供されている最新のLTS, v7.5.1ではutf8mb4_0900_ai_ciはサポートされています。詳細は公式Docを参照してください。

cd [exportしたディレクトリ]
for f in *-schema.sql; do sed -i -e  's/0900_ai_ci/bin/' $f; done;

データベースの作成

TiDB Serverlessクラスタを起動しておきます。
TiDBに接続して、データのインポート先であるデータベーススキーマを作成しておきます。

TiDB Serverlessが初めての方は、こちらの入門記事をご覧ください

Chat2Queryで作成してもよし、MySQL clientで接続してもよいです。

CREATE DATABASE [データベース名];

テーブルの作成

schema.sql を流していきます。TiDB Serverlessへ MySQL clientで接続していきます。

for f in *-schema.sql; 
do mysql --comments -u [user] -h gateway01.ap-northeast-1.prod.aws.tidbcloud.com -P 4000 -D [database] --ssl-mode=VERIFY_IDENTITY --ssl-ca=/etc/ssl/cert.pem -p[password] < $f ; 
done;

※実際は一行ですが見やすさのために改行しています。[user][password][database]はご自身のものをご利用ください。

データのインポート

同様に、00001.sql を流していきます。

for f in *[0-9].sql; 
do mysql --comments -u [user] -h gateway01.ap-northeast-1.prod.aws.tidbcloud.com -P 4000 -D [database] --ssl-mode=VERIFY_IDENTITY --ssl-ca=/etc/ssl/cert.pem -p[password] < $f ; 
done;

これで完了です。

消費RU確認

TiDB Serverlessは5GB、5000万RU(Request Unit)分は無料です。

このRUの計算は難しいですが、だいたい書込容量に等しいです。今回700MB程度のデータをImportしてみた消費RUを確認してみます。

これは他のデータが元々700MBほど入っていたクラスタなのでストレージ容量は正確ではありませんが、

今回消費したRUは7.42M
消費したRow-based Storageは500MB強（TiDBでの圧縮後)

となりました。データインポート後もまだまだ無料でご利用いただけます。

是非、TiDB Serverlessを使ってみてください。

PlanetscaleからTiDB Serverlessにデータを移行する