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

# 動作資料集結構描述需求 （自訂）
<a name="action-dataset-requirements"></a>

*動作*是您可能想要向客戶建議的參與活動。動作可能包括安裝您的行動應用程式、完成成員資格設定檔、加入您的忠誠度計劃，或註冊促銷電子郵件。*動作資料集*會儲存動作的資料。如需可匯入 Amazon Personalize 的動作資料類型資訊，請參閱 [動作中繼資料](actions-datasets.md)。

 您為每個動作提供的資料必須符合您的動作資料集結構描述。根據您的結構描述，動作中繼資料可以包含空值/空值。

您必須為每個項目提供動作 ID （長度上限為 256 個字元）。您的結構描述必須至少有一個中繼資料欄位，但如果您新增了`null`類型，則動作的這個值可以是 null。您可以根據您的使用案例和資料新增其他欄位。您可以選擇欄位名稱和資料類型，除非欄位列為必要或預留，且資料類型列於 中[結構描述資料類型](how-it-works-dataset-schema.md#personalize-datatypes)。

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

 如需動作資料集最低需求和最高資料限制的詳細資訊，請參閱 [Service Quotas](limits.md#limits-table)。

## 動作資料集結構描述範例 （自訂）
<a name="schema-examples-actions"></a>

下列範例示範如何建構動作結構描述。`ACTION_ID` 欄位是必要的。`MEMBERSHIP_LEVEL` 欄位是分類字串欄位。`VALUE`、 `CREATION_TIMESTAMP`和 `REPEAT_FREQUENCY` 欄位是具有必要類型的預留關鍵字。您最多可以新增 10 個資料欄。如需結構描述需求的相關資訊，請參閱 [自訂資料集和結構描述需求](custom-datasets-and-schemas.md#dataset-requirements)。

```
{
  "type": "record",
  "name": "Actions",
  "namespace": "com.amazonaws.personalize.schema",
  "fields": [
    {
      "name": "ACTION_ID",
      "type": "string"
    },
    {
      "name": "VALUE",
      "type": [
        "null",
        "long"
      ]
    },
    
    {
      "name": "MEMBERSHIP_LEVEL",
      "type": [
        "null",
        "string"
      ],
      "categorical": true
    },
    
    {
      "name": "CREATION_TIMESTAMP",
      "type": "long"
    },
    {
      "name": "REPEAT_FREQUENCY",
      "type": [
        "long",
        "null"
      ]
    }
  ],
  "version": "1.0"
}
```

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

```
ACTION_ID,VALUE,MEMBERSHIP_LEVEL,CREATION_TIMESTAMP,REPEAT_FREQUENCY
1,10,Deluxe|Premium,1510003267,7
2,5,Basic,1580003267,7
3,5,Preview,1590003267,3
4,10,Deluxe|Platinum,1560003267,4
...
...
```