Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Importer des articles individuellement

Une fois que vous Création d'un schéma et d'un jeu de données avez créé un jeu de données d'éléments, vous pouvez importer individuellement un ou plusieurs nouveaux éléments dans le jeu de données. L'importation individuelle d'articles vous permet de maintenir votre jeu de données d'articles à jour grâce à des importations par petits lots à mesure que votre catalogue s'agrandit. Vous pouvez importer jusqu'à 10 articles à la fois. Si vous avez un grand nombre de nouveaux articles, nous vous recommandons d'importer d'abord les données en bloc, puis d'importer les données des articles individuellement si nécessaire. Consultez Importation de données en masse dans Amazon Personalize à l'aide d'une tâche d'importation de jeux de données.

Vous pouvez utiliser la console Amazon Personalize, AWS Command Line Interface (AWS CLI), ou AWS SDKspour importer des articles. Si vous importez un article itemId identique à un article figurant déjà dans votre ensemble de données d'articles, Amazon Personalize le remplace par le nouvel article.

Pour plus d'informations sur la manière dont Amazon Personalize met à jour les filtres pour les nouveaux enregistrements et sur la manière dont les nouveaux enregistrements influencent les recommandations, consultezImportation d'enregistrements individuels dans un ensemble de données Amazon Personalize.

Importer des éléments individuellement (console)

Vous pouvez importer jusqu'à 10 éléments à la fois dans un jeu de données d'articles. Cette procédure suppose que vous avez déjà créé un jeu de données Items. Pour plus d'informations sur la création de jeux de données, consultezCréation d'un schéma et d'un jeu de données.

Importation d'articles individuellement (AWS CLI)

Ajoutez un ou plusieurs éléments à votre jeu de données Items à l'aide de PutItems cette opération. Vous pouvez importer jusqu'à 10 articles en un seul PutItems appel. Cette section part du principe que vous avez déjà créé un jeu de données Items. Pour plus d'informations sur la création de jeux de données, consultezCréation d'un schéma et d'un jeu de données.

Utilisez la put-items commande suivante pour ajouter un ou plusieurs éléments avec AWS CLI. dataset arnRemplacez-le par le nom de ressource Amazon (ARN) de votre ensemble de données et item Id par l'ID de l'élément. Si un article identique itemId figure déjà dans votre ensemble de données Articles, Amazon Personalize le remplace par le nouveau.

En effetproperties, pour chaque champ de votre jeu de données Items, remplacez le propertyName par le nom du champ indiqué dans votre schéma en cas de chameau. Par exemple, GENRES serait genres et CREATION _ TIMESTAMP seraitcreationTimestamp. Remplacez item data par les données de l'article. CREATION_TIMESTAMPles données doivent être au format Epoch Time Unix et exprimées en secondes. Pour les données de chaîne catégorielles, afin d'inclure plusieurs catégories pour une seule propriété, séparez chaque catégorie par un tube (|). Par exemple, \"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\"}" 
    }]'

Importation d'articles individuellement (AWS SDKs)

Ajoutez un ou plusieurs éléments à votre jeu de données Items à l'aide de PutItems cette opération. Vous pouvez importer jusqu'à 10 articles en un seul PutItems appel. Si un article identique itemId figure déjà dans votre ensemble de données Articles, Amazon Personalize le remplace par le nouveau. Cette section part du principe que vous avez déjà créé un jeu de données Items. Pour plus d'informations sur la création de jeux de données, consultezCréation d'un schéma et d'un jeu de données.

Le code suivant montre comment ajouter un ou plusieurs éléments à votre jeu de données Items. Pour chaque paramètre de nom de propriété, transmettez le nom du champ de votre schéma en cas de chameau. Par exemple, GENRES serait genres et CREATION _ TIMESTAMP seraitcreationTimestamp. Pour chaque paramètre de valeur de propriété, transmettez les données de l'élément. CREATION_TIMESTAMPles données doivent être au format Epoch Time Unix et exprimées en secondes.

Pour les données de chaîne catégorielles, afin d'inclure plusieurs catégories pour une seule propriété, séparez chaque catégorie par un tube (|). Par exemple, "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();