本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

項目資料集結構描述要求 （自訂）

項目資料集會將項目的中繼資料存放在目錄中。這可能包括每個項目的價格、類型和可用性等資訊。如需可匯入 Amazon Personalize 的項目資料類型資訊，請參閱 項目中繼資料。

您為每個項目提供的資料必須符合您的項目資料集結構描述。您必須為每個項目提供項目 ID （長度上限為 256 個字元）。根據您的結構描述，項目中繼資料可以包含空值/空值。您的結構描述必須至少有一個中繼資料欄位，但如果您新增null類型，則項目的此值可以是 null。您可以根據您的使用案例和資料，自由新增其他欄位。只要欄位未列為必要或預留，且資料類型列於 中結構描述資料類型，欄位名稱和資料類型將由您決定。

若要使用分類資料，請在結構描述true中新增 類型的欄位，string並將欄位的分類屬性設定為 。然後在大量 CSV 檔案和個別項目匯入中包含分類資料。分類值最多可以有 1000 個字元。如果您有類別值超過 1000 個字元的項目，您的資料集匯入任務將會失敗。

對於具有多個類別的項目，請以垂直長條 '|' 分隔每個值。例如，對於 GENRES 欄位，項目的資料可能是 Action|Crime|Biopic。如果您有多個層級的分類資料，而且有些項目在階層中每個層級都有多個類別，請為每個層級新增欄位，並在每個欄位名稱後面附加層級指標：GENRES、GENRE_L2、GENRE_L3。這可讓您根據子類別篩選建議，即使項目屬於多個多層級類別 （如需建立和使用篩選條件的相關資訊，請參閱 篩選建議和使用者區段)。例如，影片可能具有每個類別層級的下列資料：

在此範例中，影片位於動作 > 犯罪 > 生物特徵階層和冒險 > 西部 > 生物特徵階層。我們建議最多只使用 L3，但如有必要，您可以使用更多層級。

在模型訓練期間，Amazon Personalize 會考慮最多 750，000 個項目。如果您匯入超過 750，000 個項目，Amazon Personalize 會決定要在訓練中包含哪些項目，並著重於包含新項目 （您最近新增但未互動的項目） 和具有最近互動資料的現有項目。

如需項目資料集最低需求和最高資料限制的詳細資訊，請參閱Service Quotas。

項目資料集結構描述範例 （自訂）

下列範例示範如何建構項目結構描述。ITEM_ID 欄位是必要的。GENRE 欄位是分類中繼資料，而 DESCRIPTION 欄位是文字中繼資料。至少需要一個中繼資料欄位。您最多可以新增 100 個中繼資料欄位。CREATION_TIMESTAMP 欄位是預留關鍵字。如需結構描述需求的相關資訊，請參閱 自訂資料集和結構描述需求。

{
  "type": "record",
  "name": "Items",
  "namespace": "com.amazonaws.personalize.schema",
  "fields": [
    {
      "name": "ITEM_ID",
      "type": "string"
    },
    {
      "name": "GENRES",
      "type": [
        "null",
        "string"
      ],
      "categorical": true
    },
    {
      "name": "CREATION_TIMESTAMP",
      "type": "long"
    },
    {
      "name": "DESCRIPTION",
      "type": [
        "null",
        "string"
      ],
      "textual": true
    }
  ],
  "version": "1.0"
}

在此結構描述中，CSV 檔案中的前幾行歷史資料看起來可能會如下所示。

ITEM_ID,GENRES,CREATION_TIMESTAMP,DESCRIPTION
1,Adventure|Animation|Children|Comedy|Fantasy,1570003267,"This is an animated movie that features action, comedy, and fantasy. Audience is children. This movie was released in 2004."
2,Adventure|Children|Fantasy,1571730101,"This is an adventure movie with elements of fantasy. Audience is children. This movie was release in 2010."
3,Comedy|Romance,1560515629,"This is a romantic comedy. The movie was released in 1999. Audience is young women."
4,Comedy|Drama|Romance,1581670067,"This movie includes elements of both comedy and drama as well as romance. This movie was released in 2020."
...
...