データをインポートするための CSV 構成
このドキュメントでは、 TiDB Cloud上のデータのインポート サービスの CSV 構成を紹介します。
以下は、 TiDB Cloud上のデータインポートサービスを使用して CSV ファイルをインポートするときの CSVコンフィグレーションウィンドウです。詳細については、 Amazon S3 または GCS からTiDB Cloudに CSV ファイルをインポートを参照してください。
セパレータ
定義: フィールド区切り文字を定義します。 1 つまたは複数の文字を指定できますが、空であってはなりません。
一般的な値:
- CSV (カンマ区切り値) の場合は
,。上のスクリーンショットに示されているように、「1」、「Michael」、および「male」は 3 つのフィールドを表します。 - TSV の場合は
"\t"(タブ区切り値)。
- CSV (カンマ区切り値) の場合は
デフォルト:
,
デリミタ
定義: 引用符で使用する区切り文字を定義します。 Delimiterが空の場合、すべてのフィールドは引用符で囲まれません。
一般的な値:
'"'フィールドを二重引用符で囲みます。上のスクリーンショットに示されているように、"Michael","male"2 つのフィールドを表します。 2 つのフィールドの間には,が必要であることに注意してください。データが"Michael""male"(,を除く) の場合、インポート タスクは解析に失敗します。データが"Michael,male"(二重引用符が 1 つだけある) の場合、1 つのフィールドとして解析されます。''引用を無効にします。
デフォルト:
"
ヘッダー付き
定義:すべてのCSV ファイルにヘッダー行が含まれているかどうか。 With headerが
Trueの場合、最初の行が列名として使用されます。 With headerがFalseの場合、最初の行は通常のデータ行として扱われます。デフォルト:
True
バックスラッシュのエスケープ
定義: フィールド内のバックスラッシュをエスケープ文字として解析するかどうか。バックスラッシュ エスケープが
Trueの場合、次のシーケンスが認識されて変換されます。シーケンス に変換 \0ヌル文字 ( U+0000)\bバックスペース ( U+0008)\n改行 ( U+000A)\rキャリッジリターン ( U+000D)\tタブ ( U+0009)\ZWindows EOF ( U+001A)他のすべての場合 (たとえば、
\")、バックスラッシュは取り除かれ、次の文字 (") がフィールドに残ります。左側の文字には特別な役割 (デリミタなど) はなく、単なる通常の文字です。引用符は、バックスラッシュがエスケープ文字として解析されるかどうかには影響しません。次のフィールドを例として取り上げます。
- 値が
Trueの場合、"nick name is \"Mike\""nick name is "Mike"として解析され、ターゲット テーブルに書き込まれます。 - 値が
Falseの場合、値は"nick name is \"、Mike\、および""の 3 つのフィールドとして解析されます。ただし、フィールドが互いに分離されていないため、正しく解析できません。
標準の CSV ファイルの場合、記録するフィールドに二重引用符で囲まれた文字がある場合は、二重引用符を 2 つ使用してエスケープする必要があります。この場合、
Backslash escape = Trueを使用すると解析エラーが発生しますが、Backslash escape = False使用すると正しく解析されます。一般的なシナリオは、インポートされたフィールドに JSON コンテンツが含まれている場合です。標準の CSV JSON フィールドは通常、次のように保存されます。"{""key1"":""val1"", ""key2"": ""val2""}"この場合、
Backslash escape = False設定すると、次のようにフィールドがデータベースに正しくエスケープされます。{"key1": "val1", "key2": "val2"}以下のようにCSVソースファイルの内容をJSONとして保存する場合は、以下のように設定
Backslash escape = Trueを検討してください。ただし、これは CSV の標準形式ではありません。"{\"key1\": \"val1\", \"key2\":\"val2\" }"- 値が
デフォルト:
True