ローカル ファイルをTiDB Cloudにインポートする
ローカル ファイルをTiDB Cloudに直接インポートできます。数回クリックするだけでタスクの構成が完了し、ローカルの CSV データが TiDB クラスターにすばやくインポートされます。この方法を使用すると、クラウド ストレージ バケット パスとロール ARN を指定する必要はありません。インポートプロセス全体が迅速かつスムーズです。
現在、この方法では、1 つのタスクに対して 1 つの CSV ファイルを既存のテーブルまたは新しいテーブルにインポートすることがサポートされています。
制限事項
- 現在、 TiDB Cloudは、1 つのタスクで 50 MiB 以内の CSV 形式のローカル ファイルのインポートのみをサポートしています。
- ローカル ファイルのインポートは、専用層クラスターではなく、サーバーレス層クラスターでのみサポートされます。
- 同時に複数のインポート タスクを実行することはできません。
- CSV ファイルをTiDB Cloudの既存のテーブルにインポートする場合は、CSV ファイルの最初の行に列名が含まれていること、および CSV ファイルの列の順序がターゲット テーブルの列の順序と同じであることを確認してください。
ローカル ファイルのインポート
TiDB Cloudコンソールにログインし、左側のナビゲーション バーの上部でターゲット プロジェクトを選択します。
ターゲット クラスターを見つけて、クラスター領域の右上隅にある [ ... ] をクリックし、 [データのインポート] を選択します。
[インポート] ページで、右上隅にある [データのインポート] をクリックし、[ローカル ファイルから] を選択します。
[ファイルの**アップロード]**をクリックして、ターゲットのローカル ファイルを選択してアップロードします。ファイル名には「.csv」サフィックスが必要であり、50 MiB を超えてはならないことに注意してください。
[**ターゲット]**セクションで、ターゲット データベースとターゲット テーブルを選択するか、新しいデータベースまたは新しいテーブルを作成します。次に、[次へ] をクリックします。
新しいデータベースまたは新しいテーブルを作成するには、次のスクリーンショットに示すように、 +新しいデータベースの作成または+ 新しいテーブルの作成 をクリックし、データベース名またはテーブル名を直接入力して作成します。 TiDB Cloudは、CSV データと構成された列名に従って、データベースとテーブルを自動的に作成します。名前は、文字 (az および AZ) または数字 (0 から 9) で始まる必要があり、文字 (az および AZ)、数字 (0 から 9)、および下線 (_) 文字を含めることができます。
テーブルを確認してください。
ここでは、構成可能なテーブル列のリストを確認できます。各行には、 TiDB Cloudによって推測されたテーブル列名、推測されたテーブル列の型、および CSV ファイルからプレビューされたデータが表示されます。
TiDB Cloudの既存のテーブルにデータをインポートすると、列リストがテーブル定義から抽出され、プレビューされたデータが列名によって対応する列にマップされます。
新しいテーブルを作成する場合は、列リストが CSV ファイルから抽出され、列の型がTiDB Cloudによって推測されます。たとえば、プレビューされたデータがすべて整数の場合、推測される列の型はint (整数) になります。
列名とデータ型を構成します。
CSV ファイルの最初の行に列名が記録されている場合は、 [最初の行をカラム名として使用する]が選択されていることを確認します。これは既定で選択されています。
CSV ファイルに列名の行がない場合は、[**最初の行をカラム名として使用] を**選択しないでください。この場合:
CSV テーブルが既に存在する場合は、列の順序がターゲット テーブルの列リストと同じであることを確認してください。
CSV テーブルが作成されていない場合は、各列の名前を入力します。列名は、文字 (az および AZ) または数字 (0 から 9) で始まる必要があり、文字 (az および AZ)、数字 (0 から 9)、および下線 (_) 文字を含めることができます。必要に応じて、データ型を変更することもできます。
必要に応じて CSV 構成を編集します。
よりきめ細かい制御のために CSV 構成を編集するには、[ CSV 構成の編集] をクリックすることもできます。 CSV 構成の詳細については、 データをインポートするための CSV 構成を参照してください。
[**インポートの開始] を**クリックします。
[インポートの進行状況] セクションで、インポートの進行状況を確認できます。警告や失敗したタスクがある場合は、詳細を確認して解決できます。
