分類セットファイル形式

JSON ファイル形式は、JSON 行（JSONL）の規則に従います。 ファイルには、1 行に 1 つの JSON オブジェクトが含まれている必要があります。各オブジェクトは、1 つの分類レコードを表します。

JSON 構造

各 JSON オブジェクトには、以下を含める必要があります。

• key （必須）：分類レコードの一意の ID

• data （更新に必要）：分類列名とその値を含むオブジェクト

• action （任意）：実行するアクション。 次の値がサポートされています。

  • update （デフォルト）
  • delete-field
  • delete-key

• enc （任意）：データエンコーディングの仕様。 次の値がサポートされています。

  • utf8 または UTF8 （デフォルト）
  • latin1 またはLATIN1

すべての JSON フィールド名（key、data、action、enc）は大文字と小文字が区別され、小文字にする必要があります。

JSON の例

基本更新レコード：

{"key": "product123", "data": {"Product Name": "Basketball Shoes", "Brand": "Brand A", "Category": "Sports"}}

指定されたエンコーディングで更新：

{"key": "product456", "enc": "utf8", "data": {"Product Name": "Running Shoes", "Brand": "Brand B"}}

特定のフィールドを削除：

{"key": "product789", "action": "delete-field", "data": {"Brand": null, "Category": null}}

キー全体を削除：

{"key": "product999", "action": "delete-key"}

JSON 検証ルール

• key フィールドは必須です。null または空白にすることはできません。
• update アクションの場合、「data」フィールドは必須であり、空白にすることはできません。
• delete-field アクションの場合、削除するフィールドが data フィールドに含まれている必要があります。
• delete-key のアクションの場合、「data」フィールドは存在できません。
• サポートされているエンコーディング値は、大文字と小文字を区別せず、標準の文字セット名を含みます。

CSV （Comma-Separated Values）ファイルでは、分類データフィールドを区切るためにコンマを使用します。

CSV 構造

• ヘッダー行：最初の行には列ヘッダーが含まれ、最初の列はキー列である必要があります。 後続の列は、分類セットスキーマの名前と一致する必要があります
• データ行：各行に分類データが含まれます
• 区切り文字：フィールドはコンマで区切られます
• 引用符：コンマ、引用符、改行を含むフィールドは、二重引用符で囲む必要があります

CSV サンプル

基本分類データ：

Key,Product Name,Brand,Category,Price
product123,"Basketball Shoes",Brand A,Sports,89.99
product456,"Running Shoes",Brand B,Sports,79.99
product789,"Winter Jacket",Brand C,Clothing,149.99

キー全体を削除：

Key,Product Name,Brand,Category,Price
product999,~deletekey~,,,

特定のフィールドを削除する（更新と混在）:

Key,Product Name,Brand,Category,Price
product123,"Updated Product Name",Brand A,Sports,89.99
product456,,~empty~,~empty~,79.99

CSV 形式ルール

• コンマを含むフィールドは、二重引用符で囲む必要があります。
• 二重引用符を含むフィールドは、そのフィールドを二重にエスケープする必要があります（""）。
• 空のフィールドは、その分類の null 値を表します。
• フィールドの先頭と末尾のスペースは、自動的に削除されます。
• 引用されたフィールド内の特殊文字（タブ、改行）は保持されます。

削除操作：

• 任意のフィールドで ~deletekey~ を使用すると、キー全体とそのすべての分類データを削除できます
• 特定のフィールドの ~empty~ を使用して、それらの分類値のみを削除します（他のフィールドはそのまま残します）
• ~empty~ を使用する場合、同じファイル内の削除と更新を混在させることができます

TSV （タブ区切り値）および TAB ファイルでは、タブ文字を使用して分類データフィールドを区切ります。

TSV とタブ構造

• ヘッダー行：最初の行には列ヘッダーが含まれ、最初の列はキー列である必要があります。 後続の列は、分類セットスキーマの名前と一致する必要があります。
• データ行：各行に分類データが含まれます。
• 区切り文字：フィールドはタブ文字（\t）で区切られます。
• 引用符：通常、引用符は必要ありませんが、一部の実装では引用符で囲まれたフィールドをサポートしています。

TSV と TAB の例

基本分類データ：

Key    Product Name    Brand    Category    Price
product123    Basketball Shoes    Brand A    Sports    89.99
product456    Running Shoes    Brand B    Sports    79.99
product789    Winter Jacket    Brand C    Clothing    149.99

キー全体を削除：

Key    Product Name    Brand    Category    Price
product999    ~deletekey~

特定のフィールドを削除する（更新と混在）:

Key    Product Name    Brand    Category    Price
product123    Updated Product Name    Brand A    Sports    89.99
product456        ~empty~    ~empty~    79.99

TSV/タブ形式ルール

• フィールドは、単一のタブ文字で区切られます。
• 空のフィールド（連続するタブ）は null 値を表します。
• 特別な引用は通常必要ありません。
• 先頭と末尾のスペースは保持されます。
• フィールド内の改行文字は避ける必要があります。

削除操作：

• 任意のフィールドで ~deletekey~ を使用すると、キー全体とそのすべての分類データを削除できます。
• 特定のフィールドの ~empty~ を使用して、それらの分類値のみを削除します（他のフィールドはそのまま残します）。
• ~empty~ を使用する場合、同じファイル内で削除と更新を混在させることができます。