翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Users データセットスキーマの要件 (カスタム)
<a name="user-dataset-requirements"></a>

 *Users データセット*には、ユーザーに関するメタデータが保存されます。これには、各アイテムの年齢、性別、ロイヤルティメンバーシップなどの情報が含まれる場合があります。Amazon Personalize がインポートできるデータの種類については、「[ユーザーメタデータ](users-datasets.md)」を参照してください。

 各ユーザーに提供するデータは、スキーマと一致する必要があります。少なくとも、各ユーザーについてユーザー ID を指定する必要があります (最大長 256 文字)。スキーマによっては、ユーザーメタデータに空/null 値を含めることができます。ユーザースキーマには少なくとも 1 つのメタデータフィールドが必要ですが、`null` タイプを追加すると、ユーザーのこの値は null になる可能性があります。ユースケースとデータに応じて、さらにフィールドを追加することができます。フィールドが必須または予約済みとして記載されておらず、データ型が [スキーマのデータ型](how-it-works-dataset-schema.md#personalize-datatypes) に記載されている限り、フィールド名とデータ型は自由に設定できます。

 カテゴリデータを使用するには、タイプ `string` のフィールドを追加し、スキーマでフィールドのカテゴリ属性を `true` に設定します。その後、カテゴリデータをバルク CSV ファイルと個別レコードインポートに含めます。複数のカテゴリを持つユーザーについては、バーティカルバー「\|」を使用して各値を区切ります。例えば、SUBSCRIPTION\_MODEL フィールドについて、ユーザーのデータは student\|monthly\|discount である場合があります。

カテゴリ値には、最大 1,000 文字を使用できます。1,000 文字を超えるカテゴリ値を持つユーザーがいる場合、データセットのインポートジョブは失敗します。

Users データセットの最小要件と最大データ制限の詳細については、「[サービスクォータ](limits.md#limits-table)」を参照してください。

## ユーザースキーマの例 (カスタム)
<a name="schema-examples-users"></a>

次の例は、ユーザースキーマを構築する方法を示しています。`USER_ID` フィールドは必須であり、`AGE` および `GENDER` フィールドはメタデータです。少なくとも 1 つのメタデータフィールドが必要であり、最大 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
...
...
```