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 processo che importa i dati di formazione 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 addestramento, devi specificare un ruolo del servizio IAM che disponga dell'autorizzazione alla lettura dall'origine dati, poiché Amazon Personalize crea una copia dei tuoi dati e la elabora internamente. Per informazioni su come concedere l'accesso al tuo bucket Amazon S3, consulta Giving Amazon Personalize Access to Amazon S3 Resources.
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 collettivi influiscono sui consigli dipende dal caso d'uso del dominio o dalla ricetta che utilizzi. Per ulteriori informazioni, consulta In che modo i nuovi dati influiscono sui consigli in tempo reale.
Importante
Per impostazione predefinita, un processo di importazione del set di dati sostituisce tutti i dati esistenti nel set di dati importato in blocco. Per aggiungere nuovi record senza sostituire i dati esistenti, specificate 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, chiama DescribeDatasetImportJob, 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 è indicato come 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:.*:.*:.+Campo obbligatorio: sì
- dataSource
-
Il bucket Amazon S3 che contiene i dati di addestramento da importare.
Tipo: oggetto DataSource
Campo obbligatorio: sì
- importMode
-
Specificate 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 solo specificare.FULL-
Specificate
FULLdi sovrascrivere tutti i dati in blocco esistenti nel set di dati. I dati importati singolarmente non vengono sostituiti. -
INCREMENTALSpecificare di aggiungere i nuovi record ai dati esistenti nel set di dati. Amazon Personalize sostituisce qualsiasi record con lo stesso ID con uno 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\-_]*Campo obbligatorio: sì
- publishAttributionMetricsToS3
-
Se hai creato un'attribuzione di metriche, specifica se pubblicare i parametri per questo processo di importazione su Amazon S3
Tipo: Booleano
Campo 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+=,.@\-_/]+Campo obbligatorio: sì
-
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.
Campo 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
-
Hai superato il numero massimo di tag che puoi 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:
