TiDB Lightningのクイックスタート

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

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

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

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

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

2. TiUPを使用してDumplingをインストールする:

   tiup install dumpling
   

3. 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に移行するを参照してください。

1. 構成ファイル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. Starting from v7.6.0, TiDB supports setting multiple PD addresses.
   pd-addr = "172.16.31.3:2379,56.78.90.12:3456"
   

2. 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 の概要を参照してください。