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

# 使用者資料集結構描述要求 （自訂）
<a name="user-dataset-requirements"></a>

 *使用者資料集*會儲存有關使用者的中繼資料。這可能包括每個項目的年齡、性別和忠誠度成員資格等資訊。如需可匯入 Amazon Personalize 的使用者資料類型資訊，請參閱 [使用者中繼資料](users-datasets.md)。

 您為每個使用者提供的資料必須符合您的結構描述。您必須為每個使用者提供使用者 ID （長度上限為 256 個字元）。根據您的結構描述，使用者中繼資料可以包含空值/空值。您的使用者結構描述必須至少有一個中繼資料欄位，但如果您新增了`null`類型，則該使用者的值可為 null。您可以根據您的使用案例和資料，自由新增其他欄位。只要欄位未列為必要或預留，且資料類型列於 中[結構描述資料類型](how-it-works-dataset-schema.md#personalize-datatypes)，欄位名稱和資料類型將由您決定。

 若要使用分類資料，請在結構描述`true`中新增 類型的欄位，`string`並將欄位的分類屬性設定為 。然後在大量 CSV 檔案和個別記錄匯入中包含分類資料。對於具有多個類別的使用者，請使用垂直列 '\$1' 分隔每個值。例如，對於 SUBSCRIPTION\$1MODEL 欄位，您的使用者資料可能是 student\$1monthly\$1discount。

分類值最多可有 1000 個字元。如果您有分類值超過 1000 個字元的使用者，您的資料集匯入任務將會失敗。

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

## 使用者結構描述範例 （自訂）
<a name="schema-examples-users"></a>

下列範例示範如何建構使用者結構描述。`USER_ID` 欄位為必要欄位，而 `AGE`和 `GENDER` 欄位為中繼資料。至少需要一個中繼資料欄位，而且您最多可以新增 25 個中繼資料欄位。如需結構描述需求的資訊，請參閱 [自訂資料集和結構描述需求](custom-datasets-and-schemas.md#dataset-requirements)。

```
{
  "type": "record",
  "name": "Users",
  "namespace": "com.amazonaws.personalize.schema",
  "fields": [
      {
          "name": "USER_ID",
          "type": "string"
      },
      {
          "name": "AGE",
          "type": "int"
      },
      {
          "name": "GENDER",
          "type": "string",
          "categorical": true
      }
  ],
  "version": "1.0"
}
```

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

```
USER_ID,AGE,GENDER
5,34,Male
6,56,Female
8,65,Male
...
...
```