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](https://docs.aws.amazon.com/personalize/latest/dg/granting-personalize-s3-access.html). 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](https://docs.aws.amazon.com/personalize/latest/dg/how-new-data-influences-recommendations.html) 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\$1PROGRESS > ACTIVE -oppure- CREATE FAILED Per conoscere lo stato del processo di importazione, chiama [DescribeDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetImportJob.html), 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. **Correlati APIs** + [ListDatasetImportJobs](https://docs.aws.amazon.com/personalize/latest/dg/API_ListDatasetImportJobs.html) + [DescribeDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetImportJob.html) ## 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](#API_CreateDatasetImportJob_RequestSyntax) ** L'ARN del set di dati che riceve i dati importati. Tipo: String Limitazioni di lunghezza: lunghezza massima di 256. Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` Obbligatorio: sì ** [dataSource](#API_CreateDatasetImportJob_RequestSyntax) ** Il bucket Amazon S3 che contiene i dati di addestramento da importare. Tipo: oggetto [DataSource](API_DataSource.md) Obbligatorio: sì ** [importMode](#API_CreateDatasetImportJob_RequestSyntax) ** 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 `FULL` di sovrascrivere tutti i dati in blocco esistenti nel set di dati. I dati importati singolarmente non vengono sostituiti. + `INCREMENTAL`Specificare 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: String Valori validi: `FULL | INCREMENTAL` Campo obbligatorio: no ** [jobName](#API_CreateDatasetImportJob_RequestSyntax) ** Il nome del processo di importazione del set di dati. Tipo: String 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](#API_CreateDatasetImportJob_RequestSyntax) ** Se hai creato un'attribuzione di metriche, specifica se pubblicare i parametri per questo processo di importazione su Amazon S3 Tipo: Booleano Obbligatorio: no ** [roleArn](#API_CreateDatasetImportJob_RequestSyntax) ** L'ARN del ruolo IAM che dispone delle autorizzazioni di lettura dall'origine dei dati Amazon S3. Tipo: String Limitazioni di lunghezza: lunghezza massima di 256. Modello: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` Obbligatorio: no ** [tags](#API_CreateDatasetImportJob_RequestSyntax) ** Un elenco di [tag da applicare al processo](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) di importazione del set di dati. Tipo: matrice di oggetti [Tag](API_Tag.md) 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](#API_CreateDatasetImportJob_ResponseSyntax) ** L'ARN del processo di importazione del set di dati. Tipo: String 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 una delle lingue specifiche AWS SDKs, consulta quanto segue: + [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateDatasetImportJob) + [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDatasetImportJob) + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDatasetImportJob) + [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDatasetImportJob) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDatasetImportJob) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDatasetImportJob) + [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDatasetImportJob) + [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDatasetImportJob) + [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDatasetImportJob) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDatasetImportJob)