物品交互数据集架构要求（自定义） - Amazon Personalize
交互架构示例（自定义）
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

物品交互数据集架构要求（自定义）

物品交互数据集存储来自用户和目录物品之间交互的历史数据和实时数据。有关 Amazon Personalize 可以使用的交互数据类型的信息，请参阅物品交互数据集。

您为每次交互提供的数据必须与您的架构相匹配。根据您的架构，交互元数据可能包含空值。您必须为每次交互至少提供以下内容：

  • 用户 ID

  • 物品 ID

  • 时间戳（采用 Unix 纪元时间格式）

您可以根据您的使用案例和数据自由添加其他字段。只要字段未列为必填字段或保留字段，并且数据类型列在架构数据类型中，则字段名称和数据类型由您决定。

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

有关物品交互数据集的最低要求和最大数据限制的更多信息，请参阅服务限额。

交互架构示例（自定义）

以下示例显示了物品交互数据集的架构。USER_ID、ITEM_ID 和 TIMESTAMP 为必需字段。EVENT_TYPE、EVENT_VALUE 和 IMPRESSION 字段是 Amazon Personalize 可识别的可选保留关键字。EVENT_TYPE 必须是字符串类型，不能是分类类型。LOCATION 和 DEVICE 是可选的上下文元数据字段。有关架构要求的信息，请参阅自定义数据集和架构要求。

{

  "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_VALUE 的某些值为空。

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
...
...