Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Importazione di singoli record in un set di dati Amazon Personalize
Al termine[Creazione di uno schema e di un set di dati](data-prep-creating-datasets.md), puoi importare singoli record, tra cui interazioni tra elementi, utenti, elementi, azioni o interazioni tra azioni, in un set di dati esistente. L'importazione individuale dei dati consente di aggiungere piccoli batch di record ai set di dati di Amazon Personalize man mano che il catalogo cresce. Puoi importare fino a 10 record per singola operazione di importazione.
Se importi un elemento, un utente o un'azione con lo stesso ID di un record già presente nel tuo set di dati, Amazon Personalize lo sostituisce con il nuovo record. Se registri due eventi di interazione tra elementi o azioni con esattamente lo stesso timestamp e proprietà identiche, Amazon Personalize conserva solo uno degli eventi.
Se usi Apache Kafka, puoi utilizzare il connettore *Kafka per Amazon Personalize per trasmettere dati in tempo reale ad Amazon Personalize*. Per informazioni, consulta [Kafka Connector per Amazon Personalize](https://github.com/aws/personalize-kafka-connector/blob/main/README.md) nel *personalize-kafka-connector*repository Github.
Se disponi di una grande quantità di documenti storici, ti consigliamo di importare prima i dati in blocco e poi di importarli singolarmente, se necessario. Consultare [Importazione di dati di massa in Amazon Personalize con un processo di importazione di set di dati](bulk-data-import-step.md).
**Filtra gli aggiornamenti per le importazioni di singoli record**
Amazon Personalize aggiorna tutti i filtri creati nel gruppo di set di dati con i nuovi dati di interazione, elemento e utente entro 20 minuti dall'ultima importazione individuale. Questo aggiornamento consente alle tue campagne di utilizzare i dati più recenti per filtrare i consigli per i tuoi utenti.
Se hai già creato un programma di raccomandazione o distribuito una versione della soluzione personalizzata con una campagna, il modo in cui i nuovi record individuali influiscono sui consigli dipende dal caso d'uso del dominio o dalla ricetta che utilizzi. Per ulteriori informazioni, consulta [Aggiornamento dei dati nei set di dati dopo l'allenamento](updating-datasets.md).
**Topics**
+ [Importazione delle interazioni singolarmente](importing-interactions.md)
+ [Importazione di utenti singolarmente](importing-users.md)
+ [Importazione di articoli singolarmente](importing-items.md)
+ [Importazione di azioni singolarmente](importing-actions.md)
# Importazione delle interazioni singolarmente
Dopo aver completato la creazione [Creazione di uno schema e di un set di dati](data-prep-creating-datasets.md) di un set di dati sulle interazioni tra oggetti, puoi importare singolarmente uno o più nuovi eventi nel set di dati. Per importare *[gli eventi](https://docs.aws.amazon.com/glossary/latest/reference/glos-chap.html#event)* di interazione singolarmente, create un *[tracker degli](https://docs.aws.amazon.com/glossary/latest/reference/glos-chap.html#event-tracker)* eventi e quindi importate uno o più eventi nel set di dati sulle interazioni degli oggetti. Puoi importare eventi storici di interazioni individuali utilizzando la console Amazon Personalize o importare eventi storici o in tempo reale utilizzando AWS Command Line Interface (AWS CLI) o il. AWS SDKs
Questa sezione include informazioni sull'importazione di eventi con la console Amazon Personalize. Ti consigliamo di utilizzare la console Amazon Personalize per importare *solo* eventi storici. Per informazioni sull'utilizzo di AWS CLI o AWS SDKs per registrare eventi in tempo reale, consulta[Registrazione di eventi in tempo reale per influenzare le raccomandazioni](recording-events.md).
Per informazioni su come Amazon Personalize aggiorna i filtri per i nuovi record e su come i nuovi record influiscono sui consigli, consulta. [Importazione di singoli record in un set di dati Amazon Personalize](incremental-data-updates.md)
**Topics**
+ [Creazione di un tracker di eventi (console)](#event-tracker-console)
+ [Importazione di eventi singolarmente (console)](#importing-interactions-console)
## Creazione di un tracker di eventi (console)
**Nota**
Se hai creato un tracker di eventi, puoi passare a. [Importazione di eventi singolarmente (console)](#importing-interactions-console)
Prima di poter importare un evento in un set di dati Interactions, devi creare un *[tracker di eventi](https://docs.aws.amazon.com/glossary/latest/reference/glos-chap.html#event-tracker)* per il gruppo di set di dati.
**Per creare un tracker di eventi (console)**
1. Apri la console Amazon Personalize a [https://console.aws.amazon.com/personalize/casa](https://console.aws.amazon.com/personalize/home) e accedi al tuo account.
1. Nella pagina dei **gruppi di set** di dati, scegli il gruppo di set di dati con il set di dati sulle interazioni degli elementi in cui desideri importare gli eventi.
1. **Nella **dashboard** per il gruppo di set di dati, in **Install event ingestion** SDK, scegli Start.**
1. **Nella pagina **Configura tracker**, nelle **configurazioni Tracker, per Tracker** **name, fornisci un nome per il tracker** di eventi e scegli Avanti.**
1. La pagina **Installa l'SDK** mostra l'**ID di tracciamento** per il nuovo tracker di eventi e le istruzioni per l'utilizzo o lo streaming dei dati sugli eventi. AWS Amplify AWS Lambda
Puoi ignorare queste informazioni perché stai utilizzando la console Amazon Personalize per caricare i dati degli eventi. Se desideri trasmettere in streaming i dati degli eventi utilizzando AWS Amplify o AWS Lambda in futuro, puoi visualizzare queste informazioni scegliendo l'event tracker nella pagina **Event tracker**.
1. Scegli **Fine**. Ora puoi importare eventi con la console (vedi) [Importazione di eventi singolarmente (console)](#importing-interactions-console) o registrare eventi in tempo reale usando l'`PutEvents`operazione (vedi). [Registrazione di eventi in tempo reale per influenzare le raccomandazioni](recording-events.md)
## Importazione di eventi singolarmente (console)
Dopo aver creato un tracker di eventi, puoi importare gli eventi singolarmente in un set di dati sulle interazioni degli elementi. Questa procedura presuppone che tu abbia già creato un set di dati sulle interazioni tra oggetti. Per informazioni sulla creazione di set di dati, vedere. [Creazione di uno schema e di un set di dati](data-prep-creating-datasets.md)
**Per importare eventi singolarmente (console)**
1. Apri la console Amazon Personalize a [https://console.aws.amazon.com/personalize/casa](https://console.aws.amazon.com/personalize/home) e accedi al tuo account.
1. Nella pagina dei **gruppi di set** di dati, scegli il gruppo di set di dati con il set di dati sulle interazioni degli elementi in cui desideri importare gli eventi.
1. **Nel riquadro di navigazione, scegli set di dati.**
1. Nella pagina Set di dati, scegli il **set** di dati Interazioni.
1. **Nella parte superiore destra della pagina dei dettagli del set di dati, scegli **Modifica set** di dati e scegli Crea record.**
1. Nella pagina **Crea record di interazione utente-elemento**, per **Registra input**, inserisci i dettagli dell'evento in formato JSON. I nomi e i valori dei campi dell'evento devono corrispondere allo schema utilizzato durante la creazione del set di dati sulle interazioni degli elementi. Amazon Personalize fornisce un modello JSON con nomi di campo e tipi di dati di questo schema. Puoi importare fino a 10 eventi alla volta.
1. Scegli **Crea record**. In **Response**, viene elencato il risultato dell'importazione e viene visualizzato un messaggio di successo o di fallimento.
# Importazione di utenti singolarmente
Dopo aver completato la creazione [Creazione di uno schema e di un set di dati](data-prep-creating-datasets.md) di un set di dati Users, puoi importare singolarmente uno o più nuovi utenti nel set di dati. L'importazione individuale degli utenti consente di mantenere aggiornato il set di dati Users con importazioni in piccoli batch man mano che il catalogo cresce. Puoi importare fino a 10 utenti alla volta. Se hai un gran numero di nuovi utenti, ti consigliamo di importare prima i dati in blocco e poi di importare i dati utente singolarmente, se necessario. Per informazioni, consulta [Importazione di dati di massa in Amazon Personalize con un processo di importazione di set di dati](bulk-data-import-step.md).
Puoi utilizzare la console Amazon Personalize, il AWS Command Line Interface (AWS CLI) o AWS SDKs importare utenti. Se importi un utente con lo `userId` stesso nome di un utente già presente nel set di dati Users, Amazon Personalize sostituisce l'utente con uno nuovo. Puoi importare fino a 10 utenti alla volta.
Per informazioni su come Amazon Personalize aggiorna i filtri per i nuovi record e su come i nuovi record influiscono sui consigli, consulta. [Importazione di singoli record in un set di dati Amazon Personalize](incremental-data-updates.md)
**Topics**
+ [Importazione di utenti singolarmente (console)](#importing-users-console)
+ [Importazione di utenti singolarmente ()AWS CLI](#importing-users-cli)
+ [Importazione di utenti singolarmente ()AWS SDKs](#importing-users-sdk)
## Importazione di utenti singolarmente (console)
Puoi importare fino a 10 utenti alla volta. Questa procedura presuppone che tu abbia già creato un set di dati Users. Per informazioni sulla creazione di set di dati, vedere. [Creazione di uno schema e di un set di dati](data-prep-creating-datasets.md)
**Per importare utenti singolarmente (console)**
1. Apri la console Amazon Personalize a [https://console.aws.amazon.com/personalize/casa](https://console.aws.amazon.com/personalize/home) e accedi al tuo account.
1. Nella pagina **Gruppi di set** di dati, scegli il gruppo di set di dati con il set di dati Utenti in cui desideri importare l'utente.
1. **Nel riquadro di navigazione, scegli Datasets.**
1. Nella pagina Set di **dati, scegli il set** di dati Utenti.
1. **Nella pagina dei dettagli del set di dati, in alto a destra, scegli **Modifica set** di dati e scegli Crea record.**
1. Nella pagina **Crea record utente, per l'immissione dei** record, inserisci i dettagli dell'utente in formato JSON. I nomi e i valori dei campi dell'utente devono corrispondere allo schema utilizzato durante la creazione del set di dati Users. Amazon Personalize fornisce un modello JSON con nomi di campo e tipi di dati di questo schema.
1. Scegli **Crea record.** In **Response**, viene elencato il risultato dell'importazione e viene visualizzato un messaggio di successo o di fallimento.
## Importazione di utenti singolarmente ()AWS CLI
Aggiungi uno o più utenti al set di dati Users con l'[PutUsers](API_UBS_PutUsers.md)operazione. Puoi importare fino a 10 utenti con una singola `PutUsers` chiamata. Questa sezione presuppone che tu abbia già creato un set di dati Users. Per informazioni sulla creazione di set di dati, vedere. [Creazione di uno schema e di un set di dati](data-prep-creating-datasets.md)
Utilizzare il `put-users` comando seguente per aggiungere uno o più utenti con. AWS CLI Sostituisci `dataset arn` con l'Amazon Resource Name (ARN) del tuo set di dati e `user Id` con l'ID dell'utente. Se un utente con lo stesso nome `userId` è già presente nel set di dati Users, Amazon Personalize lo sostituisce con quello nuovo.
Infatti`properties`, per ogni campo del set di dati Users, sostituiscilo `propertyName` con il nome del campo del tuo schema, nel caso camel. Ad esempio, GENDER sarebbe `gender` e MEMBERSHIP\$1TYPE sarebbe. `membershipType` Sostituisci `user data` con i dati relativi all'utente. Per i dati di tipo stringa categorico, per includere più categorie per una singola proprietà, separate ogni categoria con una pipe (`|`). Ad esempio, `\"Premium Class|Legacy Member\"`.
```
aws personalize-events put-users \
--dataset-arn dataset arn \
--users '[{
"userId": "user Id",
"properties": "{\"propertyName\": "\user data\"}"
},
{
"userId": "user Id",
"properties": "{\"propertyName\": "\user data\"}"
}]'
```
## Importazione di utenti singolarmente ()AWS SDKs
Aggiungi uno o più utenti al set di dati Users con l'[PutUsers](API_UBS_PutUsers.md)operazione. Se un utente con lo stesso nome `userId` è già presente nel set di dati Users, Amazon Personalize lo sostituisce con quello nuovo. Puoi importare fino a 10 utenti con una singola chiamata. `PutUsers` Questa sezione presuppone che tu abbia già creato un set di dati Users. Per informazioni sulla creazione di set di dati, vedere. [Creazione di uno schema e di un set di dati](data-prep-creating-datasets.md)
Il codice seguente mostra come aggiungere uno o più utenti al set di dati Users. Per ogni parametro del nome della proprietà, passa il nome del campo dallo schema nel caso camel. Ad esempio, GENDER sarebbe `gender` e MEMBERSHIP\$1TYPE sarebbe. `membershipType` Per ogni parametro del valore della proprietà, trasmetti i dati per l'utente.
Per i dati di tipo stringa categorico, per includere più categorie per una singola proprietà, separate ogni categoria con una pipe (`|`). Ad esempio, `"Premium class|Legacy Member"`.
------
#### [ SDK for Python (Boto3) ]
```
import boto3
personalize_events = boto3.client(service_name='personalize-events')
personalize_events.put_users(
datasetArn = 'dataset arn',
users = [{
'userId': 'user ID',
'properties': "{\"propertyName\": \"user data\"}"
},
{
'userId': 'user ID',
'properties': "{\"propertyName\": \"user data\"}"
}]
)
```
------
#### [ SDK for Java 2.x ]
```
public static int putUsers(PersonalizeEventsClient personalizeEventsClient,
String datasetArn,
String user1Id,
String user1PropertyName,
String user1PropertyValue,
String user2Id,
String user2PropertyName,
String user2PropertyValue) {
int responseCode = 0;
ArrayList users = new ArrayList<>();
try {
User user1 = User.builder()
.userId(user1Id)
.properties(String.format("{\"%1$s\": \"%2$s\"}", user1PropertyName, user1PropertyValue))
.build();
users.add(user1);
User user2 = User.builder()
.userId(user2Id)
.properties(String.format("{\"%1$s\": \"%2$s\"}", user2PropertyName, user2PropertyValue))
.build();
users.add(user2);
PutUsersRequest putUsersRequest = PutUsersRequest.builder()
.datasetArn(datasetArn)
.build();
responseCode = personalizeEventsClient.putUsers(putUsersRequest).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 {
PutUsersCommand,
PersonalizeEventsClient,
} from "@aws-sdk/client-personalize-events";
const personalizeEventsClient = new PersonalizeEventsClient({
region: "REGION",
});
// set the put users parameters
var putUsersParam = {
datasetArn:
"DATASET ARN",
users: [
{
userId: "userId",
properties: '{"column1Name": "value", "column2Name": "value"}',
},
{
userId: "userId",
properties: '{"column1Name": "value", "column2Name": "value"}',
},
],
};
export const run = async () => {
try {
const response = await personalizeEventsClient.send(
new PutUsersCommand(putUsersParam)
);
console.log("Success!", response);
return response; // For unit tests.
} catch (err) {
console.log("Error", err);
}
};
run();
```
------
# Importazione di articoli singolarmente
Dopo aver completato la creazione [Creazione di uno schema e di un set di dati](data-prep-creating-datasets.md) di un set di dati Items, puoi importare singolarmente uno o più nuovi elementi nel set di dati. L'importazione individuale degli articoli consente di mantenere aggiornato il set di dati Items con importazioni in piccoli lotti man mano che il catalogo cresce. Puoi importare fino a 10 articoli alla volta. Se hai una grande quantità di nuovi articoli, ti consigliamo di importare prima i dati in blocco e poi di importare i dati degli articoli singolarmente, se necessario. Per informazioni, consulta [Importazione di dati di massa in Amazon Personalize con un processo di importazione di set di dati](bulk-data-import-step.md).
Puoi utilizzare la console Amazon Personalize, il AWS Command Line Interface (AWS CLI) o AWS SDKs per importare articoli. Se importi un articolo con lo `itemId` stesso articolo già presente nel set di dati Items, Amazon Personalize lo sostituisce con il nuovo articolo.
Per informazioni su come Amazon Personalize aggiorna i filtri per i nuovi record e su come i nuovi record influiscono sui consigli, consulta. [Importazione di singoli record in un set di dati Amazon Personalize](incremental-data-updates.md)
**Topics**
+ [Importazione di elementi singolarmente (console)](#importing-items-console)
+ [Importazione di elementi singolarmente ()AWS CLI](#importing-items-cli)
+ [Importazione di elementi singolarmente ()AWS SDKs](#importing-items-cli-sdk)
## Importazione di elementi singolarmente (console)
È possibile importare fino a 10 elementi alla volta in un set di dati Items. Questa procedura presuppone che tu abbia già creato un set di dati Items. Per informazioni sulla creazione di set di dati, vedere. [Creazione di uno schema e di un set di dati](data-prep-creating-datasets.md)
**Per importare gli elementi singolarmente (console)**
1. Apri la console Amazon Personalize a [https://console.aws.amazon.com/personalize/casa](https://console.aws.amazon.com/personalize/home) e accedi al tuo account.
1. Nella pagina **Gruppi di set** di dati, scegli il gruppo di set di dati con il set di dati Items in cui desideri importare gli articoli.
1. **Nel riquadro di navigazione, scegli Datasets.**
1. Nella pagina Set di dati, scegli il **set** di dati Items.
1. **Nella parte superiore destra della pagina dei dettagli del set di dati, scegli **Modifica set** di dati, quindi scegli Crea record.**
1. Nella pagina **Crea record di elementi**, per **Registra input**, inserisci i dettagli dell'elemento in formato JSON. I nomi e i valori dei campi dell'elemento devono corrispondere allo schema utilizzato durante la creazione del set di dati Items. Amazon Personalize fornisce un modello JSON con nomi di campo e tipi di dati di questo schema.
1. Scegli **Crea record.** In **Response**, viene elencato il risultato dell'importazione e viene visualizzato un messaggio di successo o di fallimento.
## Importazione di elementi singolarmente ()AWS CLI
Aggiungi uno o più elementi al set di dati Items utilizzando l'[PutItems](API_UBS_PutItems.md)operazione. È possibile importare fino a 10 elementi con una singola `PutItems` chiamata. Questa sezione presuppone che tu abbia già creato un set di dati Items. Per informazioni sulla creazione di set di dati, vedere. [Creazione di uno schema e di un set di dati](data-prep-creating-datasets.md)
Utilizzate il `put-items` comando seguente per aggiungere uno o più elementi con. AWS CLI Sostituiscilo `dataset arn` con l'Amazon Resource Name (ARN) del tuo set di dati e `item Id` con l'ID dell'articolo. Se un articolo con lo stesso valore `itemId` è già presente nel set di dati Items, Amazon Personalize lo sostituisce con uno nuovo.
Infatti`properties`, per ogni campo del set di dati Items, sostituiscilo `propertyName` con il nome del campo dello schema, nel caso camel. Ad esempio, GENRES sarebbe `genres` e CREATION\$1TIMESTAMP sarebbe CreationTimestamp. `item data`Sostituisci con i dati dell'elemento. `CREATION_TIMESTAMP`i dati devono essere in [formato Unix epoch Time](interactions-datasets.md#timestamp-data) ed espressi in secondi. Per i dati di tipo stringa categorico, per includere più categorie per una singola proprietà, separate ogni categoria con una pipe (). `|` Ad esempio, `\"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\"}"
}]'
```
## Importazione di elementi singolarmente ()AWS SDKs
Aggiungi uno o più elementi al set di dati Items utilizzando l'[PutItems](API_UBS_PutItems.md)operazione. È possibile importare fino a 10 elementi con una singola `PutItems` chiamata. Se un articolo con lo stesso valore `itemId` è già presente nel set di dati Items, Amazon Personalize lo sostituisce con uno nuovo. Questa sezione presuppone che tu abbia già creato un set di dati Items. Per informazioni sulla creazione di set di dati, vedere. [Creazione di uno schema e di un set di dati](data-prep-creating-datasets.md)
Il codice seguente mostra come aggiungere uno o più elementi al set di dati Items. Per ogni parametro del nome della proprietà, passa il nome del campo dallo schema nel caso camel. Ad esempio, GENRES sarebbe `genres` e CREATION\$1TIMESTAMP lo sarebbe. `creationTimestamp` Per ogni parametro del valore della proprietà, passa i dati per l'elemento. `CREATION_TIMESTAMP`i dati devono essere in [formato Unix epoch time](interactions-datasets.md#timestamp-data) ed espressi in secondi.
Per i dati di tipo stringa categorico, per includere più categorie per una singola proprietà, separate ogni categoria con una pipe (). `|` Ad esempio, `"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- 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();
```
------
# Importazione di azioni singolarmente
Dopo aver completato la creazione [Creazione di uno schema e di un set di dati](data-prep-creating-datasets.md) di un [set di dati Actions](actions-datasets.md), puoi importare singolarmente una o più nuove azioni nel set di dati. Quando importi azioni singolarmente, mantieni aggiornato il set di dati Actions con importazioni in piccoli batch man mano che il catalogo cresce. Puoi importare fino a 10 azioni alla volta. Se hai un gran numero di nuove azioni, ti consigliamo di importare prima i dati in blocco e poi di importare i dati delle azioni singolarmente, se necessario. Per informazioni, consulta [Importazione di dati di massa in Amazon Personalize con un processo di importazione di set di dati](bulk-data-import-step.md).
Puoi utilizzare la console Amazon Personalize, il AWS Command Line Interface (AWS CLI) o AWS SDKs importare azioni. Se importi un'azione `actionId` uguale a un'azione già presente nel tuo set di dati Actions, Amazon Personalize la sostituisce con la nuova azione.
Per informazioni su come i nuovi record influiscono sui consigli, consulta. [Aggiornamento dei dati nei set di dati dopo l'allenamento](updating-datasets.md)
**Topics**
+ [Importazione di azioni singolarmente (console)](#importing-actions-console)
+ [Importazione di azioni singolarmente ()AWS CLI](#importing-actions-cli)
+ [Importazione di azioni singolarmente ()AWS SDKs](#importing-actions-cli-sdk)
## Importazione di azioni singolarmente (console)
È possibile importare fino a 10 azioni alla volta in un set di dati Actions. Questa sezione presuppone che tu abbia già creato un set di dati Actions. Per informazioni sulla creazione di set di dati, vedere. [Creazione di uno schema e di un set di dati](data-prep-creating-datasets.md)
**Per importare le azioni singolarmente (console)**
1. Apri la console Amazon Personalize a [https://console.aws.amazon.com/personalize/casa](https://console.aws.amazon.com/personalize/home) e accedi al tuo account.
1. Nella pagina **Gruppi di set** di dati, scegli il gruppo di set di dati con il set di dati Actions a cui desideri aggiungere.
1. **Nel riquadro di navigazione, scegli Datasets.**
1. Nella pagina Set di dati, scegli il **set** di dati Azioni.
1. **Nella parte superiore destra della pagina dei dettagli del set di dati, scegli **Modifica set** di dati, quindi scegli Crea record.**
1. Nella pagina **Crea record di azioni**, per **Registra input**, inserisci i dettagli dell'azione in formato JSON. I nomi e i valori dei campi dell'azione devono corrispondere allo schema utilizzato durante la creazione del set di dati Actions. Amazon Personalize fornisce un modello JSON con nomi di campo e tipi di dati di questo schema.
1. Scegli **Crea record.** In **Response**, viene elencato il risultato dell'importazione e viene visualizzato un messaggio di successo o di fallimento.
## Importazione di azioni singolarmente ()AWS CLI
Aggiungi una o più azioni al tuo set di dati Actions utilizzando l'operazione `PutActions` API. Puoi importare fino a 10 azioni contemporaneamente. Questa sezione presuppone che tu abbia già creato un set di dati Actions. Per informazioni sulla creazione di set di dati, vedere. [Creazione di uno schema e di un set di dati](data-prep-creating-datasets.md)
Utilizzate il `put-actions` comando seguente per aggiungere una o più azioni con. AWS CLI Sostituisci `dataset arn` con l'Amazon Resource Name (ARN) del tuo set di dati e `actionId` con l'ID dell'azione. Se un'azione con lo stesso valore `actionId` è già presente nel tuo set di dati Actions, Amazon Personalize la sostituisce con una nuova.
Infatti`properties`, per ogni campo del set di dati Actions, sostituiscilo `propertyName` con il nome del campo dello schema, nel caso camel. Ad esempio, ACTION\$1EXPIRATION\$1TIMESTAMP sarebbe e CREATION\$1TIMESTAMP sarebbe CreationTimestamp. `actionExpirationTimestamp` `property data`Sostituisci con i dati della proprietà.
```
aws personalize-events put-actions \
--dataset-arn dataset arn \
--actions '[{
"actionId": "actionId",
"properties": "{\"propertyName\": "\property data\"}"
},
{
"actionId": "actionId",
"properties": "{\"propertyName\": "\property data\"}"
}]'
```
## Importazione di azioni singolarmente ()AWS SDKs
Aggiungi una o più azioni al tuo set di dati Actions utilizzando l' PutActions operazione. Puoi importare fino a 10 azioni con una singola `PutActions` chiamata. Se un'azione con lo stesso valore `actionId` è già presente nel tuo set di dati Actions, Amazon Personalize la sostituisce con una nuova. Questa sezione presuppone che tu abbia già creato un set di dati Actions. Per informazioni sulla creazione di set di dati, vedere. [Creazione di uno schema e di un set di dati](data-prep-creating-datasets.md)
Il codice seguente mostra come aggiungere una o più azioni al set di dati Actions. Per ogni azione, specifica il`actionId`. Se un'azione con lo stesso valore `actionId` è già presente nel tuo set di dati Actions, Amazon Personalize la sostituisce con una nuova. Infatti`properties`, per ogni campo aggiuntivo nel set di dati Actions, sostituiscilo `propertyName` con il nome del campo dello schema, nel caso camel. Ad esempio, ACTION\$1EXPIRATION\$1TIMESTAMP sarebbe e CREATION\$1TIMESTAMP sarebbe CreationTimestamp. `actionExpirationTimestamp` `property data`Sostituisci con i dati della proprietà.
```
import boto3
personalize_events = boto3.client(service_name='personalize-events')
personalize_events.put_actions(
datasetArn = 'dataset arn',
actions = [{
'actionId': 'actionId',
'properties': "{\"propertyName\": \"property value\"}"
},
{
'actionId': 'actionId',
'properties': "{\"propertyName\": \"property value\"}"
}]
)
```