Mengimpor barang secara individual

Setelah selesai Membuat dataset dan skema membuat kumpulan data Item, Anda dapat mengimpor satu atau beberapa item baru ke dalam kumpulan data secara individual. Mengimpor item secara individual memungkinkan Anda untuk menjaga dataset Item tetap terkini dengan impor batch kecil seiring pertumbuhan katalog Anda. Anda dapat mengimpor hingga 10 item sekaligus. Jika Anda memiliki sejumlah besar item baru, kami sarankan Anda terlebih dahulu mengimpor data secara massal dan kemudian mengimpor data item satu per satu sesuai kebutuhan. Lihat Mengimpor data langsung ke Amazon Personalize dataset.

Anda dapat menggunakan konsol Amazon Personalize, AWS Command Line Interface (AWS CLI), atau AWS SDK untuk mengimpor item. Jika Anda mengimpor item yang itemId sama dengan item yang sudah ada di kumpulan data Item, Amazon Personalize menggantinya dengan item baru.

Untuk informasi tentang cara Amazon Personalisasi pembaruan memfilter untuk catatan baru dan bagaimana catatan baru memengaruhi rekomendasi, lihat. Mengimpor catatan individu

Mengimpor item satu per satu (konsol)

Anda dapat mengimpor hingga 10 item ke kumpulan data Item sekaligus. Prosedur ini mengasumsikan bahwa Anda telah membuat dataset Item. Untuk informasi tentang membuat kumpulan data, lihat. Membuat dataset dan skema

Untuk mengimpor item satu per satu (konsol)

1. Buka konsol Amazon Personalize di https://console.aws.amazon.com/personalize/home dan masuk ke akun Anda.

2. Di halaman grup Dataset, pilih grup kumpulan data dengan kumpulan data Item yang ingin Anda impor itemnya.

3. Di panel navigasi, pilih Datasets.

4. Pada halaman Datasets, pilih dataset Item.

5. Di kanan atas halaman detail kumpulan data, pilih Ubah kumpulan data, lalu pilih Buat catatan.

6. Di Buat catatan item halaman, untuk Rekam input, masukkan detail item dalam format JSON. Nama dan nilai bidang item harus cocok dengan skema yang Anda gunakan saat membuat kumpulan data Item. Amazon Personalize menyediakan template JSON dengan nama bidang dan tipe data dari skema ini.

7. Pilih Buat catatan. Sebagai Respons, hasil impor terdaftar dan pesan sukses atau gagal ditampilkan.

Mengimpor item secara individual () AWS CLI

Tambahkan satu atau beberapa item ke set data Item Anda menggunakan PutItems operasi. Anda dapat mengimpor hingga 10 item dengan satu PutItems panggilan. Bagian ini mengasumsikan bahwa Anda telah membuat dataset Item. Untuk informasi tentang membuat kumpulan data, lihat. Membuat dataset dan skema

Gunakan put-items perintah berikut untuk menambahkan satu atau lebih item dengan AWS CLI. Ganti dataset arn dengan Nama Sumber Daya Amazon (ARN) dari kumpulan data Anda dan item Id dengan ID item. Jika item dengan item yang sama sudah itemId ada di kumpulan data Item Anda, Amazon Personalize menggantinya dengan yang baru.

Untukproperties, untuk setiap bidang dalam kumpulan data Item Anda, ganti propertyName dengan nama bidang dari skema Anda dalam kasus unta. Misalnya, GENRES akan menjadi genres dan CREATION_TIMESTAMP akan menjadi CreationTimeStamp. Ganti item data dengan data untuk item tersebut. CREATION_TIMESTAMPdata harus dalam format waktu epoch Unix dan dalam hitungan detik. Untuk data string kategoris, untuk menyertakan beberapa kategori untuk satu properti, pisahkan setiap kategori dengan pipe ()|. Sebagai contoh, \"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\"}" 
    }]'

Mengimpor item secara individual (AWS SDK)

Tambahkan satu atau beberapa item ke set data Item Anda menggunakan PutItems operasi. Anda dapat mengimpor hingga 10 item dengan satu PutItems panggilan. Jika item dengan item yang sama sudah itemId ada di kumpulan data Item Anda, Amazon Personalize menggantinya dengan yang baru. Bagian ini mengasumsikan bahwa Anda telah membuat dataset Item. Untuk informasi tentang membuat kumpulan data, lihat. Membuat dataset dan skema

Kode berikut menunjukkan cara menambahkan satu atau beberapa item ke kumpulan data Item Anda. Untuk setiap parameter nama properti, berikan nama bidang dari skema Anda dalam kasus unta. Misalnya, GENRES akan menjadi genres dan CREATION_TIMESTAMP akan menjadi. creationTimestamp Untuk setiap parameter nilai properti, berikan data untuk item tersebut. CREATION_TIMESTAMPdata harus dalam format waktu epoch Unix dan dalam hitungan detik.

Untuk data string kategoris, untuk menyertakan beberapa kategori untuk satu properti, pisahkan setiap kategori dengan pipe ()|. Sebagai contoh, "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();