重要

このページは英語版のページを機械翻訳しています。原文はこちらからご覧ください。

TiDB Lightning事前チェック

TiDB 5.3.0 以降、 TiDB Lightningは、移行タスクを実行する前に構成をチェックする機能を提供します。デフォルトで有効になっています。この機能は、ディスク容量と実行構成の定期的なチェックを自動的に実行します。主な目的は、後続のインポートプロセス全体がスムーズに進むようにすることです。

次の表に、各チェック項目と詳細な説明を示します。

チェック項目	対応バージョン	説明
クラスタのバージョンとステータス	= 5.3.0	クラスタ接続可能な構成か、TiKV/PD/TiFlashのバージョンが物理インポートモードに対応しているかを確認してください。
権限	= 5.3.0	データソースがクラウドストレージ (Amazon S3) の場合、 TiDB Lightningに必要な権限があるかどうかを確認し、権限がないためにインポートが失敗しないことを確認します。
ディスクスペース	= 5.3.0	ローカルディスクと TiKV クラスターに、データをインポートするための十分なスペースがあるかどうかを確認します。 TiDB Lightningはデータソースをサンプリングし、サンプル結果からインデックスサイズのパーセンテージを推定します。推定にはインデックスが含まれているため、ソースデータのサイズがローカルディスクの使用可能な領域よりも小さい場合がありますが、それでもチェックは失敗します。物理的なインポートモードでは、外部の並べ替えをローカルで行う必要があるため、 TiDB Lightningはローカルストレージが十分かどうかもチェックします。 TiKV クラスタースペースとローカルストレージスペース ( `sort-kv-dir`で制御) の詳細については、ダウンストリームのストレージ容量要件とリソース要件を参照してください。
リージョン分布状況	= 5.3.0	TiKV クラスター内のリージョンが均等に分散されているかどうか、および空のリージョンが多すぎるかどうかを確認します。空のリージョンの数が max(1000, テーブル数 * 3) を超える場合、つまり、「1000」または「テーブル数の 3 倍」のいずれか大きい方より大きい場合、インポートは実行できません。
データファイル内の非常に大きな CSV ファイル	= 5.3.0	バックアップファイルに 10 GiB を超える CSV ファイルがあり、自動スライスが有効になっていない (StrictFormat=false) 場合、インポートのパフォーマンスに影響します。このチェックの目的は、データが正しい形式であることを確認し、自動スライスを有効にすることを確認することです。
ブレークポイントからの回復	= 5.3.0	このチェックにより、ブレークポイントリカバリプロセス中に、データベース内のソースファイルまたはスキーマに変更が加えられないことが保証されます。これにより、間違ったデータがインポートされます。
既存のテーブルにインポートする	= 5.3.0	作成済みのテーブルにインポートする場合、ソースファイルが既存のテーブルと一致するかどうかを可能な限りチェックします。列数が一致しているかどうかを確認します。ソースファイルに列名がある場合は、列名が一致するかどうかを確認します。ソースファイルに既定の列がある場合、既定の列に既定値があるかどうかがチェックされ、既定値がある場合はチェックに合格します。
ターゲットテーブルが空かどうか	= 5.3.1	ターゲットテーブルが空でない場合、 TiDB Lightningはエラーで自動的に終了します。並行輸入モードが有効な場合 ( `incremental-import = true` )、このチェック項目はスキップされます。

このページは役に立ちましたか？