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

# カスタムデータセットとスキーマ
<a name="custom-datasets-and-schemas"></a>

カスタムデータセットグループを作成する場合、独自のスキーマを最初から作成します。カスタムデータセットグループのデータセットとスキーマでは、必須フィールドは少ないですが、高い柔軟性があります。以下のトピックでは、カスタムデータセットグループのデータセットのスキーマとデータ要件について説明します。各データセットのセクションでは、データセットタイプに必要なデータが一覧表示され、スキーマの JSON の例が提供されます。

Amazon Personalize が使用できるデータの種類については、「[Amazon Personalize が使用できるデータの種類](datasets.md)」を参照してください。フォーマット要件や使用可能なフィールドデータ型など、Amazon Personalize スキーマの一般的な要件については、「[Amazon Personalize スキーマのスキーマ JSON ファイルの作成](how-it-works-dataset-schema.md)」を参照してください。これらの要件はすべての Amazon Personalize スキーマに適用されます。

**Topics**
+ [カスタムデータセットとスキーマの要件](#dataset-requirements)
+ [アイテムインタラクションデータセットスキーマの要件 (カスタム)](interactions-dataset-requirements.md)
+ [Users データセットスキーマの要件 (カスタム)](user-dataset-requirements.md)
+ [Items データセットスキーマの要件 (カスタム)](item-dataset-requirements.md)
+ [Actions データセットスキーマの要件 (カスタム)](action-dataset-requirements.md)
+ [Action インタラクションデータセットのスキーマ要件 (カスタム)](action-interactions-dataset-requirements.md)

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

カスタムデータセットグループのデータセットを作成する場合、各データセットタイプには、次の必須フィールドと、必須データタイプの予約済みキーワードがあります。


| データセットタイプ | 必須フィールド | 予約済みキーワード | 
| --- | --- | --- | 
| アイテムインタラクション ([スキーマの例](interactions-dataset-requirements.md#schema-examples-interactions)) | USER\_ID (`string`)<br />ITEM\_ID (`string`)<br />TIMESTAMP (`long`) | EVENT\_TYPE (`string`)<br />EVENT\_VALUE (`float`、`null`)<br />IMPRESSION (`string`、`null`)<br />RECOMMENDATION\_ID (`string`、`null`)<br />EVENT\_ATTRIBUTION\_SOURCE (`string`、`null`) | 
| ユーザー ([スキーマの例](user-dataset-requirements.md#schema-examples-users)) | USER\_ID (`string`)<br />1 つのメタデータフィールド (カテゴリ別 `string` または数値) |  | 
| アイテム ([スキーマの例](item-dataset-requirements.md#schema-examples-items)) | ITEM\_ID (`string`)<br />1 つのメタデータフィールド (カテゴリまたはテキスト `string` フィールドまたは数値フィールド) | CREATION\_TIMESTAMP (`long`) | 
| Actions ([スキーマの例](action-dataset-requirements.md#schema-examples-actions)) | ACTION\_ID (`string`)<br />1 つのメタデータフィールド (カテゴリ別 `string` または数値) | CREATION\_TIMESTAMP (`long`)<br />VALUE (`long`、`null`)<br />TYPE (`string`、`null`)<br />EXPIRATION\_TIMESTAMP (`long`、`null`)<br />REPEAT\_FREQUENCY (`long`、`null`) | 
| Action interactions ([スキーマの例](action-interactions-dataset-requirements.md#schema-examples-action-interactions)) | USER\_ID (`string`)<br />ACTION\_ID (`string`)<br />EVENT\_TYPE (`string`)<br />TIMESTAMP (`long`) | IMPRESSION (`string`、`null`)<br />RECOMMENDATION\_ID (`string`、`null`) | 

### メタデータフィールド
<a name="metadata-fields"></a>

メタデータには、必須ではない、または予約済みのキーワードを使用しない文字列または非文字列のフィールドが含まれます。メタデータスキーマには、次の制限があります。
+ ユーザー、アイテム、アクションのスキーマには、少なくとも 1 つのメタデータフィールドが必要です。
+ Users スキーマには最大 25 のメタデータフィールドを追加でき、Items スキーマには最大 100 のメタデータフィールドを追加でき、Actions スキーマには最大 10 のメタデータフィールドを追加できます。
+ タイプ `string` の独自のメタデータフィールドを追加する場合は、`categorical` 属性または `textual` 属性を含める必要があります (アイテムスキーマのみがテキスト属性のフィールドをサポートします)。それ以外の場合、Amazon Personalize は、モデルのトレーニング時にフィールドを使用しません。

### 予約済みキーワード
<a name="reserved-keywords"></a>

予約済みのキーワードはオプションの非メタデータフィールドです。これらのフィールドは、使用時に必須のデータ型としてフィールドを定義する必要があり、キーワードをデータに含める値として使用することができないため、予約済みとみなされます。予約済みカテゴリ文字列フィールドは `categorical` が `true` に設定されている必要がありますが、予約済み文字列フィールドはカテゴリに設定できません。予約済みキーワードは次のとおりです。
+ EVENT\_TYPE: *クリック*と*ダウンロード*の両方など、1 つ以上のイベントタイプを持つアイテムインタラクションデータセットについては、`EVENT_TYPE` フィールドを使用します。EVENT\_TYPE フィールドを `string` として定義する必要があり、カテゴリとして設定することはできません。
+ EVENT\_VALUE: ユーザーが視聴した動画の割合など、イベントの値データを含むアイテムインタラクションデータセットについては、タイプ `float` とオプションで `null` を持つ `EVENT_VALUE` フィールドを使用します。
+  CREATION\_TIMESTAMP: 各アイテムの作成日のタイムスタンプを持つ Items または Actions データセットについては、タイプ `long` の `CREATION_TIMESTAMP` フィールドを使用します。Amazon Personalize は、`CREATION_TIMESTAMP` データを使用してアイテムが存在するようになってからの期間を計算し、それに応じてレコメンデーションを調整します。「[作成のタイムスタンプデータ](items-datasets.md#creation-timestamp-data)」を参照してください。
+  IMPRESSION: 明示的なインプレッションデータを持つアイテムインタラクションデータセットについては、タイプ `String` およびオプションでタイプ `null` の `IMPRESSION` フィールドを使用します。インプレッションは、ユーザーが特定のアイテムを操作した (例えば、クリックや視聴した) ときに表示されたアイテムのリストです。詳細については、「[インプレッションデータ](interactions-datasets.md#interactions-impressions-data)」を参照してください。
+  RECOMMENDATION\_ID: 以前のレコメンデーションを暗黙的なインプレッションデータとして使用するアイテムインタラクションデータセットについては、タイプ `String` およびオプションでタイプ `null` の `RECOMMENDATION_ID` フィールドを使用します。

  レコメンデーションを生成するときに暗黙的なインプレッションを使用するために、Amazon Personalize の `RECOMMENDATION_ID` フィールドを追加する必要はありません。それなしで [PutEvents](API_UBS_PutEvents.md) 操作で `recommendationId` を渡すことができます。詳細については、「[インプレッションデータ](interactions-datasets.md#interactions-impressions-data)」を参照してください。
+ VALUE: Actions データセットで、アクションの一部または全部に値がある場合には、スキーマに `VALUE` フィールドを追加します。そのタイプについては、`long` とオプションでタイプ `null` を使用します。アクションとそれらの値の詳細については、「[[Value data] (値のデータ)](actions-datasets.md#action-value-data)」を参照してください。
+ ACTION\_EXPIRATION\_TIMESTAMP: Actions データセットで、アクションの一部または全部に有効期限のタイムスタンプがある場合は、スキーマに `ACTION_EXPIRATION_TIMESTAMP` フィールドを追加します。そのタイプについては、`long` とオプションでタイプ `null` を使用します。有効期限タイムスタンプの詳細については、「[アクション有効期限のタイムスタンプデータ](actions-datasets.md#action-expiration-timestamp-data)」を参照してください。
+ REPEAT\_FREQUENCY: Actions データセットで、アクションの一部または全部に頻度データがある場合には、スキーマに `REPEAT_FREQUENCY` フィールドを追加します。そのタイプについては、`long` とオプションでタイプ `null` を使用します。繰り返し頻度データの詳細については、「[繰り返し頻度データ](actions-datasets.md#action-repeat-frequency)」を参照してください。