单独导入物品 - Amazon Personalize
单独导入物品（控制台）单独导入项目 (AWS CLI)单独导入项目 (AWS SDKs)

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

单独导入物品

完成创建架构和数据集以创建物品数据集后，您可以单独将一个或多个新物品导入数据集。单独导入物品允许您随着目录的增长而进行小批量导入，从而使您的物品数据集保持最新状态。您一次最多可以导入 10 个物品。如果您有大量新物品，我们建议您先批量导入数据，然后根据需要单独导入物品数据。请参阅 使用数据集导入任务将批量数据导入 Amazon Personalize。

你可以使用 Amazon Personalize 控制台， AWS Command Line Interface (AWS CLI)，或 AWS SDKs导入物品。如果您导入的物品的 itemId 与您物品数据集中已有的物品 ID 相同，则 Amazon Personalize 会将其替换为新物品。

有关 Amazon Personalize 如何更新新记录筛选器以及新记录如何影响建议的信息，请参阅将个人记录导入 Amazon Personalize 数据集。

单独导入物品（控制台）

您一次最多可以向物品数据集导入 10 个物品。此过程假定您已经创建了一个物品数据集。有关创建数据集的信息，请参阅创建架构和数据集。

单独导入物品（控制台）

  1. 在https://console.aws.amazon.com/personalize/家中打开 Amazon Personalize 控制台并登录您的账户。

  2. 在数据集组页面上，选择包含要将物品导入到的物品数据集的数据集组。

  3. 在导航窗格中，选择数据集。

  4. 在数据集页面上，选择物品数据集。

  5. 在数据集详细信息页面的右上角，选择修改数据集，然后选择创建记录。

  6. 在 “创建项目记录” 页面中，在 “记录输入” 中，按JSON格式输入项目详细信息。物品的字段名称和值必须与您在创建物品数据集时使用的架构匹配。Amazon Person JSON alize 提供了一个包含该架构中的字段名称和数据类型的模板。

  7. 选择创建记录。在响应中，将列出导入结果并显示成功或失败消息。

单独导入项目 (AWS CLI)

使用 PutItems 操作将一个或多个物品添加到您的物品数据集。通过单次 PutItems 调用最多可以导入 10 个物品。此部分假定您已经创建了一个物品数据集。有关创建数据集的信息，请参阅创建架构和数据集。

使用以下put-items命令添加一个或多个项目 AWS CLI。 dataset arn替换为数据集的 Amazon 资源名称 (ARN) 和item Id项目的 ID。如果具有相同 itemId 的物品已存在于物品数据集中，则 Amazon Personalize 会将其替换为新物品。

对于 properties，针对物品数据集中的每个字段，将 propertyName 替换为架构中的字段名称（采用混合大小写）。例如，GENRES将是genres，CREATION_ TIMESTAMP 将是creationTimestamp。将 item data 替换为物品的数据。CREATION_TIMESTAMP 数据必须采用 Unix 纪元时间格式（以秒为单位）。对于分类字符串数据，要包含单个属性的多个类别，请使用竖线 (|) 分隔每个类别。例如 \"Horror|Action\"。

aws personalize-events put-items \
  --dataset-arn dataset arn \
  --items '[{
      "itemId": "item Id", 
      "properties": "{\"propertyName\": "\item data\"}" 
    }, 
    {
      "itemId": "item Id", 
      "properties": "{\"propertyName\": "\item data\"}" 
    }]'

单独导入项目 (AWS SDKs)

使用 PutItems 操作将一个或多个物品添加到您的物品数据集。通过单次 PutItems 调用最多可以导入 10 个物品。如果具有相同 itemId 的物品已存在于物品数据集中，则 Amazon Personalize 会将其替换为新物品。此部分假定您已经创建了一个物品数据集。有关创建数据集的信息，请参阅创建架构和数据集。

以下代码显示如何将一个或多个物品添加到物品数据集。对于每个属性名称参数，传递架构中的字段名称（采用混合大小写）。例如，GENRES将是genres，CREATION_ TIMESTAMP 将是creationTimestamp。对于每个属性值参数，传递物品的数据。CREATION_TIMESTAMP 数据必须采用 Unix 纪元时间格式（以秒为单位）。

对于分类字符串数据，要包含单个属性的多个类别，请使用竖线 (|) 分隔每个类别。例如 "Horror|Action"。

SDK for Python (Boto3)
import boto3

personalize_events = boto3.client(service_name='personalize-events')

personalize_events.put_items(
    datasetArn = 'dataset arn',
    items = [{
      'itemId': 'item ID',
      'properties': "{\"propertyName\": \"item data\"}"   
      },
      {
      'itemId': 'item ID',
      'properties': "{\"propertyName\": \"item data\"}"   
      }]
)
SDK for Java 2.x
public static int putItems(PersonalizeEventsClient personalizeEventsClient,
                           String datasetArn,
                           String item1Id,
                           String item1PropertyName,
                           String item1PropertyValue,
                           String item2Id,
                           String item2PropertyName,
                           String item2PropertyValue) {

    int responseCode = 0;
    ArrayList<Item> items = new ArrayList<>();

    try {
        Item item1 = Item.builder()
                .itemId(item1Id)
                .properties(String.format("{\"%1$s\": \"%2$s\"}",
                        item1PropertyName, item1PropertyValue))
                .build();

        items.add(item1);

        Item item2 = Item.builder()
                .itemId(item2Id)
                .properties(String.format("{\"%1$s\": \"%2$s\"}",
                        item2PropertyName, item2PropertyValue))
                .build();

        items.add(item2);

        PutItemsRequest putItemsRequest = PutItemsRequest.builder()
                .datasetArn(datasetArn)
                .items(items)
                .build();

        responseCode = personalizeEventsClient.putItems(putItemsRequest).sdkHttpResponse().statusCode();
        System.out.println("Response code: " + responseCode);
        return responseCode;

    } catch (PersonalizeEventsException e) {
        System.out.println(e.awsErrorDetails().errorMessage());
    }
    return responseCode;
    }
SDK for JavaScript v3
import {
  PutItemsCommand,
  PersonalizeEventsClient,
} from "@aws-sdk/client-personalize-events";

const personalizeEventsClient = new PersonalizeEventsClient({
  region: "REGION",
});

// set the put items parameters
var putItemsParam = {
  datasetArn:
    "DATASET ARN",
  items: [
    {
      itemId: "itemId", 
      properties: '{"column1Name": "value", "column2Name": "value"}',
    },
    {
      itemId: "itemId",
      properties: '{"column1Name": "value", "column2Name": "value"}',
    },
  ],
};
export const run = async () => {
  try {
    const response = await personalizeEventsClient.send(
      new PutItemsCommand(putItemsParam)
    );
    console.log("Success!", response);
    return response; // For unit tests.
  } catch (err) {
    console.log("Error", err);
  }
};
run();