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 | shTiUPを使用してDumplingをインストールする:
tiup install dumplingMySQL からデータをエクスポートするには、 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]'
: 2 つのテーブルtest.t1
とtest.t2
のみをエクスポートします。
エクスポートされた完全バックアップ データは
/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の概要を参照してください。