TiDB Lightningを始めましょう

このチュートリアルでは、いくつかの新しいクリーンな CentOS 7 インスタンスを使用することを前提としています。 VMware、VirtualBox、またはその他のツールを使用して、仮想マシンをローカルに展開したり、ベンダー提供のプラットフォームに小規模なクラウド仮想マシンを展開したりできます。 TiDB Lightning は大量のコンピュータリソースを消費するため、最高のパフォーマンスで実行するには、少なくとも 16 GB のメモリと 32 コアの CPU を割り当てることをお勧めします。

警告

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

フルバックアップデータを準備する

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

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/

上記のコマンドでは次のようになります。

-B test : データがtestデータベースからエクスポートされることを意味します。
-f test.t[12] : test.t1とtest.t2テーブルのみがエクスポートされることを意味します。
-t 16 : データのエクスポートに 16 スレッドが使用されることを意味します。
-F 256MB : テーブルが複数のチャンクに分割されており、1 つのチャンクが 256 MB であることを意味します。

このコマンドを実行すると、フルバックアップデータが/data/my_databaseディレクトリにエクスポートされます。

TiDB Lightningのデプロイ

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

データをインポートする前に、TiDB クラスターをデプロイする必要があります。このチュートリアルでは、TiDB v5.4.0 を例として使用します。導入方法についてはTiUPを使用した TiDBクラスタのデプロイを参照してください。

ステップ 2: TiDB Lightningインストールパッケージをダウンロードする

TiDB Lightningインストールパッケージは、 TiDB Toolkitに含まれています。 TiDB Toolkitをダウンロードするには、 TiDB ツールをダウンロードを参照してください。

ノート：
TiDB Lightning は、以前のバージョンの TiDB クラスターと互換性があります。 TiDB Lightningインストールパッケージの最新の安定バージョンをダウンロードすることをお勧めします。

ステップ 3: `tidb-lightning`を開始する

パッケージ内のbin/tidb-lightningとbin/tidb-lightning-ctl 、 TiDB Lightningがデプロイされているサーバーにアップロードします。
準備されたデータソースをサーバーにアップロードします。

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"

パラメータを適切に設定した後、 nohupコマンドを使用してtidb-lightningプロセスを開始します。コマンドラインでコマンドを直接実行すると、SIGHUP シグナルの受信によりプロセスが終了する可能性があります。代わりに、次のnohupコマンドを含む bash スクリプトを実行することをお勧めします。
```
#!/bin/bash
nohup tiup tidb-lightning -config tidb-lightning.toml > nohup.out &
```

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

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

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

まとめ

このチュートリアルでは、 TiDB Lightning とは何か、およびTiDB Lightningクラスターを迅速にデプロイしてフルバックアップデータを TiDB クラスターにインポートする方法を簡単に紹介します。

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