データセットとスキーマ

Amazon Personalize のデータセットは、データのコンテナです。データセットには次の 3 つのタイプがあります。

• Users – このデータセットには、ユーザーに関するメタデータが保存されます。これには、年齢、性別、ロイヤリティメンバーシップなど、パーソナライゼーションシステムで重要なシグナルとなり得る情報が含まれます。

• Items – このデータセットは、アイテムに関するメタデータを保存します。これには、価格、SKU タイプ、在庫状況などの情報が含まれます。

• Interactions – このデータセットは、ユーザーとアイテム間のインタラクションからの履歴データとリアルタイムデータを保存します。Amazon Personalize では、インタラクションは、記録してからトレーニングデータとしてインポートするイベントです。ドメインデータセットグループとカスタムデータセットグループの両方については、少なくとも Interactions データセットを作成する必要があります。

すべてのユースケース（ドメインデータセットグループ）とレシピ（カスタムデータセットグループ）について、インタラクションデータには次のものが必要です。

• カタログ内のアイテムを操作するユーザーからの最低1000件のインタラクションレコード。これらのインタラクションは、一括インポート、ストリーミングイベント、あるいはその両方からのものである可能性があります。

• 少なくともそれぞれ 2 つのインタラクションを持つ 25 以上の一意のユーザー ID

ドメインデータセットグループとカスタムデータセットグループは、各タイプのデータセットを 1 つだけ持つことができます。データセットを作成する前に、そのデータセットのスキーマを定義します。スキーマは、Amazon Personalize にデータの構造を知らせ、Amazon Personalize がデータを解析できるようにします。スキーマには名前キーがあり、その値はデータセットタイプと一致する必要があります。スキーマを作成した後は、スキーマに変更を加えることはできなくなります。

ドメインデータセットグループについては、各データセットタイプには、必須フィールドと予約済みキーワードを含むデフォルトのスキーマがあります。データセットを作成するたびに、既存のドメインスキーマを使用するか、既存のデフォルトスキーマを変更して新しいドメインスキーマを作成できます。ドメインにインポートするデータのガイドとして、デフォルトのスキーマを使用します。スキーマを定義してデータセットを作成すると、スキーマに変更を加えることはできなくなります。

データを一括インポートする場合、データはカンマ区切り値 (CSV) 形式で保存する必要があります。CSV ファイルの最初の行には、スキーマと一致する列ヘッダーが含まれている必要があります。

トピック

• スキーマ形式の要件
• ドメインデータセットとスキーマ
• カスタムデータセットとスキーマ

スキーマ形式の要件

ドメインデータセットグループまたはカスタムデータセットグループのいずれかのデータセットのスキーマを作成するときは、次のガイドラインに従う必要があります。

• スキーマは Avro 形式で定義する必要があります。サポートされている Avro データ型については、「スキーマのデータ型」を参照してください。

• スキーマフィールドは任意の順序で表示できますが、CSV ファイル内の対応する列ヘッダーの順序と一致する必要があります。

• 必須フィールドを必須データ型として定義する必要があります。categorical予約済みカテゴリ文字列フィールドはに設定されている必要がありますがtrue、予約済み文字列フィールドはカテゴリに設定できません。キーワードをデータに含めることはできません。ドメインデータセットグループのデータセットには、ドメインとデータセットタイプの両方に基づく追加要件があります。カスタムデータセットグループのデータセットには、タイプに応じて異なる要件があります。

• スキーマは、ネストされた構造のないフラットな JSON ファイルである必要があります。例えば、フィールドを複数のサブフィールドの親にすることはできません。

• スキーマフィールドには一意の英数字名が必要です。例えば、GENRES_FIELD_1 フィールドと GENRESFIELD1 フィールドの両方を追加することはできません。

• Amazon Personalize のスキーマは、配列やマップなどの複雑なタイプをサポートしていません。

• カテゴリメタデータやインプレッションデータなど、複数の値を持つフィールドについては、データ型の文字列を使用し、バーティカルバー (「|」) の文字を使用して各値を区切ります。カテゴリフィールドの場合は、を追加します"categorical": true。

スキーマのデータ型

Amazon Personalize のスキーマは、フィールド向けに次の Avro タイプをサポートします。

• フロート

• double

• int

• long

• string

• ブール値 (値 true および false は、データでは小文字である必要があります)

• null

一部の必須フィールドと予約フィールドは NULL データをサポートしています。フィールドにnullタイプを追加すると、不完全なデータ (例えば、空白の値を持つメタデータ) を使用して、レコメンデーションを生成できます。NULL データをサポートするフィールドについては、ドメインデータセットとスキーマまたはを参照してくださいカスタムデータセットとスキーマ。次の例は、GENDER フィールドに null タイプを追加する方法を示しています。

{
  "name": "GENDER",
  "type": [
    "null",
    "string"
  ],
  "categorical": true
}