データインポートの命名規則
TiDB Cloudには、CSV、Parquet、 Aurora Snapshot、SQL のファイル形式でデータをインポートできます。データが正常にインポートされるようにするには、次の 2 種類のファイルを準備する必要があります。
- スキーマファイル。データベーススキーマファイル（オプション）とテーブルスキーマファイルをSQL形式（
.sql）で準備します。テーブルスキーマファイルが提供されていない場合は、事前にターゲットデータベースに対応するテーブルを手動で作成する必要があります。 - データ ファイル。データをインポートするための命名規則に準拠したデータ ファイルを準備します。データ ファイル名が要件を満たせない場合は、 ファイルパターンを使用してインポート タスクを実行することをお勧めします。そうしないと、インポート タスクはインポートするデータ ファイルをスキャンできません。
スキーマファイルの命名規則
このセクションでは、データベースおよびテーブル スキーマ ファイルの命名規則について説明します。スキーマ ファイルの命名規則は、CSV、Parquet、 Aurora Snapshot、SQL のすべての種類のソース ファイルで同じです。
スキーマ ファイルの命名規則は次のとおりです。
- データベーススキーマファイル（オプション）:
${db_name}-schema-create.sql - テーブルスキーマファイル:
${db_name}.${table_name}-schema.sql
以下はデータベース スキーマ ファイルの例です。
名前:
import_db-schema-create.sqlファイルの内容:
CREATE DATABASE import_db;
以下はテーブル スキーマ ファイルの例です。
名前:
import_db.test_table-schema.sqlファイルの内容:
CREATE TABLE test_table ( id INTEGER PRIMARY KEY, val VARCHAR(255) );
データファイルの命名規則
このセクションでは、データ ファイルの命名規則について説明します。ソース ファイルの種類に応じて、データ ファイルの命名規則は異なります。
CSVファイル
CSV ファイルをインポートするときは、データ ファイルに次のように名前を付けます。
${db_name}.${table_name}${suffix}.csv.${compress}
${suffix}はオプションであり、次のいずれかの形式にすることができます。xxx xxx任意の数字にすることができます。
.xxx、例えば.01._xxx_xxx_xxx、例えば._0_0_01_xxx_xxx_xxx、例えば_0_0_01
${compress}は圧縮形式で、オプションです。TiDB TiDB Cloud は、 .gzip 、 .gz 、 .zstd 、 .zst 、 .snappyの形式をサポートしています。
たとえば、次のすべてのファイルのターゲット データベースとテーブルはimport_dbとtest_tableです。
import_db.test_table.csvimport_db.test_table.01.csvimport_db.test_table._0_0_01.csvimport_db.test_table_0_0_01.csvimport_db.test_table_0_0_01.csv.gz
注記：
Snappy 圧縮ファイルは公式Snappyフォーマットである必要があります。Snappy 圧縮の他のバリエーションはサポートされていません。
寄木細工
Parquet ファイルをインポートするときは、データ ファイルに次のように名前を付けます。
${db_name}.${table_name}${suffix}.parquet ( ${suffix}はオプション)
例えば：
import_db.test_table.parquetimport_db.test_table.01.parquet
Auroraスナップショット
Auroraスナップショット ファイルの場合、 ${db_name}.${table_name}/フォルダー内の.parquetサフィックスを持つすべてのファイルは命名規則に準拠しています。データ ファイル名には、「az、0-9、-、_、.」で構成される任意のプレフィックスと「.parquet」サフィックスを含めることができます。
例えば：
import_db.test_table/mydata.parquetimport_db.test_table/part001/mydata.parquetimport_db.test_table/part002/mydata-part002.parquet
構文
SQL ファイルをインポートするときは、データ ファイルに次のように名前を付けます。
${db_name}.${table_name}${suffix}.sql.${compress}
${suffix}はオプションであり、次のいずれかの形式にすることができます。xxx xxx任意の数字にすることができます。
.xxx、例えば.01._xxx_xxx_xxx、例えば._0_0_01_xxx_xxx_xxx、例えば_0_0_01
${compress}は圧縮形式で、オプションです。TiDB TiDB Cloud は、 .gzip 、 .gz 、 .zstd 、 .zst 、 .snappyの形式をサポートしています。
例えば：
import_db.test_table.sqlimport_db.test_table.01.sqlimport_db.test_table.01.sql.gz
SQL ファイルがデフォルト設定で TiDB Dumplingを介してエクスポートされる場合、デフォルトで命名規則に準拠します。
注記：
Snappy 圧縮ファイルは公式Snappyフォーマットである必要があります。Snappy 圧縮の他のバリエーションはサポートされていません。
ファイルパターン
CSV または Parquet のソース データ ファイルが命名規則に準拠していない場合は、ファイル パターン機能を使用して、ソース データ ファイルとターゲット テーブル間の名前マッピング関係を確立できます。この機能は、 Auroraスナップショットおよび SQL データ ファイルをサポートしていません。
- CSVファイルについては、 ステップ4. CSVファイルをTiDB Cloudにインポートするの詳細設定>マッピング設定を参照してください。
- Parquetファイルについては、 ステップ4. ParquetファイルをTiDB Cloudにインポートするの詳細設定>マッピング設定を参照してください。