TiDB Lightningのクイックスタート

このドキュメントでは、MySQL データを TiDB クラスターにインポートしてTiDB Lightningを使い始めるためのクイックガイドを提供します。

警告

このチュートリアルのデプロイメント方法は、テストとトライアルにのみ推奨されます。本番や開発環境には適用しないでください。

ステップ1: 完全バックアップデータを準備する

まず、団子使用して MySQL からデータをエクスポートできます。

tiup --version実行して、 TiUPがすでにインストールされているかどうかを確認します。TiUPがインストールされている場合は、この手順をスキップします。TiUPがインストールされていない場合は、次のコマンドを実行します。

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

TiUPを使用してDumpling をインストールする:
```
tiup install dumpling
```
MySQLからデータをエクスポートするには、 Dumpling を使用してデータをエクスポートするに記載されている詳細な手順を参照してください。
```
tiup dumpling -h 127.0.0.1 -P 3306 -u root -t 16 -F 256MB -B test -f 'test.t[12]' -o /data/my_database/
```
上記のコマンドでは:
- -t 16 : 16 スレッドを使用してデータをエクスポートします。
- -F 256MB : 各テーブルを複数のファイルに分割し、各ファイルのサイズを約 256 MB にします。
- -B test : testデータベースからエクスポートします。
- -f 'test.t[12]' : テーブルtest.t1とtest.t2 2 つのテーブルのみをエクスポートします。
エクスポートされた完全バックアップデータは/data/my_databaseディレクトリに保存されます。

ステップ2: TiDBクラスターをデプロイ

データのインポートを開始する前に、インポート用の TiDB クラスターをデプロイする必要があります。すでに TiDB クラスターがある場合は、この手順をスキップできます。

TiDB クラスターをデプロイする手順については、 TiDB データベースプラットフォームのクイックスタートガイドを参照してください。

ステップ3: TiDB Lightningをインストールする

次のコマンドを実行して、 TiDB Lightningの最新バージョンをインストールします。

tiup install tidb-lightning

ステップ4: TiDB Lightningを起動する

注記：
このセクションのインポート方法は、テストと機能体験にのみ適しています。本番環境では、大規模なデータセットをMySQLからTiDBに移行するを参照してください。

構成ファイルtidb-lightning.tomlを作成し、クラスター情報に基づいて次の設定を入力します。

[lightning]
# Logging
level = "info"
file = "tidb-lightning.log"

[tikv-importer]
# Configure the import mode
backend = "local"
# Sets the directory for temporarily storing the sorted key-value pairs. The target directory must be empty.
sorted-kv-dir = "/mnt/ssd/sorted-kv-dir"

[mydumper]
# Local source data directory
data-source-dir = "/data/my_datasource/"

# Configures the wildcard rule. By default, all tables in the mysql, sys, INFORMATION_SCHEMA, PERFORMANCE_SCHEMA, METRICS_SCHEMA, and INSPECTION_SCHEMA system databases are filtered.
# If this item is not configured, the "cannot find schema" error occurs when system tables are imported.
filter = ['*.*', '!mysql.*', '!sys.*', '!INFORMATION_SCHEMA.*', '!PERFORMANCE_SCHEMA.*', '!METRICS_SCHEMA.*', '!INSPECTION_SCHEMA.*']
[tidb]
# Information of the target cluster
host = "172.16.31.2"
port = 4000
user = "root"
password = "rootroot"
# Table schema information is fetched from TiDB via this status-port.
status-port = 10080
# The PD address of the cluster
pd-addr = "172.16.31.3:2379"

tidb-lightningを実行します。 nohupを使用してコマンドラインで直接プログラムを起動するときにSIGHUPシグナルによってプログラムが終了するのを回避するには、 nohupコマンドをスクリプトに配置することをお勧めします。例:
```
#!/bin/bash
nohup tiup tidb-lightning -config tidb-lightning.toml > nohup.out &
```

ステップ5: データの整合性を確認する

インポートが完了すると、 TiDB Lightning は自動的に終了します。インポートが成功した場合は、ログファイルの最後の行にtidb lightning exit表示されます。

エラーが発生した場合は、 TiDB Lightningに関するよくある質問を参照してください。

まとめ

このチュートリアルでは、 TiDB Lightningとは何か、またTiDB Lightningクラスターをすばやく展開して完全バックアップデータを TiDB クラスターにインポートする方法について簡単に説明します。

TiDB Lightningの詳細な機能と使用方法については、 TiDB Lightning の概要を参照してください。

TiDB Lightningのクイック スタート