分類セットファイル形式

JSON ファイル形式は、JSON ライン（JSONL）の規則に従います。 ファイルには、行ごとに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 フィールドは必須です。nullまたは空にすることはできません。
• update アクションの場合、data フィールドは必須です。空にすることはできません。
• delete-field アクションの場合、data フィールドには削除するフィールドを含める必要があります。
• delete-key アクションの場合、data フィールドは存在しない必要があります。
• サポートされるエンコーディング値では、大文字と小文字が区別されず、標準文字列名が含まれます。

JSONの例

JSON ファイル内の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"}

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

CSV構造

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

CSV形式ルール

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

CSV削除操作

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

CSVの例

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

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

TSVとTABの構造

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

TSVとTABの書式設定ルール

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

TSVおよびTABの削除操作

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

TSVとTABの例

TSVまたはTAB ファイル内の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