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à.
CreateDatasetImportJob
Crea un job che importa i dati di training dalla tua fonte di dati (un bucket Amazon S3) in un set di dati Amazon Personalize. Per consentire ad Amazon Personalize di importare i dati di formazione, devi specificare un ruolo del servizio IAM che disponga dell'autorizzazione per la lettura dall'origine dati, poiché Amazon Personalize crea una copia dei tuoi dati e li elabora internamente. Per informazioni sulla concessione dell'accesso al tuo bucket Amazon S3, consulta Giving Amazon Personalize Access to Amazon S3 Resources.
Se hai già creato un suggerimento o implementato una versione personalizzata della soluzione con una campagna, il modo in cui i nuovi record in blocco influiscono sui consigli dipende dal caso d'uso o dalla ricetta del dominio che utilizzi. Per ulteriori informazioni, consulta Come i nuovi dati influiscono sui consigli in tempo reale.
Importante
Per impostazione predefinita, un processo di importazione di set di dati sostituisce tutti i dati esistenti nel set di dati importato in blocco. Per aggiungere nuovi record senza sostituire i dati esistenti, specifica INCREMENTAL per la modalità di importazione dell'operazione. CreateDatasetImportJob
Stato
Un processo di importazione del set di dati può trovarsi in uno dei seguenti stati:
-
CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -oppure- CREATE FAILED
Per conoscere lo stato del processo di importazione DescribeDatasetImportJob, chiama fornendo l'Amazon Resource Name (ARN) del processo di importazione del set di dati. L'importazione del set di dati è completata quando lo stato mostra il valore ACTIVE. Se lo stato indica CREATE FAILED, la risposta include una failureReason chiave che descrive il motivo per cui il processo non è riuscito.
Nota
L'attività di importazione richiede del tempo. È necessario attendere che lo stato venga visualizzato come ATTIVO prima di addestrare un modello utilizzando il set di dati.
API correlate
Sintassi della richiesta
{
"datasetArn": "string",
"dataSource": {
"dataLocation": "string"
},
"importMode": "string",
"jobName": "string",
"publishAttributionMetricsToS3": boolean,
"roleArn": "string",
"tags": [
{
"tagKey": "string",
"tagValue": "string"
}
]
}Parametri della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- datasetArn
-
L'ARN del set di dati che riceve i dati importati.
Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):personalize:.*:.*:.+Obbligatorio: sì
- dataSource
-
Il bucket Amazon S3 che contiene i dati di addestramento da importare.
Tipo: oggetto DataSource
Obbligatorio: sì
- importMode
-
Specifica come aggiungere i nuovi record a un set di dati esistente. La modalità di importazione predefinita è
FULL. Se in precedenza non hai importato record in blocco nel set di dati, puoi soloFULLspecificarli.-
Specifica
FULLdi sovrascrivere tutti i dati in blocco esistenti nel set di dati. I dati importati singolarmente non vengono sostituiti. -
Specifica
INCREMENTALdi aggiungere i nuovi record ai dati esistenti nel set di dati. Amazon Personalize sostituisce qualsiasi record con lo stesso ID con quello nuovo.
Tipo: stringa
Valori validi:
FULL | INCREMENTALCampo obbligatorio: no
-
- jobName
-
Il nome del processo di importazione del set di dati.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 63 caratteri.
Modello:
^[a-zA-Z0-9][a-zA-Z0-9\-_]*Obbligatorio: sì
- publishAttributionMetricsToS3
-
Se hai creato un'attribuzione delle metriche, specifica se pubblicare le metriche per questo processo di importazione su Amazon S3
Tipo: Booleano
Obbligatorio: no
- roleArn
-
L'ARN del ruolo IAM che dispone delle autorizzazioni di lettura dall'origine dei dati Amazon S3.
Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+Obbligatorio: no
-
Un elenco di tag da applicare al processo di importazione del set di dati.
Tipo: matrice di oggetti Tag
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.
Obbligatorio: no
Sintassi della risposta
{
"datasetImportJobArn": "string"
}Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- datasetImportJobArn
-
L'ARN del processo di importazione del set di dati.
Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):personalize:.*:.*:.+
Errori
- InvalidInputException
-
Fornisci un valore valido per il campo o il parametro.
Codice di stato HTTP: 400
- LimitExceededException
-
Il limite del numero di richieste al secondo è stato superato.
Codice di stato HTTP: 400
- ResourceAlreadyExistsException
-
La risorsa specificata esiste già.
Codice di stato HTTP: 400
- ResourceInUseException
-
La risorsa specificata è in uso.
Codice di stato HTTP: 400
- ResourceNotFoundException
-
Impossibile trovare la risorsa specificata.
Codice di stato HTTP: 400
- TooManyTagsException
-
È stato superato il numero massimo di tag che è possibile applicare a questa risorsa.
Codice di stato HTTP: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue:
