本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 物品交互数据集架构要求（自定义）
<a name="interactions-dataset-requirements"></a>

*物品交互数据集*存储来自用户和目录物品之间交互的历史数据和实时数据。有关 Amazon Personalize 可以使用的交互数据类型的信息，请参阅[物品交互数据](interactions-datasets.md)。

 您为每次交互提供的数据必须与您的架构相匹配。根据您的架构，交互元数据可能包含空值。您必须为每次交互至少提供以下内容：
+ 用户 ID
+ 物品 ID
+ 时间戳（采用 Unix 纪元时间格式）

您可以根据您的使用案例和数据自由添加其他字段。只要字段未列为必填字段或保留字段，并且数据类型列在[架构数据类型](how-it-works-dataset-schema.md#personalize-datatypes)中，则字段名称和数据类型由您决定。

 您可以添加到物品交互数据集的最大可选元数据字段总数，再加上物品交互数据中*不同*事件类型的总数，结果为 10。此计数中包含的元数据字段是 EVENT\$1TYPE、EVENT\$1VALUE 字段以及您添加到架构中的任何自定义元数据字段。不包括保留字段（例如 IMPRESSION）的元数据字段的最大数量为 5。分类值最多可以有 1000 个字符。如果交互的分类值大于 1000，则您的数据集导入作业将失败。

有关物品交互数据集的最低要求和最大数据限制的更多信息，请参阅[服务配额](limits.md#limits-table)。

## 交互架构示例（自定义）
<a name="schema-examples-interactions"></a>

以下示例显示了物品交互数据集的架构。`USER_ID`、`ITEM_ID` 和 `TIMESTAMP` 为必需字段。`EVENT_TYPE`、`EVENT_VALUE` 和 `IMPRESSION` 字段是 Amazon Personalize 可识别的可选保留关键字。EVENT\$1TYPE 必须是字符串类型，不能是分类类型。`LOCATION` 和 `DEVICE` 是可选的上下文元数据字段。有关架构要求的信息，请参阅[自定义数据集和架构要求](custom-datasets-and-schemas.md#dataset-requirements)。

```
{

  "type": "record",
  "name": "Interactions",
  "namespace": "com.amazonaws.personalize.schema",
  "fields": [
      {
          "name": "USER_ID",
          "type": "string"
      },
      {
          "name": "ITEM_ID",
          "type": "string"
      },
      {
          "name": "EVENT_TYPE",
          "type": "string"
      },
      {
          "name": "EVENT_VALUE",
          "type": [
             "float",
             "null"
          ]
      },
      {
          "name": "LOCATION",
          "type": "string",
          "categorical": true
      },
      {
          "name": "DEVICE",
          "type": [
              "string",
              "null"
          ],
          "categorical": true
      },
      {
          "name": "TIMESTAMP",
          "type": "long"
      },
      {
          "name": "IMPRESSION",
          "type": "string"
      }
  ],
  "version": "1.0"
}
```

对于此架构，CSV 文件中的前几行历史数据可能如下所示。请注意，EVENT\$1VALUE 的某些值为空。

```
USER_ID,ITEM_ID,EVENT_TYPE,EVENT_VALUE,LOCATION,DEVICE,TIMESTAMP,IMPRESSION
35,73,click,,Ohio,Tablet,1586731606,73|70|17|95|96|92|55|45|16|97|56|54|33|94|36|10|5|43|19|13|51|90|65|59|38
54,35,watch,0.75,Indiana,Cellphone,1586735164,35|82|78|57|20|63|1|90|76|75|49|71|26|24|25|6|37|85|40|98|32|13|11|54|48
9,33,click,,Oregon,Cellphone,1586735158,68|33|62|6|15|57|45|24|78|89|90|40|26|91|66|31|47|17|99|29|27|41|77|75|14
23,10,watch,0.25,California,Tablet,1586735697,92|89|36|10|39|77|4|27|79|18|83|16|28|68|78|40|50|3|99|7|87|49|12|57|53
27,11,watch,0.55,Indiana,Tablet,1586735763,11|7|39|95|71|1|6|40|41|28|99|53|68|76|0|65|69|36|22|42|34|67|24|20|66
...
...
```