TiDB データ移行のクイックスタートガイド

このドキュメントでは、 TiDB データ移行 (DM) を使用して MySQL から TiDB にデータを移行する方法について説明します。このガイドは、DM 機能の簡単なデモであり、実稼働環境には推奨されません。

ステップ 1: DM クラスターをデプロイする

TiUP をインストールし、TiUP を使用してdmctlをインストールします。

curl --proto '=https' --tlsv1.2 -sSf https://tiup-mirrors.pingcap.com/install.sh | sh
tiup install dm dmctl

DM クラスターの最小限のデプロイトポロジファイルを生成します。
```
tiup dm template
```
出力の構成情報をコピーし、変更された IP アドレスを持つtopology.yamlのファイルとして保存します。 TiUP を使用してtopology.yamlのファイルで DM クラスターをデプロイします。
```
tiup dm deploy dm-test 6.0.0 topology.yaml -p
```

ステップ 2: データソースを準備する

1 つまたは複数の MySQL インスタンスをアップストリームデータソースとして使用できます。

次のように、各データソースの構成ファイルを作成します。

source-id: "mysql-01"
from:
  host: "127.0.0.1"
  user: "root"
  password: "fCxfQ9XKCezSzuCD0Wf5dUD+LsKegSg="  # encrypt with `tiup dmctl --encrypt "123456"`
  port: 3306

次のコマンドを実行して、ソースを DM クラスターに追加します。 mysql-01.yamlは、前のステップで作成された構成ファイルです。
```
tiup dmctl --master-addr=127.0.0.1:8261 operate-source create mysql-01.yaml # use one of master_servers as the argument of --master-addr
```

テスト用の MySQL インスタンスがない場合は、次の手順に従って Docker で MySQL インスタンスを作成できます。

MySQL 構成ファイルを作成します。

mkdir -p /tmp/mysqltest && cd /tmp/mysqltest

cat > my.cnf <<EOF
[mysqld]
bind-address     = 0.0.0.0
character-set-server=utf8
collation-server=utf8_bin
default-storage-engine=INNODB
transaction-isolation=READ-COMMITTED
server-id        = 100
binlog_format    = row
log_bin          = /var/lib/mysql/mysql-bin.log
show_compatibility_56 = ON
EOF

Docker を使用して MySQL インスタンスを開始します。

docker run --name mysql-01 -v /tmp/mysqltest:/etc/mysql/conf.d -e MYSQL_ROOT_PASSWORD=my-secret-pw -d -p 3306:3306 mysql:5.7

MySQL インスタンスが起動したら、インスタンスにアクセスします。
ノート：
このコマンドは、データ移行の試行にのみ適しており、本番環境やストレステストでは使用できません。
```
mysql -uroot -p -h 127.0.0.1 -P 3306
```

ステップ 3: ダウンストリームデータベースを準備する

データ移行のターゲットとして、既存の TiDB クラスターを選択できます。

テスト用の TiDB クラスターがない場合は、次のコマンドを実行してデモ環境をすばやく構築できます。

tiup playground

ステップ 4: テストデータを準備する

1 つまたは複数のデータソースにテストテーブルとデータを作成します。既存の MySQL データベースを使用していて、データベースに利用可能なデータが含まれている場合は、この手順を省略できます。

drop database if exists `testdm`;
create database `testdm`;
use `testdm`;
create table t1 (id bigint, uid int, name varchar(80), info varchar(100), primary key (`id`), unique key(`uid`)) DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin;
create table t2 (id bigint, uid int, name varchar(80), info varchar(100), primary key (`id`), unique key(`uid`)) DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin;
insert into t1 (id, uid, name) values (1, 10001, 'Gabriel García Márquez'), (2, 10002, 'Cien años de soledad');
insert into t2 (id, uid, name) values (3, 20001, 'José Arcadio Buendía'), (4, 20002, 'Úrsula Iguarán'), (5, 20003, 'José Arcadio');

ステップ 5: データ移行タスクを作成する

タスク構成ファイルを作成しますtestdm-task.yaml :

name: testdm
task-mode: all

target-database:
  host: "127.0.0.1"
  port: 4000
  user: "root"
  password: "" # If the password is not empty, it is recommended to use a password encrypted with dmctl.

# Configure the information of one or multiple data sources
mysql-instances:
  - source-id: "mysql-01"
    block-allow-list:  "ba-rule1"

block-allow-list:
  ba-rule1:
    do-dbs: ["testdm"]

dmctl を使用してタスクを作成します。

tiup dmctl --master-addr 127.0.0.1:8261 start-task testdm-task.yaml

mysql-01データベースから TiDB にデータを移行するタスクが正常に作成されました。

ステップ 6: タスクのステータスを確認する

タスクが作成されたら、 dmctl query-statusコマンドを使用してタスクのステータスを確認できます。

tiup dmctl --master-addr 127.0.0.1:8261 query-status testdm

TiDB データ移行のクイック スタート ガイド